This endpoint will add a customer to a list, or if the customer already exists, will update the record of that customer with the supplied data.
POST /lists/LIST_ID/contacts/Payload Specification
Param Name | Required | Type | Description |
|---|---|---|---|
| Yes | String | The email address of the customer |
| No | String | The first name of the customer |
| No | String | The last name of the customer |
| No | String | A phone number for the customer. |
| No | String | Timezone of customer, should be in list of TZ database names |
| No | Number | Age of customer |
| No | "m" or "f" | Gender of customer. |
| No | String | Two letter code of customers language |
| No | String | First line of address for customer |
| No | String | Second line of address for customer |
| No | String | City where customer lives. |
| No | String | State where customer lives. |
| No | String | Postal code of customer's address |
| No | String | Country where customer lives |
| No | String | ISO formated date when the customer was born. |
Any additional params will be treated as strings and added to thecustom_fieldsof the list contact.
All specified parameters will update the customer's record for all applications within Rejoiner, not just for the given list.
{
"email": "[email protected]",
"first_name": "Test",
"age": "28",
"another_custom_field": "abc"
}On a successful request, the response will return a structured response representing the entire list contact.
{
"customer": {
"id": "CUSTOMER_ID",
"email": "[email protected]",
"first_name": "Test"
},
"custom_fields": {
"existing_custom_field": "xyz",
"another_custom_field": "abc"
}
}Newly added contacts will return a successful response with status code 201.
If the contact is already on the list a successful response with status code 200 will be returned.
