Sign in
contacts

Create or update a contact

Gateway-native contact upsert (dual-writes the gateway ACL store and the assistant info mirror). Matches by id, then by any provided (type, address) channel, else creates.

post/v1/contacts

Request body

idstring

Existing contact id to update; omit to create or match by channel

displayNamestring required

Required on every upsert, including updates by id

notesstring nullable
autoApproveThreshold'none' | 'low' | 'medium' | 'high' nullable

Per-contact auto-approve ceiling. Omit to preserve; null clears.

contactTypestring

Response

Successful response

okboolean required

Changes

Changed in 4 of the 17 revisions of this API.23

  • 31bccc7f554f1See the full diff
    • ▲

      request property // list-of-types was narrowed by removing types null from media type application/json

      request-property-list-of-types-narrowed

  • 5ab41fe432c62See the full diff
    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the required property / to the response with the status

      response-required-property-added

  • bf6a3a734a631See the full diff
    • ○

      endpoint added

      endpoint-added

  • 8aa43f77a6041See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation