Bento API
Search…
⌃K

Commands

The commands endpoint is designed to manipulate a single visitors data easily. Add tags, update fields, and more within a single request.
This endpoint is designed for single updates on a visitor. To update multiple fields please use the batch/subscribers` or `batch/events` endpoints.
MAX 100 commands per call.
This endpoint does not trigger Workflows with the exception of the add_tag_via_event command.
post
https://app.bentonow.com
/api/v1/fetch/commands
Run Command
This endpoint is designed primarily to update a single visitor or a handful of visitors.
List of available commands:
// Tag Subscriber
{ "command": "add_tag", "email": "[email protected]", "query": "example" }
// Tag Subscriber via Event (Triggers Automations)
{ "command": "add_tag_via_event", "email": "[email protected]", "query": "example" }
// Remove Tag
{ "command": "remove_tag", "email": "[email protected]", "query": "example" }
// Add Field
{ "command": "add_field", "email": "[email protected]", "query": {"key": "test", "value": "test" }
// Remove Field
{ "command": "remove_field", "email": "[email protected]", "query": "example" }
// Subscribe
{ "command": "subscribe", "email": "[email protected]" }
// Unsubscribe
{ "command": "unsubscribe", "email": "[email protected]" }
// Change email
{ "command": "change_email", "email": "[email protected]", "query": "[email protected]" }
The above can be sent over as an array if you aim to apply many changes in a single call:
[
{ "command": "unsubscribe", "email": "[email protected]" },
{ "command": "remove_tag", "email": "[email protected]", "query": "example" }
]