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.
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
Response
Success
Changes
No recorded changes to this operation across all 1 revision of this API.