Subscribers

Fetch subscribers

Return json data about subscribers

URL

/subscribers

Method

GET

URL parameters

Optional:

items=[number] Number of records to return

page=[number] For pagination of results

search=[alphanumeric]

order_by=[first_name | last_name | email | created_at | updated_at]

order=[asc | desc]

subscription_list_id=[alphanumeric] Defaults to all subscribers/default subscription list

Success response

Code:200
Content:

{
"data": [
{
"id": "string",
"type": "subscriber",
"attributes": {
"email": "string",
"first_name": "string",
"last_name": "string",
"unsubscribed": "bool"
}
}
]
}

Create subscriber

Creates a subscriber record

Adds record to subscription list if specified otherwise adds to all contacts.

URL

/subscribers

Method

POST

Data parameters

{
"subscriber": {
"email": "string", // required
"first_name": "string", // optional
"last_name": "string", // optional
"custom_fields": [ {"your_custom_field_name_1":"your_custom_field_value_1"}, {"your_custom_field_name_2":"your_custom_field_value_3"} ] // optional and unlimited
},
"subscription_list_id": "string" // optional
}

Success response

Code: 200
Content:

{
"data": {
"id": "string",
"type": "subscriber",
"attributes": {
"email": "string",
"first_name": "string",
"last_name": "string"
}
}
}

Update subscriber

Updates a subscriber record

URL

/subscribers/:subscriber_id

Method

PATCH | PUT

Data parameters

{
"subscriber": {
"email": "string", // optional
"first_name": "string", // optional
"last_name": "string" // optional
}
}

Success response

Code: 200
Content:

{
"data": {
"id": "string",
"type": "subscriber",
"attributes": {
"email": "string",
"first_name": "string",
"last_name": "string"
}
}
}

Bulk create subscribers

Creates one or more subscriber records

Adds to subscription list if specified, otherwise adds to all contacts

URL

/subscribers_bulk_create

Method

POST

Data parameters

{
"subscribers": [
// required
{
"email": "string", // required
"first_name": "string", // optional
"last_name": "string", // optional
"custom_fields": [ {"your_custom_field_name_1":"your_custom_field_value_1"}, {"your_custom_field_name_2":"your_custom_field_value_3"} ] // optional and unlimited
}
],
"subscription_list_id": "string" // optional
}

Success response

Code: 200
Content:

{
"data": {
"num_subscribers_added": "number"
}
}

Bulk delete subscribers

Deletes one or more subscriber records

Removes from subscription list if specified, otherwise removed from all contacts

URL

/subscribers_bulk_delete

Method

DELETE

Data parameters

{
"subscriber_ids": ["string"], // required
"subscription_list_id": "string" // optional
}

Success response

Code: 200
Content:

{}