Forms
Forms v3 endpoints
Forms are used to collect subscriber information and can be embedded on your website or used as hosted landing pages.
List forms
Returns a list of all the forms for your account.
Endpoint
GET /v3/forms
Parameters
Your account API key
Add subscriber to a form
Subscribe an email address to one of your forms.
Endpoint
POST /v3/forms/#{form_id}/subscribe
Parameters
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
Deprecated Parameters
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
List subscriptions to a form including subscriber data.
Endpoint
GET /v3/forms/#{form_id}/subscriptions
Parameters
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.