Skip to main content

Create a new contact

POST/contacts/new

Creates a contact, or updates an existing one (upsert) instead of returning an error.

The payload is matched against existing contacts on the unique identifier fields it contains: email by default, plus any contact field flagged as a unique identifier on your instance. Depending on the instance setting Merge by unique fields with operator, a contact matches when all these fields match (AND) or when any of them matches (OR). If several contacts match, the most recently created one is updated.

  • 201 — no contact matched: the contact was created.
  • 200 — a contact matched: it was updated and is returned.

When a contact is updated, empty values in the payload are ignored unless you send "overwriteWithBlank": true.

Request​

Responses​

Existing contact matched by unique identifier and updated (upsert)