Add a subscriber

Subscribes a new contact to the given list.

form_id (optional)

If form_id is provided, the subscription runs through that form's full pipeline:
double opt-in confirmation emails, Facebook pixel, form-level automations, etc.

If form_id is omitted (or 0), the contact is subscribed at list level without
form-specific behaviour.

Multipart / file upload

The endpoint also accepts Content-Type: multipart/form-data for lists that have
file-upload fields. File fields receive the uploaded filename as their value.

Error codes

CodeMeaning
10100email field is missing from the request body
18001Email address format is invalid
18000Email address already exists on this list
18003Trial account subscriber limit reached
18004Account is disabled
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

Subscriber list (newsletter) ID

Body Params
string
required

Email address of the subscriber

integer

Subscribe form ID. If provided, form-level behaviour (double opt-in, FB pixel,
automations) is activated. Omit or set to 0 for list-level subscription.

Headers
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses

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