Overview

This node operation 'Create Subscriber' allows adding a new subscriber to a Bento audience by providing an email address and optional profile data such as first name, last name, and custom fields. It validates the email format and field lengths before sending the subscriber data to the Bento API's event endpoint to register the subscription event. This operation is useful for marketing automation, email list management, and personalized communication workflows.

Use Case Examples

1. Adding a new subscriber with email and name to a mailing list for targeted email campaigns.
2. Storing additional custom attributes like company or preferences for segmentation and personalization.

Properties

Output

JSON

• operation - The operation performed, here 'createSubscriber'.
• success - Boolean indicating if the subscriber creation was successful.
• subscriber
  • email - The email address of the created subscriber.
  • firstName - The first name of the created subscriber.
  • lastName - The last name of the created subscriber.
• apiResponse - The raw API response from Bento after creating the subscriber.
• message - A human-readable message about the operation result.
• error - Error message if the operation failed.

Dependencies

• Bento API credentials including publishableKey, secretKey, and siteUuid for authentication.

Troubleshooting

• Ensure the email address is provided and in a valid format; otherwise, the node throws an error.
• Custom field keys and values must not exceed specified length limits; exceeding these will cause validation errors.
• API request failures may occur due to invalid credentials, network issues, or rate limiting; check credentials and network connectivity.
• If the API returns errors, review the error messages for guidance on fixing input data or retrying later.

Links

• Bento API - Create Subscriber - Official Bento API documentation for creating subscribers via events endpoint.