Skip to content
docs
Browse the docsAliases

API reference

Aliases API

More addresses that deliver into one inbox. Every aliases endpoint with its scope, parameters, body and an example answer.

Base URL https://api.dissolve.email. Send an API key or OAuth access token as Authorization: Bearer <token> (Authentication); an OAuth token needs the scope on each endpoint. Errors follow one shape.

EndpointSummary
GET /v1/inboxes/{id}/aliasesList an inbox's aliases
POST /v1/inboxes/{id}/aliasesCreate an alias
DELETE /v1/inboxes/{id}/aliases/{aliasId}Delete an alias

List an inbox's aliases

GET/v1/inboxes/{id}/aliasesinboxes:read

Other addresses that deliver into this inbox, newest first.

Path parameters

NameDescription
idThe aliase id.
curl "https://api.dissolve.email/v1/inboxes/$INBOX_ID/aliases" \
  -H "Authorization: Bearer $DISSOLVE_API_KEY"

Response 200

JSON
[
  {
    "id": "als6Rb1TnW8qXk3Zm5PcV",
    "aliasAddress": "billing@dissolve.email",
    "createdAt": "2026-11-19T10:01:00.000Z"
  }
]

Create an alias

POST/v1/inboxes/{id}/aliasesinboxes:writePro and up

Adds another address on the inbox's domain (Pro 5 per inbox, Business 25; owner only).

Path parameters

NameDescription
idThe aliase id.

Body (application/json)

NameTypeRequiredDescription
aliasstringyesThe local part: lower case letters, digits and inner hyphens. At most 50 characters.
curl -X POST "https://api.dissolve.email/v1/inboxes/$INBOX_ID/aliases" \
  -H "Authorization: Bearer $DISSOLVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"alias":"billing"}'

Response 201

JSON
{
  "id": "als6Rb1TnW8qXk3Zm5PcV",
  "aliasAddress": "billing@dissolve.email",
  "inboxId": "V1StGXR8Z5jdHi6BmyT2k",
  "createdAt": "2026-11-19T10:01:00.000Z",
  "message": "Alias billing@dissolve.email created. Mail to it lands in this inbox."
}

Delete an alias

DELETE/v1/inboxes/{id}/aliases/{aliasId}inboxes:write

Removes the alias. Its address is held back for a while before anyone else can take it.

Path parameters

NameDescription
idThe aliase id.
aliasIdThe alias id.
curl -X DELETE "https://api.dissolve.email/v1/inboxes/$INBOX_ID/aliases/$ALIAS_ID" \
  -H "Authorization: Bearer $DISSOLVE_API_KEY"

Response 200

JSON
{
  "success": true,
  "message": "Alias billing@dissolve.email deleted."
}

Something wrong or missing on this page? Tell us at support@dissolve.email.View as Markdown