Resend icon

Resend

Send emails, manage contacts, create broadcasts, handle templates, domains, segments, topics, and webhooks using the Resend email platform

Actions84

Topic → Create

AI-generated

Overview

This node operation creates a new subscription topic in the Resend email platform. Topics are used to manage email preferences for contacts, allowing them to opt in or out of specific types of emails such as newsletters or product updates. This operation is useful for email marketers or administrators who want to organize and control the types of emails their contacts receive by defining descriptive topics with default subscription settings and visibility options.

Use Case Examples

  1. Creating a 'Weekly Newsletter' topic with default subscription set to 'Opt In' so contacts must explicitly subscribe.
  2. Creating a 'Product Updates' topic with default subscription set to 'Opt Out' so contacts are subscribed by default but can opt out if they choose.

Properties

Name Meaning
Topic Name A descriptive name for the topic, e.g., Weekly Newsletter or Product Updates, used to identify the topic for managing email preferences.
Default Subscription The default subscription status for new contacts to this topic. 'Opt In' means contacts must explicitly subscribe, while 'Opt Out' means they are subscribed by default.
Description A brief description of the topic shown to contacts on the preference page to help them understand what emails they will receive.
Visibility Determines whether the topic is visible on the unsubscribe page. 'Public' topics allow contacts to manage their own subscriptions, while 'Private' topics do not.

Output

JSON

  • id - The unique identifier of the created topic.
  • name - The name of the created topic.
  • defaultSubscription - The default subscription status of the topic (opt_in or opt_out).
  • description - The description of the topic.
  • visibility - The visibility status of the topic (private or public).

Dependencies

  • Requires an API key credential for the Resend email platform to authenticate and authorize the creation of topics.

Troubleshooting

  • Ensure the API key credential is correctly configured and has permissions to create topics.
  • Verify that the 'Topic Name' is provided and is unique to avoid conflicts.
  • Check that the 'Default Subscription' value is either 'opt_in' or 'opt_out' as required.
  • If the API returns errors, review the error message for details such as rate limits or invalid parameters and adjust accordingly.

Discussion