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-10-20

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

## 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. |
| last_name | body | string | No | Last name of the contact. |
Other params: unsubscribed, properties

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

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

PATCH

PATCH /contacts/{id} — Resend API

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-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 220 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 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": "[email protected]",  "first_name": "Steve",  "last_name": "Wozniak",  "unsubscribed": false,  "properties": {}}'

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

Get a free Resend API key → sponsored

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