Quickstart

Send your first transactional email.

Accounts use controlled onboarding. Once access is active, configuration follows one explicit resource chain.

1. Add and verify a domain

In the Dashboard, choose Add domain. Publish the exact ownership, DKIM, and DMARC TXT records, then run Check DNS until the domain is ready. Each domain has independent DNS state.

2. Add a sender

Create the exact sender address beneath the domain. Free accounts support 2 domains and 3 senders total, with up to 3 senders per domain. A sender can exist before DNS is ready, but sending remains blocked until its domain is ready.

3. Create the right credential

Create a tv_live_… sending key in Dashboard → API Keys and copy it when shown. It cannot be recovered. Use a separate scoped management key only when automating domains or senders.

4. Submit idempotently

Shell

curl -X POST https://api.tenvio.email/v1/emails \
  -H "Authorization: Bearer $TENVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7f4d9b98-63a8-4c43-a958-41d641fe2fd2" \
  -d '{"from":"security@yourdomain.com","to":["customer@example.net"],"cc":[],"bcc":[],"type":"critical","subject":"Sign-in alert","content":{"plain":"Review this activity."},"attachments":[]}'

HTTP 202 Accepted means the request was durably enqueued, not that it reached an inbox. Continue with the Email API guide.