Create a new topic

POST/topicsCreate a new topic

Request body

application/json

objectCreateTopicOptions

default_subscriptionstringrequired

The default subscription status for the topic. Cannot be changed after creation.

one of "opt_in", "opt_out"

descriptionstring

A description of the topic. Max 200 characters.

maxLength 200

namestringrequired

The name of the topic. Max 50 characters.

maxLength 50

visibilitystring

The visibility of the topic. Public topics are visible to all contacts on the unsubscribe page. Private topics are only visible to opted-in contacts.

one of "public", "private" · default "private"

Example request

{
  "default_subscription": "opt_in",
  "description": "string",
  "name": "string",
  "visibility": "private"
}

Responses

objectCreateTopicResponseSuccess

idstring

The ID of the topic.

objectstring

The object type of the response.

Example response

{
  "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "object": "topic"
}

Examples

curl -X POST 'https://api.resend.com/topics' \
  -H 'Content-Type: application/json' \
  -d '{"default_subscription":"opt_in","description":"string","name":"string","visibility":"private"}'

const response = await fetch('https://api.resend.com/topics', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"default_subscription":"opt_in","description":"string","name":"string","visibility":"private"}),
});
const data = await response.json();

const response = await fetch('https://api.resend.com/topics', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: "{\"default_subscription\":\"opt_in\",\"description\":\"string\",\"name\":\"string\",\"visibility\":\"private\"}" });
console.log(await response.json());

import requests

response = requests.request(
    "POST",
    "https://api.resend.com/topics",
    headers={"Content-Type": "application/json"},
    data='{"default_subscription":"opt_in","description":"string","name":"string","visibility":"private"}',
)
print(response.json())

package main

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

func main() {
	ctx := context.Background()
	body := strings.NewReader(`{"default_subscription":"opt_in","description":"string","name":"string","visibility":"private"}`)
	req, err := http.NewRequestWithContext(ctx, "POST", "https://api.resend.com/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/topics");
curl_setopt($request, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($request, CURLOPT_POSTFIELDS, "{\"default_subscription\":\"opt_in\",\"description\":\"string\",\"name\":\"string\",\"visibility\":\"private\"}");
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/topics"))
    .method("POST", HttpRequest.BodyPublishers.noBody())
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"default_subscription\":\"opt_in\",\"description\":\"string\",\"name\":\"string\",\"visibility\":\"private\"}"))
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

require 'net/http'

uri = URI("https://api.resend.com/topics")
request = Net::HTTPGenericRequest.new("POST", true, true, uri)
request['Content-Type'] = 'application/json'
request.body = "{\"default_subscription\":\"opt_in\",\"description\":\"string\",\"name\":\"string\",\"visibility\":\"private\"}"
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.Post, "https://api.resend.com/topics");
request.Content = new StringContent("{\"default_subscription\":\"opt_in\",\"description\":\"string\",\"name\":\"string\",\"visibility\":\"private\"}", Encoding.UTF8, "application/json");
using var response = await client.SendAsync(request);

{
  "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "object": "topic"
}

Search documentation

Emails

Domains

Audiences

Contacts

Receiving Emails

Webhooks

Templates

Broadcasts

Segments

Topics

Contact Properties

Logs

Automations

Events

API keys