Forms v3 endpoints
Forms are used to collect subscriber information and can be embedded on your website or used as hosted landing pages.
Returns a list of all the forms for your account.
GET /v3/forms
Your account API key
Subscribe an email address to one of your forms.
POST /v3/forms/#{form_id}/subscribe
Your account API key
The ID for the form you want to add the subscriber to
Subscriber email address
Subscriber first name
Object of key/value pairs for custom field(s). The custom field(s) must exist before you can use it here.
Array of tag ids to subscribe to
Array of sequence ids to subscribe to. You should add the subscriber to the sequence directly.
Array of form ids to subscribe to. You should add the subscriber to each form individually.
Subscriber first name. You should prefer using first_name
listed above.
List subscriptions to a form including subscriber data.
GET /v3/forms/#{form_id}/subscriptions
Your API secret key
The ID for the form you want to list subscribers from
Sort order for results (asc
or desc
). asc
to list subscribers added oldest to newest, desc
to list subscribers added newest to oldest. Default is asc
.
Filter by subscriber state (active
or cancelled
). Receive only active subscribers or cancelled subscribers.
The page of results being requested. Default value is 1
. Each page of results will contain up to 50 subscriptions.
Forms v3 endpoints
Forms are used to collect subscriber information and can be embedded on your website or used as hosted landing pages.
Returns a list of all the forms for your account.
GET /v3/forms
Your account API key
Subscribe an email address to one of your forms.
POST /v3/forms/#{form_id}/subscribe
Your account API key
The ID for the form you want to add the subscriber to
Subscriber email address
Subscriber first name
Object of key/value pairs for custom field(s). The custom field(s) must exist before you can use it here.
Array of tag ids to subscribe to
Array of sequence ids to subscribe to. You should add the subscriber to the sequence directly.
Array of form ids to subscribe to. You should add the subscriber to each form individually.
Subscriber first name. You should prefer using first_name
listed above.
List subscriptions to a form including subscriber data.
GET /v3/forms/#{form_id}/subscriptions
Your API secret key
The ID for the form you want to list subscribers from
Sort order for results (asc
or desc
). asc
to list subscribers added oldest to newest, desc
to list subscribers added newest to oldest. Default is asc
.
Filter by subscriber state (active
or cancelled
). Receive only active subscribers or cancelled subscribers.
The page of results being requested. Default value is 1
. Each page of results will contain up to 50 subscriptions.