Beehiiv icon

Beehiiv

Consumes the Beehiiv API

Overview

This node integrates with the Beehiiv API to manage subscriptions. Specifically, the "Subscription - Create" operation allows users to add a new subscriber by providing their email and subscription preferences. This is useful for automating newsletter signups or managing mailing lists directly from workflows.

Practical examples include:

  • Automatically subscribing users who fill out a form on your website.
  • Adding subscribers collected from other platforms into Beehiiv without manual intervention.
  • Controlling whether subscribers receive welcome emails or bypass double opt-in confirmation.

Properties

Name Meaning
Email The email address of the subscriber to be added.
Double Opt Override Whether to override the default double opt-in setting. Options: "on" or "off".
Send Welcome Email Whether to send the welcome email to the new subscriber. Boolean: true or false.

Output

The node outputs an array of JSON objects representing the created subscription(s). Each object contains the data returned by the Beehiiv API for the newly created subscription, typically including subscriber details and status.

No binary data output is produced by this node.

Dependencies

  • Requires an active connection to the Beehiiv API via an API key credential configured in n8n.
  • The node uses the Beehiiv API endpoint /subscriptions with HTTP POST method to create subscriptions.

Troubleshooting

  • Common issues:

    • Invalid or missing email address will cause the API request to fail.
    • Incorrect API credentials or network issues may result in authentication or connectivity errors.
    • If the double opt-in override value is not "on" or "off", the API might reject the request.

  • Error messages:

    • Errors returned from the Beehiiv API are passed through. For example, "Invalid email format" indicates the provided email does not meet requirements.
    • Network or authentication errors usually indicate misconfigured API credentials or connectivity problems.

  • Resolution tips:

    • Verify that the email input is valid and properly formatted.
    • Ensure the API key credential is correctly set up and has necessary permissions.
    • Check network connectivity and API service status if requests fail unexpectedly.

Links and References

Discussion