Create a subscriber
POST/subscriber
Create a new subscriber
Request
Header Parameters
Enable developer mode. Learn more here.
Your API key
- application/json
Body
required
Subscriber object
- Array [
- ]
Subscriber email address
Subscriber phone number. It follows the E.164 format.
Subscriber name
Possible values: [free_subscriber
, paid_subscriber
, unsubscribed_subscriber
]
Subscriber status
customFields object[]
List of custom fields. Each custom field has a label, and value.
Custom field label
Custom field value
List of segmentation lists IDs. You can get the ID by calling our support team.
Responses
- 201
- 400
- 404
- 409
- 422
- 500
Subscriber created.
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
data object
Subscriber email address
Subscriber phone number. It follows the E.164 format.
Subscriber name
Possible values: [free_subscriber
, paid_subscriber
, unsubscribed_subscriber
]
Subscriber status
customFields object[]
List of custom fields. Each custom field has a label, and value.
Custom field ID
Custom field label
Custom field value
List of segmentation lists IDs. You can get the ID by calling our support team.
Subscriber blacklisted date
Subscriber unsubscribed date
Subscriber creation date
Subscriber update date
{
"data": {
"id": "string",
"email": "example@email.com",
"phone": "+5511999999999",
"name": "John Doe",
"status": "free_subscriber",
"customFields": [
{
"id": "string",
"label": "age",
"value": 25
}
],
"segmentationLists": [
"ff37b0a8-de19-4f72-a7ed-0bd1cb73f29f",
"ff37b0a8-de19-4f72-a7ed-0bd1cb73f29f"
],
"blacklistedAt": "2024-04-09T19:18:29.653Z",
"unsubscribedAt": "2024-04-09T19:18:29.653Z",
"createdAt": "2024-04-09T19:18:29.653Z",
"updatedAt": "2024-04-09T19:18:29.653Z"
},
"requestId": "string"
}
Body is necessary.
- application/json
- Schema
- Example (from schema)
Schema
{
"error": "Body is necessary.",
"errorCode": "MISSING_BODY",
"requestId": "ff37b0a8-de19-4f72-a7ed-0bd1cb73f29f"
}
Segmentation list not found. Only when passing a segmentation list that does not exist.
- application/json
- Schema
- Example (from schema)
Schema
{
"error": "Segmentation list not found.",
"errorCode": "SEGMENTATION_LIST_NOT_FOUND",
"requestId": "ff37b0a8-de19-4f72-a7ed-0bd1cb73f29f"
}
Subscriber already exists.
- application/json
- Schema
- Example (from schema)
Schema
{
"error": "Subscriber already exists.",
"errorCode": "SUBSCRIBER_ALREADY_EXISTS",
"requestId": "ff37b0a8-de19-4f72-a7ed-0bd1cb73f29f"
}
Unprocessable Entity.
- application/json
- Schema
- Example (from schema)
Schema
{
"error": "Invalid email address.",
"errorCode": "INVALID_INPUT",
"requestId": "ff37b0a8-de19-4f72-a7ed-0bd1cb73f29f"
}
Internal server error.
- application/json
- Schema
- Example (from schema)
Schema
{
"error": "Internal server error.",
"errorCode": "INTERNAL_SERVER_ERROR",
"requestId": "ff37b0a8-de19-4f72-a7ed-0bd1cb73f29f"
}