curl -X POST 'https://api.resend.com/contacts' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0' \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "steve.wozniak@gmail.com",
  "first_name": "Steve",
  "last_name": "Wozniak",
  "unsubscribed": false,
  "properties": {},
  "segments": [
    {
      "id": "string"
    }
  ],
  "topics": [
    {
      "id": "string",
      "subscription": "opt_in"
    }
  ],
  "audience_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf"
}'

# POST /contacts (Resend API)
Base URL: https://api.resend.com
Auth: Authorization: Bearer <RESEND_API_KEY>
Last verified: 2026-09-03

> Create a new contact

## Critical Gotchas
* All requests must include a `User-Agent` header (e.g. `User-Agent: my-app/1.0`) or the API returns HTTP 403.
* The `to` field is an array of strings, even when sending to a single recipient.

## cURL
curl -X POST 'https://api.resend.com/contacts' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0' \
  -H 'Content-Type: application/json' \
  -d '{"email":"steve.wozniak@gmail.com","first_name":"Steve"}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| email | body | string | Yes | Email address of the contact. |
| first_name | body | string | No | First name of the contact. |
| last_name | body | string | No | Last name of the contact. |
| unsubscribed | body | boolean | No | The Contact's global subscription status. If set to true,... |

## Response (200 OK)
{"object":"contact","id":"479e3145-dd38-476b-932c-529ceb705947"}

---
Need an API key? Get one at https://resend.com/signup

POST

/contacts

Resend API

Create a new contact

Base URL: https://api.resend.com
Auth: Authorization: Bearer <RESEND_API_KEY>
Last verified: 2026-09-03 · upstream hash matched

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 234 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.

The to field is an array of strings, even when sending to a single recipient.

cURL

curl -X POST 'https://api.resend.com/contacts' \  -H "Authorization: Bearer $RESEND_API_KEY" \  -H 'User-Agent: my-app/1.0' \  -H 'Content-Type: application/json' \  -d '{  "email": "steve.wozniak@gmail.com",  "first_name": "Steve",  "last_name": "Wozniak",  "unsubscribed": false,  "properties": {},  "segments": [    {      "id": "string"    }  ],  "topics": [    {      "id": "string",      "subscription": "opt_in"    }  ],  "audience_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf"}'

Get a free Resend API key → sponsored

Parameters

Name	In	Type	Required	Description
email	body	string	Yes	Email address of the contact.
first_name	body	string	No	First name of the contact.
last_name	body	string	No	Last name of the contact.
unsubscribed	body	boolean	No	The Contact's global subscription status. If set to true, the contact will be unsubscribed from all Broadcasts.
properties	body	object	No	A map of custom property keys and values to create.
segments	body	object[]	No	Array of segment IDs to add the contact to.
topics	body	object[]	No	Array of topic subscriptions for the contact.
audience_id	body	string	No	Unique identifier of the audience to which the contact belongs.

Response 200 OK

{
  "object": "contact",
  "id": "479e3145-dd38-476b-932c-529ceb705947"
}