Resolve or create a contact
POST/contacts
Resolves a contact by exact external ID or creates one when absent. Existing contact profile fields are returned unchanged. This operation creates no conversation and sends no message.
Request
Responses
- 200
- 201
- 400
- 401
- 403
- 409
- 429
- 500
Existing contact resolved without changing its profile
Response Headers
RFC 3339 time until which the same idempotency key reproduces this result; at least 24 hours after the first request
Contact created
Response Headers
RFC 3339 time until which the same idempotency key reproduces this result; at least 24 hours after the first request
contact.external_id_required, contact.invalid_email, contact.invalid_external_id, contact.invalid_locale, contact.invalid_name, public.idempotency_key_required, public.idempotency_key_invalid, public.invalid_request
unauthorized
forbidden
public.idempotency_key_reused, public.request_in_progress
Response Headers
Seconds to wait before retrying when the original request is still in progress
rate_limited
internal_error