Contacts

Create or update a contact

Upsert keyed by (channel, platform_user_id). 201 when created, 200 when an existing contact was updated. Fields you omit on an existing contact are left untouched, tags included. Requires the write scope.

post/contacts

Request

  • Base URL: https://sumgenius.ai/api/v1
  • URL: https://sumgenius.ai/api/v1/contacts
  • Auth: one of:
    • API key in header X-SumGenius-Api-Key
    • HTTP bearer

Request body

channel'facebook' | 'instagram' | 'sms' | 'telegram' | 'whatsapp' required
platform_user_idstring required
namestring
emailstring email
phonestring
stage'new' | 'contacted' | 'qualified' | 'customer' | 'lost'
notesstring
tagsstring[]

Tag names, created if missing.

custom_fieldsobject

Response

200 updated, 201 created

Changes

No recorded changes to this operation across all 1 revision of this API.