Email API

Send from SEED domains (seedmail.tg, sdm.tg, notify.tg) or your own domain via SES DNS. SMTP + portal.

POST/v1/emails

Send a transactional email.

AuthX-API-Key

Parameters

Name	Type	Description	Required
`to`	string\|string[]	Recipients.	Yes
`from_email`	string	Verified sender email.	Yes
`subject`	string	Email subject.	Yes
`text`	string	Plain text body.	Yes
`html`	string	Optional HTML body.	No

Request samplePOST /v1/emails

{
  "to": "[email protected]",
  "from_email": "[email protected]",
  "subject": "Receipt",
  "text": "Thanks for your order."
}

Response sample200 OK

{
  "id": "email_123",
  "status": "queued"
}

POST/v1/emails/bulk

Send multiple emails.

AuthX-API-Key

Parameters

Name	Type	Description	Required
`messages`	array	List of email payloads.	Yes

Request samplePOST /v1/emails/bulk

{
  "messages": [
    {
      "to": "[email protected]",
      "from_email": "[email protected]",
      "subject": "Receipt",
      "text": "Thanks"
    }
  ]
}

Response sample200 OK

{
  "accepted": 1,
  "failed": 0
}

GET/v1/email-domains

List email domain onboarding records and DNS verification status.

AuthPortal token

Request sampleGET /v1/email-domains

No request body.

Response sample200 OK

[
  {
    "id": "dom_123",
    "domain": "example.com",
    "status": "verified"
  }
]

POST/v1/email-domains

Create an email domain onboarding request.

AuthPortal token

Parameters

Name	Type	Description	Required
`domain`	string	Domain to verify.	Yes

Request samplePOST /v1/email-domains

{
  "domain": "example.com"
}

Response sample200 OK

{
  "id": "dom_123",
  "domain": "example.com",
  "status": "pending_ownership"
}

GET/v1/email/smtp-credentials

List SMTP credentials.

AuthPortal token

Request sampleGET /v1/email/smtp-credentials

No request body.

Response sample200 OK

[
  {
    "id": "smtp_123",
    "username": "smtp_user",
    "active": true
  }
]

POST/v1/email/smtp-credentials

Create SMTP credentials. The password is returned once.

AuthPortal token

Parameters

Name	Type	Description	Required
`name`	string	Credential label.	Yes

Request samplePOST /v1/email/smtp-credentials

{
  "name": "Production SMTP"
}

Response sample200 OK

{
  "credential": {
    "id": "smtp_123",
    "username": "smtp_user"
  },
  "password": "smtp_password"
}