Documentation

Dependal Docs

Send transactional email using the Dependal API or SMTP, with verified domains, clear logs, and production guardrails.

Start here

Fastest path to first send

  1. Create your account
  2. Generate an API key
  3. Verify a sending domain
  4. Send your first email with API or SMTP

Quick Start

If you already have an API key and verified domain, this is enough to make your first request.

curl -X POST https://api.dependal.com/v1/send \
  -H "content-type: application/json" \
  -H "x-api-key: dp-xxxxxxxx" \
  -d '{
    "to": "user@example.com",
    "from": "Dependal <noreply@yourdomain.com>",
    "subject": "Hello",
    "html": "<p>Hello 👋</p>"
  }'
Tip: Use the API when you want programmatic control. Use SMTP when your framework or auth provider expects a standard mail server.

Authentication

Dependal uses a simple header-based authentication model.

x-api-key: dp-xxxxxxxxxxxxxx

Core API endpoints

Use the full API reference for schemas, request bodies, and response models.
Endpoint Description
POST /v1/send Send a transactional email
GET /v1/status Get status of a queued email
GET /v1/tenant/messages Get queued email history
Open Full API Reference

SMTP setup

Use SMTP for frameworks, auth providers, and apps that expect a standard mail transport.

Host: smtp.dependal.com
Port: 587
Username: apikey
Password: YOUR_DEPENDAL_API_KEY
TLS: enabled

Recommended: use port 587 with TLS enabled.

Official SDKs

Use an official SDK if you want faster integration with less boilerplate.
SDK

Node

Integrate Dependal from JavaScript or TypeScript projects.

View SDK docs
SDK

Python

Send transactional email from Python services and apps.

View SDK docs
SDK

PHP

Use Dependal in PHP apps and server-side workflows.

View SDK docs

Message-level visibility

Dependal stores message-level delivery logs so your team can inspect what happened to a send without guessing.

Send events

Track successful send attempts and provider handoff details.

Bounce events

Inspect bounce outcomes and understand delivery failures faster.

Complaint events

Track complaints and protect sender reputation with suppression hygiene.

Predictable limits

Dependal applies production-oriented limits to help protect deliverability and reduce abuse risk.
Limit type

Hourly

Limit type

Daily

Limit type

Monthly

Limit type

Burst

Popular integration guides

Use Dependal with auth providers and frameworks that need transactional email delivery.

Supabase

Auth and product email with clearer delivery visibility.

Open guide

Clerk

SMTP-based auth email integration for production apps.

Open guide

Firebase Auth

Route transactional auth email through Dependal.

Open guide

NextAuth

Magic links and auth email via SMTP or custom flows.

Open guide

OpenAPI and reference

Reference

Redoc API Reference

Browse endpoints, schemas, request bodies, and response models.

Open API Reference
Schema

OpenAPI spec

Useful for SDK generation, Postman, and tooling workflows.

Download OpenAPI