Client API · Contacts

Create a contact

POST/public/api/v1/inboxes/{inbox_identifier}/contacts

Path parameters

inbox_identifierstringrequired

The identifier obtained from API inbox channel

Body application/json

identifierstring

External identifier of the contact

identifier_hashstring

Identifier hash prepared for HMAC authentication

emailstring

Email of the contact

namestring

Name of the contact

phone_numberstring

Phone number of the contact

avatarstring (binary)

Send the form data with the avatar image binary or use the avatar_url

custom_attributesobject

Custom attributes of the customer

Responses

200

Success

idinteger

Id of the contact

source_idstring

The session identifier of the contact

namestring

Name of the contact when available

emailstring

Email of the contact

phone_numberstring

Phone number of the contact

pubsub_tokenstring

The token to be used to connect to texa-desk websocket

401

Unauthorized

descriptionstring

errorsarray of object

errors[].fieldstring

errors[].messagestring

errors[].codestring

curl -X POST 'https://desk.texadesk.com/public/api/v1/inboxes/aBcD3fGh1jKlMn0p/contacts' \ -H "Content-Type: application/json" \ -d '{ "identifier": "1234567890", "identifier_hash": "e93275d4eba0e5679ad55f5360af00444e2a888df9b0afa3e8b691c3173725f9", "email": "[email protected]" }'

import os, requests headers = {} body = { "identifier": "1234567890", "identifier_hash": "e93275d4eba0e5679ad55f5360af00444e2a888df9b0afa3e8b691c3173725f9", "email": "[email protected]" } r = requests.post("https://desk.texadesk.com/public/api/v1/inboxes/aBcD3fGh1jKlMn0p/contacts", headers=headers, json=body) r.raise_for_status() print(r.json())