SautiDesk
SautiDesk API
Channels and templates

Add an email domain

POST
/v1/desk/mail/domains

Adds a domain to send and receive support email on. After adding it, create the DNS records it asks for and verify it.

Requires: desk.admin scope, workspace owner or admin.

Authorization

bearerAuth
AuthorizationBearer <token>

A SautiDesk API key. An owner or admin makes it under Settings in SautiDesk for a named person and picks the scopes. The key is shown once. Send it as Authorization: Bearer <key>. It acts as that person and as nobody else.

In: header

Request Body

application/json

Response

Created

Example

{  "id": "3f2b8c1e-5a4d-4e7b-9c10-2d6a8e4f1b37",  "domain": "support.example.com",  "status": "open",  "status_note": "Everything is working",  "provider_id": "cc0f979a-6957-429d-9976-306cd2f2304c",  "inbound_status": "example",  "records": [    {      "record": "example",      "type": "billing",      "name": "Amina Wanjiru",      "value": "example",      "priority": "normal",      "ttl": "example",      "status": "open"    }  ]}
FieldTypeDescription
idrequiredstring (uuid)
domainrequiredstringThe domain you send and receive email on, for example support.example.co.ke.
statusrequiredstringThe status to set.
status_notestring
provider_idstring
inbound_statusrequiredstring
recordsrequiredobject[]
recordrequiredstring
typerequiredstring
namerequiredstringA name for it.
valuerequiredstring
priorityrequiredstring
ttlrequiredstring
statusrequiredstringThe status to set.
curl -X POST "https://api.sautidesk.com/v1/desk/mail/domains" \  -H "Content-Type: application/json" \  -d '{    "domain": "support.example.com"  }'