Getting startedAuthentication

Authentication

Authenticate every request to the Resent API

API keys authenticate every request to https://api.resent.com.

Bearer token

Add an Authorization header with your API key:

Authorization: Bearer re_xxxxxxxxx

User-Agent

All API requests must include a User-Agent header. Requests without it may be rejected with 403.

User-Agent: my-app/1.0

Create a key

1

Open API keys

Open API key settings in the dashboard.

2

Create a key

Choose a name and permission:

PermissionUse
full_accessAll API endpoints
sending_accessSend emails only (requires a verified domain)

Or create via API:

$curl -X POST 'https://api.resent.com/api-keys' \
>     -H 'Authorization: Bearer re_xxxxxxxxx' \
>     -H 'Content-Type: application/json' \
>     -d '{"name":"Production","permission":"full_access"}'
3

Store the token

The response includes token once. Save it in your secret manager — you’ll send it as Authorization: Bearer re_xxxxxxxxx.

Never commit API keys to source control. Rotate or delete keys you no longer need.

Next: Create an API key guide · Quickstart