Actions16
Subscriber Command
AI-generatedOverview
This node executes various subscriber-related commands on the Bento platform, such as adding or removing tags and fields, changing subscriber email addresses, and subscribing or unsubscribing an email address. It is useful for managing subscriber data dynamically within automation workflows, for example, tagging VIP customers, updating subscriber information, or managing subscription status.
Use Case Examples
- Add a 'vip_customer' tag to a subscriber's profile to segment high-value customers.
- Change a subscriber's email address when they update their contact information.
- Unsubscribe an email address from the mailing list to comply with user requests.
Properties
| Name | Meaning |
|---|---|
| The email address of the subscriber to execute the command on. | |
| Command | The specific command to execute on the subscriber, such as adding/removing tags or fields, changing email, subscribing, or unsubscribing. |
| Tag/Field Name | The name of the tag or field to add or remove (required for add_tag, add_tag_via_event, remove_tag, remove_field commands). |
| Field Key | The key/name of the custom field to add (required for add_field command). |
| Field Value | The value of the custom field to add (required for add_field command). |
| New Email | The new email address for the subscriber (required for change_email command). |
Output
JSON
operation- The subscriber command operation executed.success- Indicates if the command was executed successfully.command- The command that was executed.email- The email address of the subscriber on which the command was executed.query- The query parameter used in the command, such as tag/field name or new email.apiResponse- The raw API response from the Bento service.message- A human-readable message describing the result of the command execution.error- Error message if the command execution failed.
Dependencies
- Requires Bento API credentials including publishableKey, secretKey, and siteUuid for authentication.
Troubleshooting
- Ensure the email address provided is valid and correctly formatted; invalid emails will cause errors.
- Required parameters for each command must be provided, e.g., 'query' for tag/field commands, 'newEmail' for change_email command.
- Check API credentials are correctly set and have necessary permissions to execute subscriber commands.
- Rate limiting by the Bento API may cause temporary failures; retry after some time if rate limited.
- Error messages from the API are surfaced to help diagnose issues; review these messages for guidance.