API Reference

The Dugble API lets you send, schedule, inspect, update, and cancel email and SMS messages from your applications.

Base URL

https://api.dugble.com

Authenticate API requests with a Dugble team token using Bearer authentication.

Authorization: Bearer dgb_team_...

See Authentication for token behavior and permissions.

Send JSON payloads with:

Content-Type: application/json
Accept: application/json

Mutation requests can include an Idempotency-Key header so retries do not create duplicate operations.

Idempotency-Key: welcome-user-42

See Idempotency for details.

Successful JSON responses use the standard Dugble envelope:

{
  "success": true,
  "data": {}
}

Errors use:

{
  "success": false,
  "error": {
    "code": "BAD_REQUEST",
    "message": "Public error message"
  }
}

See Errors for the public error codes returned by the API.

The current public reference covers:

Email — send, batch send, list, retrieve, reschedule, and cancel messages.
SMS — send, batch send, list, retrieve, reschedule, cancel, and synchronize message status.

The endpoint pages in this section are generated from Dugble’s OpenAPI specification.