QUICKSTART

Send your first email

Create an agent, generate an API key, and send a real message in a few minutes.

1

Create an agent

Open Agents in the dashboard, choose Add agent, and configure its name, dedicated address, send/receive permissions, approvals, and policies.

2

Generate that agent’s key

Open the configured agent, create an API key, and copy it once. The key cannot act as another agent or choose a different From address.

3

Send a message

Call POST /api/v1/send with the key in the Authorization header and a unique Idempotency-Key for the logical send.

curl -X POST https://api.tekmail.app/api/v1/send \
  -H "Authorization: Bearer tk_your_api_key" \
  -H "Idempotency-Key: task_01K_QUICKSTART" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "you@example.com",
    "subject": "Hello from my agent",
    "text": "The integration is working."
  }'