API

Add Tracking Domain

post
https://api.aurorasendcloud.com/api/trackDomain/add

Add a new tracking domain. The tracking domain cannot be the same as any sending domain (41203). A user can add a maximum of 5 tracking domains by default (41201; configurable server-side, contact customer support for more); the name must be unique per account (41202). In automatic certificate mode (autoCertificate=true) a Cloudflare hostname is created synchronously; if that external call fails the domain is rolled back and 41217 is returned.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Form Data
string
required
length between 4 and 255
^([a-zA-Z0-9][a-zA-Z0-9\-]{0,46}[a-zA-Z0-9]{0,1}\.)+([a-zA-Z0-9]+)$

Track name. Must be 4-255 characters in total, and each dot-separated label must be no more than 48 characters (labels consist of letters, digits and inline hyphens, not starting or ending with a hyphen). Must contain at least one dot. Cannot be the same as any existing sending domain (41203); must be unique per account (41202).

boolean

Optional. If omitted: defaults to false (manual). true: enable automatic certificate mode. false: manual certificate mode. If true, certContent and certKey may be omitted or empty. Note: a non-boolean string (e.g. yes) fails binding to null and is treated as false (manual mode) rather than rejected — always send literal true/false.

string
length ≤ 65530

Certificate content (PEM format). Required in manual mode (autoCertificate=false): must start with -----BEGIN CERTIFICATE----- and end with -----END CERTIFICATE----- (41205 otherwise; 41204 if empty). Max 65530 characters (41206). The certificate CN/SAN domain must match the track name (41214/41215 otherwise).

string
length ≤ 8192

Certificate private key (PEM format). Required in manual mode: must start with -----BEGIN and end with KEY----- (41208 otherwise; 41207 if empty). Max 8192 characters (41209). Must pair with certContent (41212 otherwise).

Responses

Updated 4 months ago

Did this page help you?
Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 4 months ago

Did this page help you?