curl -X PATCH 'https://api.resend.com/contacts/id' \
  -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": {}
}'

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

> Update a single contact by ID or email

## 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 PATCH 'https://api.resend.com/contacts/id' \
  -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 |
| :--- | :--- | :--- | :--- | :--- |
| id | path | string | Yes | The Contact ID or email address. |
| email | body | string | No | Email address of the contact. |
| first_name | body | string | No | First name of the contact. |

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

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

PATCH

/contacts/{id}

Resend API

Update a single contact by ID or email

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
→ 216 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 PATCH 'https://api.resend.com/contacts/id' \  -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": {}}'

Get a free Resend API key → sponsored

Parameters

Name	In	Type	Required	Description
id	path	string	Yes	The Contact ID or email address.
email	body	string	No	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 update.

Response 200 OK

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