OmnioDocsAPI referenceOpen the app

Merge contact

POST/v1/contacts/{customer_id}/merge

Merge source_customer_id into this contact, which keeps its Customer ID. Takes an optional Idempotency-Key.

Scope contacts:writeIdempotency-Key optional

Path parameters

customer_idstringRequired

Request body

source_customer_idstringRequired
Up to 40 characters. 9 digits or more

Response

  • 200Success
Response fields
merge_idstringRequired
merged_customer_idstringRequired
contactobjectRequired
contact.customer_idstringRequired
contact.first_namestringRequired
May be null
contact.last_namestringRequired
May be null
contact.usernamestringRequired
May be null
contact.phone_e164stringRequired
May be null
contact.emailstringRequired
May be null
contact.languagestringRequired
May be null
contact.lifecycleobjectRequired
May be null
contact.tagsarray of objectRequired
contact.collaboratorsarray of stringRequired
contact.attributesobjectRequired
contact.statusstringRequired
contact.channel_idstringRequired
May be null
contact.last_message_atstringRequired
May be null
contact.last_message_previewstringRequired
May be null
contact.created_atstringRequired
contact.updated_atstringRequired
contact.deleted_atstringRequired
May be null

Errors

  • 401unauthorized. The key is missing, unknown or revoked
  • 403insufficient_scope. The key lacks the scope above
  • 403forbidden
  • 404not_found. either contact
  • 409contact_deleted, or idempotency_conflict
  • 422validation_error. same_contact, target_merged or source_merged

Every error has the same shape. See Errors.