Skip to main content
Resend Docs

Search documentation

Type to search this documentation.

On this pageOverview

The Secret Endpoint

Get a special gift from Resend.

POST /secret

cURL
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"
}'
Response
{
  "message": "Check your mailbox in a few days :)"
}

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

  • first_name (string, required) — First name

  • last_name (string, required) — Last name

  • address1 (string, required) — Address line

  • address2 (string) — Additional address info (e.g., apartment number, suite, floor)

  • city (string, required) — City name

  • state (string, required) — State codes are based on the ISO 3166-2 standard and are two letters long

  • country (string, required) — Country codes are based on the ISO 3166-1 alpha-2 standard and are two letters long

  • zip (string, required) — ZIP code

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

shellscript
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"
}'
JSON
{
  "message": "Check your mailbox in a few days :)"
}

Was this page helpful?

⌘I

Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu