Update topics for a contact

PATCH/contacts/{contact_id}/topicsUpdate topics for a contact

Parameters

contact_idstringpathrequired

The Contact ID or email address.

Request body

application/json

objectUpdateContactTopicsOptions

topicsarray of objectrequired

Show child attributes

Show array items

idstring

The ID of the topic.

subscriptionstring

The subscription status (opt_in or opt_out).

one of "opt_in", "opt_out"

Example request

{
  "topics": [
    {
      "id": "string",
      "subscription": "opt_in"
    }
  ]
}

Responses

objectUpdateContactTopicsResponseSuccess

contact_idstring

The ID of the contact.

objectstring

The object type.

topicsarray of object

Array of updated topic subscriptions.

Show child attributes

Show array items

idstring

The ID of the topic.

subscriptionstring

The subscription status.

one of "opt_in", "opt_out"

Example response

{
  "contact_id": "string",
  "object": "contact_topics",
  "topics": [
    {
      "id": "string",
      "subscription": "opt_in"
    }
  ]
}

Examples

contact_idrequiredpath parameter

curl -X PATCH 'https://api.resend.com/contacts/string/topics' \
  -H 'Content-Type: application/json' \
  -d '{"topics":[{"id":"string","subscription":"opt_in"}]}'

const response = await fetch('https://api.resend.com/contacts/string/topics', {
  method: 'PATCH',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"topics":[{"id":"string","subscription":"opt_in"}]}),
});
const data = await response.json();

const response = await fetch('https://api.resend.com/contacts/string/topics', { method: 'PATCH', headers: { 'Content-Type': 'application/json' }, body: "{\"topics\":[{\"id\":\"string\",\"subscription\":\"opt_in\"}]}" });
console.log(await response.json());

import requests

response = requests.request(
    "PATCH",
    "https://api.resend.com/contacts/string/topics",
    headers={"Content-Type": "application/json"},
    data='{"topics":[{"id":"string","subscription":"opt_in"}]}',
)
print(response.json())

package main

import (
	"context"
	"net/http"
	"strings"
)

func main() {
	ctx := context.Background()
	body := strings.NewReader(`{"topics":[{"id":"string","subscription":"opt_in"}]}`)
	req, err := http.NewRequestWithContext(ctx, "PATCH", "https://api.resend.com/contacts/string/topics", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

<?php
$request = curl_init("https://api.resend.com/contacts/string/topics");
curl_setopt($request, CURLOPT_CUSTOMREQUEST, "PATCH");
curl_setopt($request, CURLOPT_POSTFIELDS, "{\"topics\":[{\"id\":\"string\",\"subscription\":\"opt_in\"}]}");
curl_setopt($request, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
$response = curl_exec($request);
curl_close($request);

var request = HttpRequest.newBuilder(URI.create("https://api.resend.com/contacts/string/topics"))
    .method("PATCH", HttpRequest.BodyPublishers.noBody())
    .header("Content-Type", "application/json")
    .method("PATCH", HttpRequest.BodyPublishers.ofString("{\"topics\":[{\"id\":\"string\",\"subscription\":\"opt_in\"}]}"))
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

require 'net/http'

uri = URI("https://api.resend.com/contacts/string/topics")
request = Net::HTTPGenericRequest.new("PATCH", true, true, uri)
request['Content-Type'] = 'application/json'
request.body = "{\"topics\":[{\"id\":\"string\",\"subscription\":\"opt_in\"}]}"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Patch, "https://api.resend.com/contacts/string/topics");
request.Content = new StringContent("{\"topics\":[{\"id\":\"string\",\"subscription\":\"opt_in\"}]}", Encoding.UTF8, "application/json");
using var response = await client.SendAsync(request);

{
  "contact_id": "string",
  "object": "contact_topics",
  "topics": [
    {
      "id": "string",
      "subscription": "opt_in"
    }
  ]
}

Search documentation

Emails

Domains

Audiences

Contacts

Receiving Emails

Webhooks

Templates

Broadcasts

Segments

Topics

Contact Properties

Logs

Automations

Events

API keys