Create territory

POST

/resellers

Last modified:2026-09-27 17:25:39

OperationId:CreateReseller

Creates a territory, the configuration record that a Reseller's domains belong to. Send its name in reseller, and optionally a description and SMTP settings for the email its domains send.

Requires Super User. Every other scope, Reseller and Super User Read Only included, gets 403.

The name is 1 to 64 letters, digits, spaces, ., -, and _. It cannot start or end with a space or be only dots. Any other name returns 400, and a name that already exists returns 409.

A 202 means the territory was published over the service bus (SBUS), not yet created. Each core server writes it when the event arrives, so a read straight after the 202 can still return 404. Assign a domain to the territory with the domain's reseller field.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢202Accepted

text/html

The territory was published over the service bus and will be created on each core server.

🟠409Conflict

🟠401Authentication Required

🟠400Bad Request

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

cURL

Example 1Territory with SMTPName only

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/resellers' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "reseller": "rasel-reseller",
    "description": "Rasel Reseller",
    "smtp_host": "email-smtp.us-west-2.amazonaws.com",
    "smtp_port": 587,
    "smtp_pwd": "32432432423142clsdfkds23sdfassalfwlk23",
    "smtp_uid": "567yhyfghsdfvms-dsl4345tryerwe"
}'

Response Example

202 - Success

{
    "code": 409,
    "message": "Reseller with name already exits"
}

Modified at 2026-09-27 17:25:39

List territories

Count territories