Bento API v1
Welcome to the Bento API v1 documentation. Let's build something amazing together!
Base URL for API v1 calls: https://app.bentonow.com/api/v1/
API v1 is under active development.
Quick Note
Here's a quote from Jesse that is helpful to keep in mind when using the Bento API:
If you want trigger automations or track real activity, use 'batch/events'. Everything else, import (batch/subscribers).
Libraries
We provide open-source libraries for various languages to interact with the Bento API. For queries or issues, please open an issue on the respective Github repo.
| Library | Description | Link | Coverage |
|---|---|---|---|
| Node | Javascript library for Bento's API | Github | 100% |
| PHP | PHP library for Bento's API | Github | 100% |
| Ruby | Ruby library for Bento event tracking | Github | Tracking Only |
Authentication
API calls require HTTP Basic Authentication. Use your publishable_key as username and secret_key as password. Find your keys here.
Scope requests by site using your site_uuid (aka Site Key), found in site settings or by clicking the gear icon on your site. You can also find this on your API keys page.
NOTE: Your keys provide access to all sites your account can access. If managing multiple Bento accounts, use the client's API keys.
Common Errors
| Code | Description | Debug Notes |
|---|---|---|
| 400 | Bad Request | Ensure your request matches the format of the examples. |
| 401 | Unauthorized | Verify the correct usage of publishable key, secret key, and site key/uuid. |
| 429 | Too Many Requests | Reduce the number of requests. |
| 500 | Internal Server Error | Ensure your request matches the format of the examples. Check our uptime status if the issue persists. |
Rate Limits
Rate limits are enforced to maintain API stability and prevent excessive usage. Please ensure fair and equal access to API resources.
| Endpoint | Rate Limit |
|---|---|
| /api/v1/fetch | 100 requests per minute |
| /api/v1/batch | 100 requests per minute |
| /api/v1/experimental | 100 requests per minute |
Implement rate limiting in your application to comply with these limits. Cache responses where possible.
For higher rate limits, contact our support team with your use case details.
We appreciate your cooperation in maintaining our API's stability and reliability.
Authentication
- HTTP: Basic Auth
| Security Scheme Type: | http |
|---|---|
| HTTP Authorization Scheme: | basic |