Updated Contact Endpoint

Resend Audiences allow you to group and control your contacts in a simple and intuitive way.

From the beginning, we provided several ways to add new contacts to an audience:

• via the API
• from a CSV file
• manually using the dashboard

Each contact has a unique ID, which you can use to update their information.

# Update by contact id
curl -X PATCH 'https://api.resend.com/audiences/78261eea-8f8b-4381-83c6-79fa7120f1cf/contacts/520784e2-887d-4c25-b53c-4ad46ad38100' \
    -H 'Authorization: Bearer re_123456789' \
    -H 'Content-Type: application/json' \
    -d $'{
  "unsubscribed": true
}'

Many of our users, however, found it frustrating to update contacts by their ID.

Today, we're introducing an additional way to update contacts: by their email address.

# Update by contact email
curl -X PATCH 'https://api.resend.com/audiences/78261eea-8f8b-4381-83c6-79fa7120f1cf/contacts/acme@example.com' \
    -H 'Authorization: Bearer re_123456789' \
    -H 'Content-Type: application/json' \
    -d $'{
  "unsubscribed": true
}'

All of our SDKs also support updating contacts by their email address.