API Reference

/forms/{formId}/notifications

post
https://www.formstack.com/api/v2025/forms//notifications

Create a form notification email

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

The ID of the form

Body Params

Create notification email request data

Create notification email request

string | null

Name of the notification email

string
enum

The type of from address (noreply, custom, field)

Allowed:
string

Custom email address or field ID

string

Email addresses to send notification to (split with return character \n)

string

The subject of the email

string
enum

What is included in the message (data, link, or fields)

Allowed:
boolean | null
Defaults to false

Flag to not include empty fields in the email

boolean | null
Defaults to false

Flag to not include hidden fields in the email

boolean | null
Defaults to false

Flag to show section headings in email

string | null

The email message (if type = fields)

int32 | null

Only attach files if under this limit (in KBytes)

string | null
enum
Defaults to html

Whether the notification email should be Rich HTML or Plain Text

Allowed:
logic

Logic conditions for when to send the notification email

Responses

400

Invalid request parameters

403

Forbidden by form permissions

404

Form not found

500

Could not create the notification email

Updated about 2 months ago

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago