Show Developer Menu

POST /contacts/{email}/identities

Issuing a POST call to identities will allow you to attach an email address to a contact.

Alternative: POST /contacts/{identifier}/identities?identifier_type={identifier_type}

Alternatively, you can issue a POST to a specific contact by an alternative identifier type, like mobile, facebook, twitter, or instagram. This allows you to, for example, add a Mobile identity to a Facebook Contact.

Example Request
curl 'https://{brand}{email}/identities' \
  -u {login-email}:{api-token} \
  -H 'Accept: application/json' \
  -H 'Content-type: application/json' \
  -X POST -d '{"identity": {"type": "email", "identifier": ""}}'

A successful request will return the JSON containing the identities for this contact.

A failed request will return an HTTP 422 Unprocessable Entity with the JSON body explaining the error.

Warning: Identities (email addresses) already associated with another contact will be re-associated with this contact. All messages and data that belong to the identity will also be re-associated with this contact.
  • The type value can be the following: 'email', 'mobile'. Currently, adding social network identities (like Facebook, Twitter, and Instagram) to a contact is not supported.