The Secret Endpoint

curl -X POST 'https://api.resend.com/secret' \ -H 'Authorization: Bearer re_xxxxxxxxx' \ -H 'Content-Type: application/json' \ -d $'{ "first_name": "Steve", "last_name": "Wozniak", "address1": "4300 El Camino Real", "address2": "Suite 100", "city": "Los Altos", "state": "CA", "country": "US", "zip": "94022" }'

You’ll need an API key to run this - get one here.

Body Parameters

string

required

First name

string

required

Last name

string

required

Address line

string

Additional address info (e.g., apartment number, suite, floor)

string

required

City name

string

required

State codes are based on the ISO 3166-2 standard and are two letters long

string

required

Country codes are based on the ISO 3166-1 alpha-2 standard and are two letters long

string

required

ZIP code

string

In case of Brazil country this field becomes required. The CPF format is 000.000.000-00 (14 characters).

curl -X POST 'https://api.resend.com/secret' \
     -H 'Authorization: Bearer re_xxxxxxxxx' \
     -H 'Content-Type: application/json' \
     -d $'{
  "first_name": "Steve",
  "last_name": "Wozniak",
  "address1": "4300 El Camino Real",
  "address2": "Suite 100",
  "city": "Los Altos",
  "state": "CA",
  "country": "US",
  "zip": "94022"
}'

{
  "message": "Check your mailbox in a few days :)"
}

Knowledge Base

API Keys

Domains

Sending

Deliverability

Testing

Tutorials

Build with AI

Account Management

The Secret Endpoint

Body Parameters

​Body Parameters

Body Parameters