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": "example-id"
    }
  ],
  "topics": [
    {
      "id": "example-id",
      "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-10-20

> 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.

## 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,... |
Other params: properties, segments, topics, audience_id

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

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

POST

POST /contacts — Resend API

Resend API

Create a new contact

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
→ 221 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/contacts' \  -H "Authorization: Bearer $RESEND_API_KEY" \  -H 'User-Agent: my-app/1.0' \  -H 'Content-Type: application/json' \  -d '{  "email": "[email protected]",  "first_name": "Steve",  "last_name": "Wozniak",  "unsubscribed": false,  "properties": {},  "segments": [    {      "id": "example-id"    }  ],  "topics": [    {      "id": "example-id",      "subscription": "opt_in"    }  ],  "audience_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf"}'

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"
}

Get a free Resend API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.