---
title: "Create or Update a Contact User"
method: POST
path: "/zephr/createContact"
tags: ["User"]
---

# Create or Update a Contact User

`POST /zephr/createContact`

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.

## Request body

- ContactCreateRequest
  - `identifiers` Identifiers, required
    - `email_address` string
  - `attributes` Attributes

## Response `200`

Created or updated a contact user

- object
  - `tracking_id` string — A unique ID assigned to the created contact for tracking purposes.
  - `message` string — A human-readable message describing the result of the operation.

## Other responses

- `400` — Bad Request Returned if a request is missing an email identifier, or if some user attributes are invalid.
- `403` — Contact creation not enabled
- `409` — User {email} already exists Returned when attempting to update the attributes of an already registered user.

---

[API](https://skmtc.net/zuora/apis/public-api-reference.md) · [All operations](https://skmtc.net/zuora/apis/public-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zuora/public-api-reference/versions/0400dd83950b/schema)