Contacts

Find or create a contact

Looks up exactly one identifier through lookup: { type, value }. Returns { contact, created: false } unchanged when it exists. Otherwise creates the lookup identity (or external ID), applies create attributes, and returns { contact, created: true }. Additional addresses belong in create.identities, custom fields in create.profile.customFields; custom field keys must be defined and values must match their types. An external ID lookup cannot be contradicted by create.externalId. Creation returns HTTP 409 ConflictError if an externalId or address belongs to another contact; the conflicting field is named and no contact is created. Use the update endpoint to change an existing contact.

post/v1/contacts/find-or-create

Request

  • Base URL: https://api.samva.dev
  • URL: https://api.samva.dev/v1/contacts/find-or-create
  • Auth: API key in header x-api-key

Request body

namespaceIdstring

Response

Success

createdboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.