API Reference Complete REST API documentation for Enbbox. Authentication, rate limits, and endpoints for events, subscribers, workflows, topics, integrations, and notifications — with code examples and error handling.
TL;DR — Enbbox provides a comprehensive REST API at https://api.enbbox.com/v1. Authenticate with Authorization: Bearer YOUR_API_KEY. Endpoints cover events (trigger/cancel), subscribers (CRUD + preferences + credentials), workflows (CRUD + status), topics (CRUD + membership), integrations (CRUD + testing), and notifications (list + stats).
https://api.enbbox.com/v1 All API requests require an API key passed in the Authorization header:
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://api.enbbox.com/v1/events/trigger Generate API keys in the Enbbox dashboard under Settings → API Keys .
Plan Rate Limit Burst Free 100 requests/minute 20 Pro 1,000 requests/minute 100 Enterprise Custom Custom
Method Endpoint Description POST/events/triggerTrigger a workflow POST/events/trigger/bulkBulk trigger workflows DELETE/events/trigger/:transactionIdCancel a pending event
Method Endpoint Description GET/subscribersList subscribers POST/subscribersCreate a subscriber GET/subscribers/:subscriberIdGet subscriber details PUT/subscribers/:subscriberIdUpdate a subscriber DELETE/subscribers/:subscriberIdDelete a subscriber GET/subscribers/:subscriberId/preferencesGet preferences PATCH/subscribers/:subscriberId/preferencesUpdate preferences PUT/subscribers/:subscriberId/credentialsSet channel credentials
Method Endpoint Description GET/workflowsList workflows POST/workflowsCreate a workflow GET/workflows/:workflowIdGet workflow details PUT/workflows/:workflowIdUpdate a workflow DELETE/workflows/:workflowIdDelete a workflow PUT/workflows/:workflowId/statusUpdate workflow status
Method Endpoint Description GET/topicsList topics POST/topicsCreate a topic GET/topics/:topicKeyGet topic details DELETE/topics/:topicKeyDelete a topic POST/topics/:topicKey/subscribersAdd subscribers POST/topics/:topicKey/subscribers/removalRemove subscribers
Method Endpoint Description GET/notificationsList notifications GET/notifications/:notificationIdGet notification details GET/notifications/statsGet notification statistics
Method Endpoint Description GET/integrationsList active integrations POST/integrationsCreate an integration PUT/integrations/:integrationIdUpdate an integration DELETE/integrations/:integrationIdDelete an integration PUT/integrations/:integrationId/statusSet integration status
All errors follow a standard JSON format:
{ "statusCode" : 400 , "error" : "Bad Request" , "message" : "Detailed error description" } Code Description Resolution 400Bad Request — Invalid parameters Check request body schema 401Unauthorized — Invalid or missing API key Verify API key in Settings 404Not Found — Resource doesn't exist Check resource ID 409Conflict — Resource already exists Use a unique identifier 422Unprocessable — Validation error Check field constraints 429Too Many Requests — Rate limit exceeded Implement exponential backoff 500Internal Server Error Contact support
List endpoints support cursor-based pagination:
GET /subscribers?page= 0 &limit = 10 Response format:
{ "data" : [], "totalCount" : 100 , "page" : 0 , "pageSize" : 10 , "hasMore" : true }