Resend API (unofficial showcase)
PATCH/contacts/{contact_id}/topics

Update a contact’s topic subscriptions

Updates a contact’s subscriptions to topics. Supply the required topics array with each topic ID and its subscription status.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 1 body field
contact_idstringrequired
The contact’s ID or email address.

Topic subscription updates for the contact. Include the required topics array.

topicsarray<object>required
The topic subscriptions to update. Each item contains a topic ID and a subscription status of `opt_in` or `opt_out`.

1 status code
200Returns the contact ID, response object type, and an array of updated topic subscriptions.
objectstringoptional
The object type.
contact_idstringoptional
The ID of the contact.
topicsarray<object>optional
Array of updated topic subscriptions.

Error handling

The contact_id path parameter must identify the contact whose subscriptions you are changing. topics is required, and each item's subscription must be opt_in or opt_out.