POST
POST /api-keys — Resend API
Resend APICreate a new API key
- Base URL
- https://api.resend.com
- Auth
- Authorization: Bearer <RESEND_API_KEY>
- Last verified
- 2026-10-20 · upstream hash matched
Actions Try in browser→
Agents: curl -H "Accept: text/markdown" this URL
→ 208 tokens · Vary: Accept
→ 208 tokens · Vary: Accept
Critical gotchas
All requests must include a User-Agent header (e.g. User-Agent: my-app/1.0) or the API returns HTTP 403.
cURL
curl -X POST 'https://api.resend.com/api-keys' \ -H "Authorization: Bearer $RESEND_API_KEY" \ -H 'User-Agent: my-app/1.0' \ -H 'Content-Type: application/json' \ -d '{ "name": "example-name", "permission": "full_access", "domain_id": "domain-id"}'
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| name | body | string | Yes | The API key name. |
| permission | body | string | No | The API key can have full access to Resend’s API or be only restricted to send emails. * full_access - Can create, delete, get, and update any resource. * sending_access - Can only send emails. |
| domain_id | body | string | No | Restrict an API key to send emails only from a specific domain. Only used when the permission is sending_access. |
Response 200 OK
{
"id": "string",
"token": "string"
} Get a free Resend API key → sponsored Affiliate link - we may earn a commission, at no extra cost to you.