# Envello API

Plain-text summary of the Envello REST API. Base URL: `https://api.envello.dev`.

## Authentication

Send an API key as a bearer token. Live keys start with `env_live_`. Create keys in the dashboard.

```
Authorization: Bearer env_live_...
```

## Send an email

```bash
curl -X POST https://api.envello.dev/emails \
  -H "Authorization: Bearer env_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.eu>",
    "to": "user@example.com",
    "subject": "Welcome!",
    "html": "<p>Hello</p>"
  }'
```

The `from` domain must be a verified sending domain on your account.

## Endpoints

- `POST /emails`: send one email.
- `POST /emails/batch`: send up to 100 emails in one request. Failures are reported per item.
- `GET /domains`, `POST /domains`, `DELETE /domains/:id`: manage sending domains.
- `POST /domains/:id/verify`: re-check a domain's DNS records.

## Idempotency

Send an `Idempotency-Key` header to make retries safe. Letters, digits and `.` `_` `:` `-` only, with a length cap enforced by the API.

## Other interfaces

- SMTP relay: `smtp.envello.dev`.
- SDKs: Node (`envello` on npm), Python (`envello` on PyPI). See https://envello.dev/docs/sdks.

## Where to read more

- Docs: https://envello.dev/docs.md
- Pricing: https://envello.dev/pricing.md
- Index for agents: https://envello.dev/llms.txt