[metadata]
apple-mobile-web-app-title: Resend
application-name: Resend
description: Troubleshoot problems with this comprehensive breakdown of all error codes.
generator: Mintlify
msapplication-TileColor: #000000
msapplication-config: /docs/_mintlify/favicons/resend/nAzNk0iRWkZBBJ91/_generated/favicon/browserconfig.xml
og:description: Troubleshoot problems with this comprehensive breakdown of all error codes.
og:image: https://resend.mintlify.app/_next/image?url=%2F_mintlify%2Fapi%2Fog%3Fdivision%3DAPI%2BReference%26title%3DErrors%26description%3DTroubleshoot%2Bproblems%2Bwith%2Bthis%2Bcomprehensive%2Bbreakdown%2Bof%2Ball%2Berror%2Bcodes.%26theme%3D89aa4c7cfca5bc46b8b29fdd&w=1200&q=100
og:image:height: 630
og:image:width: 1200
og:site_name: Resend
og:title: Errors - Resend
og:type: website
og:url: https://resend.com/docs/api-reference/errors
twitter:card: summary_large_image
twitter:description: Troubleshoot problems with this comprehensive breakdown of all error codes.
twitter:image: https://resend.mintlify.app/_next/image?url=%2F_mintlify%2Fapi%2Fog%3Fdivision%3DAPI%2BReference%26title%3DErrors%26description%3DTroubleshoot%2Bproblems%2Bwith%2Bthis%2Bcomprehensive%2Bbreakdown%2Bof%2Ball%2Berror%2Bcodes.%26theme%3D89aa4c7cfca5bc46b8b29fdd&w=1200&q=100
twitter:image:height: 630
twitter:image:width: 1200
twitter:title: Errors - Resend
viewport: width=device-width, initial-scale=1, viewport-fit=cover

[canonical-links]
https://resend.com/docs/api-reference/errors

[document-links]
/docs/llms.txt: /docs/llms.txt
API Keys page: https://resend.com/api-keys
API Reference: /docs/api-reference/introduction
Contact support: https://resend.com/contact
DEL Delete API key: /docs/api-reference/api-keys/delete-api-key
DEL Delete Audience: /docs/api-reference/audiences/delete-audience
DEL Delete Automation: /docs/api-reference/automations/delete-automation
DEL Delete Broadcast: /docs/api-reference/broadcasts/delete-broadcast
DEL Delete Contact Property: /docs/api-reference/contact-properties/delete-contact-property
DEL Delete Contact Segment: /docs/api-reference/contacts/delete-contact-segment
DEL Delete Contact: /docs/api-reference/contacts/delete-contact
DEL Delete Domain: /docs/api-reference/domains/delete-domain
DEL Delete Event: /docs/api-reference/events/delete-event
DEL Delete Segment: /docs/api-reference/segments/delete-segment
DEL Delete Template: /docs/api-reference/templates/delete-template
DEL Delete Topic: /docs/api-reference/topics/delete-topic
DEL Delete Webhook: /docs/api-reference/webhooks/delete-webhook
DEL Remove Suppression: /docs/api-reference/suppressions/remove-suppression
DEL Revoke Grant: /docs/api-reference/oauth/revoke-grant
Documentation: /docs/introduction
Errors: /docs/api-reference/errors
GET Authorize: /docs/api-reference/oauth/authorize
GET List API keys: /docs/api-reference/api-keys/list-api-keys
GET List Attachments: /docs/api-reference/emails/list-email-attachments
GET List Attachments: /docs/api-reference/emails/list-received-email-attachments
GET List Attempts: /docs/api-reference/webhooks/list-event-attempts
GET List Audiences: /docs/api-reference/audiences/list-audiences
GET List Automation Runs: /docs/api-reference/automations/list-automation-runs
GET List Automations: /docs/api-reference/automations/list-automations
GET List Broadcasts: /docs/api-reference/broadcasts/list-broadcasts
GET List Clicked Links: /docs/api-reference/broadcasts/list-broadcast-clicked-links
GET List Contact Imports: /docs/api-reference/contacts/list-contact-imports
GET List Contact Properties: /docs/api-reference/contact-properties/list-contact-properties
GET List Contact Segments: /docs/api-reference/contacts/list-contact-segments
GET List Contacts: /docs/api-reference/contacts/list-contacts
GET List Domains: /docs/api-reference/domains/list-domains
GET List Events: /docs/api-reference/events/list-events
GET List Events: /docs/api-reference/webhooks/list-events
GET List Grants: /docs/api-reference/oauth/list-grants
GET List Logs: /docs/api-reference/logs/list-logs
GET List Received Emails: /docs/api-reference/emails/list-received-emails
GET List Recipients: /docs/api-reference/broadcasts/list-broadcast-recipients
GET List Segment Contacts: /docs/api-reference/segments/list-segment-contacts
GET List Segments: /docs/api-reference/segments/list-segments
GET List Sent Emails: /docs/api-reference/emails/list-emails
GET List Suppressions: /docs/api-reference/suppressions/list-suppressions
GET List Templates: /docs/api-reference/templates/list-templates
GET List Topics: /docs/api-reference/topics/list-topics
GET List Webhooks: /docs/api-reference/webhooks/list-webhooks
GET Retrieve Attachment: /docs/api-reference/emails/retrieve-email-attachment
GET Retrieve Attachment: /docs/api-reference/emails/retrieve-received-email-attachment
GET Retrieve Audience: /docs/api-reference/audiences/get-audience
GET Retrieve Automation Run: /docs/api-reference/automations/get-automation-run
GET Retrieve Automation: /docs/api-reference/automations/get-automation
GET Retrieve Broadcast: /docs/api-reference/broadcasts/get-broadcast
GET Retrieve Contact Import: /docs/api-reference/contacts/get-contact-import
GET Retrieve Contact Property: /docs/api-reference/contact-properties/get-contact-property
GET Retrieve Contact Topics: /docs/api-reference/contacts/get-contact-topics
GET Retrieve Contact: /docs/api-reference/contacts/get-contact
GET Retrieve Domain Claim: /docs/api-reference/domains/get-domain-claim
GET Retrieve Domain: /docs/api-reference/domains/get-domain
GET Retrieve Event: /docs/api-reference/events/get-event
GET Retrieve Event: /docs/api-reference/webhooks/get-event
GET Retrieve Log: /docs/api-reference/logs/retrieve-log
GET Retrieve Metrics BETA: /docs/api-reference/segments/get-segment-metrics
GET Retrieve Metrics: /docs/api-reference/emails/get-metrics
GET Retrieve Received Email: /docs/api-reference/emails/retrieve-received-email
GET Retrieve Segment: /docs/api-reference/segments/get-segment
GET Retrieve Sent Email: /docs/api-reference/emails/retrieve-email
GET Retrieve Suppression: /docs/api-reference/suppressions/get-suppression
GET Retrieve Template: /docs/api-reference/templates/get-template
GET Retrieve Topic: /docs/api-reference/topics/get-topic
GET Retrieve Usage: /docs/api-reference/usage/retrieve-usage
GET Retrieve Webhook: /docs/api-reference/webhooks/get-webhook
Get Started: https://resend.com/signup
Guides: /docs/knowledge-base/introduction
Introduction: /docs/api-reference/introduction
Learn more about resolving this error: /docs/knowledge-base/403-error-domain-mismatch
Learn more about resolving this error: /docs/knowledge-base/403-error-resend-dev-domain
Learn more about resolving this error: /docs/knowledge-base/domain-already-registered
PATCH Update API key: /docs/api-reference/api-keys/update-api-key
PATCH Update Automation: /docs/api-reference/automations/update-automation
PATCH Update Broadcast: /docs/api-reference/broadcasts/update-broadcast
PATCH Update Contact Property: /docs/api-reference/contact-properties/update-contact-property
PATCH Update Contact Topics: /docs/api-reference/contacts/update-contact-topics
PATCH Update Contact: /docs/api-reference/contacts/update-contact
PATCH Update Domain: /docs/api-reference/domains/update-domain
PATCH Update Email: /docs/api-reference/emails/update-email
PATCH Update Event: /docs/api-reference/events/update-event
PATCH Update Segment: /docs/api-reference/segments/update-segment
PATCH Update Template: /docs/api-reference/templates/update-template
PATCH Update Topic: /docs/api-reference/topics/update-topic
PATCH Update Webhook: /docs/api-reference/webhooks/update-webhook
POST Add Batch Suppressions: /docs/api-reference/suppressions/add-batch-suppressions
POST Add Contact to Segment: /docs/api-reference/contacts/add-contact-to-segment
POST Add Suppression: /docs/api-reference/suppressions/add-suppression
POST Cancel Broadcast: /docs/api-reference/broadcasts/cancel-broadcast
POST Cancel Email: /docs/api-reference/emails/cancel-email
POST Claim Domain: /docs/api-reference/domains/claim-domain
POST Create API key: /docs/api-reference/api-keys/create-api-key
POST Create Audience: /docs/api-reference/audiences/create-audience
POST Create Automation: /docs/api-reference/automations/create-automation
POST Create Broadcast: /docs/api-reference/broadcasts/create-broadcast
POST Create Contact Import: /docs/api-reference/contacts/create-contact-import
POST Create Contact Property: /docs/api-reference/contact-properties/create-contact-property
POST Create Contact: /docs/api-reference/contacts/create-contact
POST Create Domain: /docs/api-reference/domains/create-domain
POST Create Event: /docs/api-reference/events/create-event
POST Create Segment: /docs/api-reference/segments/create-segment
POST Create Template: /docs/api-reference/templates/create-template
POST Create Topic: /docs/api-reference/topics/create-topic
POST Create Webhook: /docs/api-reference/webhooks/create-webhook
POST Duplicate Automation: /docs/api-reference/automations/duplicate-automation
POST Duplicate Template: /docs/api-reference/templates/duplicate-template
POST Publish Template: /docs/api-reference/templates/publish-template
POST Register Client: /docs/api-reference/oauth/register
POST Remove Batch Suppressions: /docs/api-reference/suppressions/remove-batch-suppressions
POST Revoke Token: /docs/api-reference/oauth/revoke
POST Send Batch Emails: /docs/api-reference/emails/send-batch-emails
POST Send Broadcast: /docs/api-reference/broadcasts/send-broadcast
POST Send Email: /docs/api-reference/emails/send-email
POST Send Event: /docs/api-reference/events/send-event
POST Share Email: /docs/api-reference/emails/share-email
POST Stop Automation: /docs/api-reference/automations/stop-automation
POST Token: /docs/api-reference/oauth/token
POST Verify Domain Claim: /docs/api-reference/domains/verify-domain-claim
POST Verify Domain: /docs/api-reference/domains/verify-domain
Pagination: /docs/api-reference/pagination
Resend home page: https://resend.com
Resend’s Domain page: https://resend.com/domains
Send Email Next: /docs/api-reference/emails/send-email
Sign In: https://resend.com/login
Upgrade your plan: https://resend.com/settings/billing
Usage Limits Previous: /docs/api-reference/rate-limit
Usage Limits: /docs/api-reference/rate-limit
contact support: https://resend.com/contact
contact support: https://resend.com/help
github: https://github.com/resend
response headers: /docs/api-reference/introduction#rate-limit
status page: https://resend-status.com
website: https://resend.com/
x: https://x.com/resend
youtube: https://www.youtube.com/@resendlabs

[structured-data]
{"@context":"https://schema.org","@graph":[{"@id":"https://resend.com/#organization","@type":"Organization","logo":{"@type":"ImageObject","url":"https://mintcdn.com/resend/w4S5Jr48MiquhhSH/logo-black.svg?fit=max&auto=format&n=w4S5Jr48MiquhhSH&q=85&s=630be7deea6ea94cc7fc4560ea60a5ac"},"name":"Resend","url":"https://resend.com"},{"@id":"https://resend.com/docs#website","@type":"WebSite","name":"Resend","publisher":{"@id":"https://resend.com/#organization"},"url":"https://resend.com/docs"},{"@id":"https://resend.com/docs/api-reference/errors#webpage","@type":"WebPage","breadcrumb":{"@id":"https://resend.com/docs/api-reference/errors#breadcrumb"},"dateModified":"2026-08-27T00:47:47.816Z","description":"Troubleshoot problems with this comprehensive breakdown of all error codes.","isPartOf":{"@id":"https://resend.com/docs#website"},"name":"Errors","url":"https://resend.com/docs/api-reference/errors"},{"@id":"https://resend.com/docs/api-reference/errors#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://resend.com/docs/api-reference/introduction","name":"API Reference","position":1},{"@type":"ListItem","item":"https://resend.com/docs/api-reference/errors","name":"Errors","position":2}]},{"@id":"https://resend.com/docs/api-reference/errors#article","@type":["Article","TechArticle"],"dateModified":"2026-08-27T00:47:47.816Z","description":"Troubleshoot problems with this comprehensive breakdown of all error codes.","headline":"Errors","isPartOf":{"@id":"https://resend.com/docs#website"},"mainEntityOfPage":{"@id":"https://resend.com/docs/api-reference/errors#webpage"},"name":"Errors","publisher":{"@id":"https://resend.com/#organization"},"url":"https://resend.com/docs/api-reference/errors"}]}

[content]
Errors - Resend
Documentation Index
Fetch the complete documentation index at:
/docs/llms.txt
Use this file to discover all available pages before exploring further.
Skip to main content
Resend
home page
Documentation
Guides
API Reference
Sign In
Get Started
Get Started
Search...
Navigation
API Reference
Errors
Search...
⌘
K
API Reference
Introduction
Pagination
Usage Limits
Errors
Sending
POST
Send Email
POST
Send Batch Emails
GET
Retrieve Sent Email
GET
List Sent Emails
PATCH
Update Email
POST
Cancel Email
POST
Share Email
GET
Retrieve Attachment
GET
List Attachments
GET
Retrieve Metrics
Receiving
GET
Retrieve Received Email
GET
List Received Emails
GET
Retrieve Attachment
GET
List Attachments
Broadcasts
POST
Create Broadcast
POST
Send Broadcast
POST
Cancel Broadcast
GET
Retrieve Broadcast
GET
List Broadcasts
PATCH
Update Broadcast
DEL
Delete Broadcast
GET
List Recipients
GET
List Clicked Links
Automations
POST
Create Automation
PATCH
Update Automation
GET
Retrieve Automation
GET
List Automations
POST
Duplicate Automation
POST
Stop Automation
DEL
Delete Automation
GET
List Automation Runs
GET
Retrieve Automation Run
Events
POST
Create Event
POST
Send Event
GET
Retrieve Event
GET
List Events
PATCH
Update Event
DEL
Delete Event
Templates
POST
Create Template
GET
Retrieve Template
GET
List Templates
PATCH
Update Template
DEL
Delete Template
POST
Publish Template
POST
Duplicate Template
Contacts
POST
Create Contact
GET
Retrieve Contact
GET
List Contacts
PATCH
Update Contact
DEL
Delete Contact
POST
Add Contact to Segment
GET
List Contact Segments
DEL
Delete Contact Segment
GET
Retrieve Contact Topics
PATCH
Update Contact Topics
Contact Properties
POST
Create Contact Property
GET
Retrieve Contact Property
GET
List Contact Properties
PATCH
Update Contact Property
DEL
Delete Contact Property
Contact Imports
POST
Create Contact Import
GET
Retrieve Contact Import
GET
List Contact Imports
Segments
POST
Create Segment
GET
Retrieve Segment
GET
List Segments
PATCH
Update Segment
DEL
Delete Segment
GET
List Segment Contacts
GET
Retrieve Metrics
BETA
Topics
POST
Create Topic
GET
Retrieve Topic
GET
List Topics
PATCH
Update Topic
DEL
Delete Topic
Audiences
DEPRECATED
POST
Create Audience
GET
Retrieve Audience
GET
List Audiences
DEL
Delete Audience
Domains
POST
Create Domain
POST
Claim Domain
GET
Retrieve Domain Claim
POST
Verify Domain Claim
POST
Verify Domain
GET
Retrieve Domain
GET
List Domains
PATCH
Update Domain
DEL
Delete Domain
Logs
GET
Retrieve Log
GET
List Logs
Usage
BETA
GET
Retrieve Usage
API Keys
POST
Create API key
GET
List API keys
PATCH
Update API key
DEL
Delete API key
Suppressions
POST
Add Suppression
GET
Retrieve Suppression
GET
List Suppressions
DEL
Remove Suppression
POST
Add Batch Suppressions
POST
Remove Batch Suppressions
Authorized Apps
GET
List Grants
DEL
Revoke Grant
Webhooks
POST
Create Webhook
GET
Retrieve Webhook
GET
List Webhooks
PATCH
Update Webhook
DEL
Delete Webhook
GET
List Events
GET
Retrieve Event
GET
List Attempts
OAuth
POST
Register Client
GET
Authorize
POST
Token
POST
Revoke Token
On this page
Error schema
invalid_idempotency_key
validation_error
missing_api_key
restricted_api_key
email_above_quota
invalid_permission
restricted_api_key
suspended_api_key
validation_error
validation_error
validation_error
not_found
method_not_allowed
concurrent_idempotent_requests
invalid_idempotent_request
resource_locked
invalid_attachment
invalid_parameter
missing_required_field
missing_required_parameter
daily_quota_exceeded
monthly_quota_exceeded
rate_limit_exceeded
application_error
service_unavailable
API Reference
Errors
Copy page
Copy page
Troubleshoot problems with this comprehensive breakdown of all error codes.
Copy page
Copy page
​
Error schema
Resend uses standard HTTP response codes for success and failure notifications, and errors are further classified by type.
​
invalid_idempotency_key
Status:
400
Message:
Idempotency keys, if present, must have between 1 and 256 characters.
Suggested action:
Retry with a valid idempotency key.
​
validation_error
Status:
400
Message:
An error was found with one or more fields in the request.
Suggested action:
The message will contain more details about what field and error were found.
​
missing_api_key
Status:
401
Message:
Missing API key in the authorization header.
Suggested action:
Include the following header in the request:
Authorization: Bearer YOUR_API_KEY
.
​
restricted_api_key
Status:
401
Message:
This API key is restricted to only send emails.
Suggested action:
Make sure the API key has
Full access
to perform actions other than sending emails.
​
email_above_quota
Status:
403
Message:
You can’t retrieve this email’s content because it was above quota when received.
Suggested action:
Upgrade your plan
to increase your quota.
​
invalid_permission
Status:
403
Message:
Access token is missing required scopes.
Suggested action:
Request an access token that includes the scopes required by this endpoint.
​
restricted_api_key
Status:
403
Message:
API key is not active
Suggested action:
Check the API key on the
API Keys page
and create a new one if needed.
​
suspended_api_key
Status:
403
Message:
This API key is suspended
Suggested action:
Contact support
if you believe this is a mistake.
​
validation_error
Status:
403
Message:
You can only send testing emails to your own email address (
youremail@domain.com
). To send emails to other recipients, please verify a domain at resend.com/domains, and change the
from
address to an email using this domain.
Suggested action:
In
Resend’s Domain page
, add and verify a domain for which you have DNS access. This allows you to send emails to addresses beyond your own.
Learn more about resolving this error
.
​
validation_error
Status:
403
Message:
The
domain.com
domain is not verified. Please, add and verify your domain.
Suggested action:
Make sure the domain in your API request’s
from
field matches a domain you’ve verified in Resend. Update your API request to use your verified domain, or add and verify the domain you’re trying to use.
Learn more about resolving this error
.
​
validation_error
Status:
403
Message:
The
example.com
domain has been registered already.
Suggested action:
Verify you are signed in to the correct Resend account and check whether a teammate already added the domain. If you still cannot access it,
contact support
.
Learn more about resolving this error
.
​
not_found
Status:
404
Message:
The requested endpoint does not exist.
Suggested action:
Change your request URL to match a valid API endpoint.
​
method_not_allowed
Status:
405
Message:
Method is not allowed for the requested path.
Suggested action:
Change your API endpoint to use a valid method.
​
concurrent_idempotent_requests
Status:
409
Message:
There is another request in progress with the same idempotency key.
Suggested action:
Try the request again later.
​
invalid_idempotent_request
Status:
409
Message:
This idempotency key has been used with this HTTP method and endpoint within the last 24 hours, but the request body was modified and doesn’t match the original request.
Suggested action:
Change your idempotency key or payload.
​
resource_locked
Status:
409
Message:
Another request is already updating this resource.
Suggested action:
Retry the request after a short delay.
​
invalid_attachment
Status:
422
Message:
Attachment must have either a
content
or
path
.
Suggested action:
Attachments must either have a
content
(strings, Buffer, or Stream contents) or
path
to a remote resource (better for larger attachments).
​
invalid_parameter
Status:
422
Message:
The
parameter
must be a valid UUID.
Suggested action:
Check the value and make sure it’s valid.
​
missing_required_field
Status:
422
Message:
The request body is missing one or more required fields.
Suggested action:
Check the error message to see the list of missing fields.
​
missing_required_parameter
Status:
422
Message:
The request is missing one or more required parameters.
Suggested action:
Check the error message to see the list of missing parameters.
​
daily_quota_exceeded
Status:
429
Message:
You have exceeded your daily email sending quota.
Suggested action:
Upgrade your plan
to remove the daily quota limit or wait until 24 hours have passed. Both sent and received emails count towards this quota.
​
monthly_quota_exceeded
Status:
429
Message:
You have exceeded your monthly email sending quota.
Suggested action:
Upgrade your plan
to increase the monthly email quota. Both sent and received emails count towards this quota.
​
rate_limit_exceeded
Status:
429
Message:
Too many requests. Please limit the number of requests per second. Or
contact support
to increase rate limit.
Suggested action:
Read the
response headers
and reduce the rate at which you request the API. This can be done by introducing a queue mechanism or reducing the number of concurrent requests per second. If you have specific requirements,
contact support
to request a rate increase.
​
application_error
Status:
500
Message:
An unexpected error occurred.
Suggested action:
Try the request again later. If the error does not resolve, check our
status page
for service updates.
​
service_unavailable
Status:
503
Message:
API is temporarily unavailable
Suggested action:
Try the request again later. Check our
status page
for service updates.
Was this page helpful?
Yes
No
Usage Limits
Previous
Send Email
Next
⌘
I
x
github
youtube
website
Assistant
Responses are generated using AI and may contain mistakes.
