API reference

Manage domains, addresses and SMTP passwords for Sendas. Create an API key in the dashboard and send it as `Authorization: Bearer sk_...`.

Authentication

Create a key under API keys and send it with every request. Keys can do everything the dashboard can, except manage other keys.

curl https://sendas.pluton.id/api/v1/me \
  -H "Authorization: Bearer sk_..."

Responses are JSON: { "data": … } on success and { "error": { "code", "message" } } on failure.

Endpoints

• get/api/v1/me

  Current account and plan limits

• get/api/v1/domains

  List domains

• post/api/v1/domains

  Add a domain

  {"name":"yourcompany.com"}

• get/api/v1/domains/{id}

  Get a domain with the DNS records to publish

• delete/api/v1/domains/{id}

  Remove a domain and all its addresses

• post/api/v1/domains/{id}/verify

  Check DNS records; the domain goes live once all required records are found

• get/api/v1/domains/{id}/aliases

  List addresses

• post/api/v1/domains/{id}/aliases

  Create an address; mail is forwarded to your Gmail

  {"localPart":"hr"}

• get/api/v1/domains/{id}/logs

  Message log for the last 7 days (metadata only, never message bodies)

• patch/api/v1/aliases/{id}

  Pause or resume an address

  {"active":false}

• delete/api/v1/aliases/{id}

  Delete an address

• get/api/v1/aliases/{id}/smtp-credentials

  List live SMTP passwords (the passwords themselves are never shown again)

• post/api/v1/aliases/{id}/smtp-credentials

  Create an SMTP password for Gmail "Send mail as". Returned once.

  {"label":"Gmail"}

• delete/api/v1/smtp-credentials/{id}

  Revoke an SMTP password