v1

latestOpenAPI 3.0.02026-08-0610682246.0 KB
User

Create or Update a Contact User

This endpoint creates a new contact user or updates the attributes of an existing contact user if one exists with the supplied email address. To use this endpoint, 'contact users' must be enabled in the identity settings page in the console. A contact user is a type of user that has no validators and so no ability to create authenticated sessions. Contact users can be created to capture user information, such as email addresses, without fully registering users. This endpoint cannot be used to update the attributes of a registered user. Attempting to do so will return a 409 response. After creating a contact with an anonomyous session, the session is updated to include a flag to identify that this has happened. In the rules builder, the 'Contact Capture' decision node can be used to test this flag value and so determine if the current anonymous session was used to create a contact. This can be used, for example, to prevent showing a contact form to anonymous users that have already filled in such a form.

post/zephr/createContact

Request body

attributesAttributes

Example request

{
  "identifiers": {
    "email_address": "joe.blow@company.com"
  }
}

Response

Created or updated a contact user

tracking_idstring

A unique ID assigned to the created contact for tracking purposes.

messagestring

A human-readable message describing the result of the operation.