VEvellum-ai
contacts

Create or update a contact

Changed on

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

  • Base URL
    (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /v1/contacts
  • Auth
    none declared

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

  • 31bccc7f554fRevision changes
    • breaking

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

  • 5ab41fe432c6Revision changes
    • info

      added the new optional request property

    • info

      added the required property / to the response with the status