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

email

Yes

String

The email address of the customer

first_name

No

String

The first name of the customer

📘

Any additional params will be treated as strings and added to the custom_fields of the list contact.

🚧

The first_name param will update the customer's first name across 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",
    "age": "28",
    "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.