Resend icon

Resend

Interact with Resend API for emails, domains, API keys, broadcasts, audiences, and contacts

Actions25

Overview

This node integrates with the Resend API to manage email-related resources, including domains. Specifically, the Domain - Create operation allows users to create a new email domain within their Resend account. This is useful for setting up sending domains to authenticate and send emails through Resend's infrastructure.

Typical use cases include:

  • Automating the setup of new sending domains when onboarding clients or projects.
  • Managing multiple sending domains programmatically.
  • Configuring domain-specific settings such as region and custom return paths for email delivery.

For example, you might use this node to create a domain "example.com" in the US East 1 region with a custom return path subdomain "send".

Properties

Name Meaning
Domain Name The name of the domain you want to create (e.g., "example.com").
Additional Options Optional settings for the domain:
- Region: The geographic region where emails will be sent from. Options are:
- US East 1
- EU West 1
- South America East 1
- Asia Pacific Northeast 1
- Custom Return Path: A custom subdomain used for the Return-Path address (default "send").

Output

The output JSON contains the response from the Resend API after creating the domain. This typically includes details about the newly created domain such as its ID, name, region, status, and any other metadata provided by the API.

No binary data is output by this operation.

Example output structure (simplified):

{
  "id": "domain_id_string",
  "name": "example.com",
  "region": "us-east-1",
  "custom_return_path": "send",
  "status": "pending_verification",
  ...
}

Dependencies

  • Requires an API key credential for authenticating with the Resend API.
  • The node makes HTTP requests to https://api.resend.com/domains endpoint.
  • Ensure the API key has permissions to create domains.
  • No additional environment variables are required beyond the API key credential.

Troubleshooting

  • Common issues:

    • Invalid or missing API key: The request will fail authentication.
    • Domain name already exists: The API may return an error if the domain is already registered.
    • Invalid region or return path values: Must use one of the predefined options or valid strings.

  • Error messages:

    • Authentication errors: Check that the API key is correctly configured and has necessary permissions.
    • Validation errors: Verify the domain name format and optional parameters.
    • Network errors: Ensure connectivity to the Resend API endpoint.

To resolve errors, verify input parameters, ensure correct API credentials, and consult the Resend API documentation for domain creation requirements.

Links and References

Discussion