Add/Update a Contact Request Example

We recommend regularly updating contacts by Backend API (server-to-server). Request example:

Explanation of Fields:

1. firstName:

   • Value: "John"
   • The contact's first name.

2. lastName:

   • Value: "Smith"
   • The contact's last name.

3. channels:

   • An array specifying the contact's communication channels. Each channel includes:
     • type: The channel type (e.g., "email", "sms", "webPush").
     • value: The identifier for the channel (e.g., email address, phone number).

4. address:

   • Contains the contact's full address details:
     • city, region, country, postalCode, and addressLine.

5. fields:

   • An array of custom fields containing additional information about the contact:
     • Example: "birthDate" and "loyaltyLevel".

6. externalCustomerId:

   • Value: "EM12790"
   • Your system's unique identifier for the contact.

7. groups:

   • An array of static segments (groups) the contact belongs to.
   • Example: "Newsletter Subscribers".

8. languageCode:

   • Value: "en"
   • The contact's preferred language.

9. timeZone:

   • Value: "America/New_York"
   • The contact's time zone.

📘

Note

We strongly recommend using your External ID as the main identifier to match the contact data in our system.