Show Developer Menu

POST /contacts/{email}/identities

Issuing a POST call to identities will allow you to attach an email, mobile number, twitter handle or instagram user 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}.reamaze.io/api/v1/contacts/{email}/identities' \
  -u {login-email}:{api-token} \
  -H 'Accept: application/json' \
  -H 'Content-type: application/json' \
  -X POST -d '{"identity": {"type": "email", "identifier": "helloworld@example.com"}}'
Response

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 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.
Notes
  • The type value can be one of the following: 'email', 'mobile', 'instagram', 'igsid' (Instagram-scoped ID), or 'twitter'. Currently, adding Facebook identities to a contact is not supported.