Skip to main content

​
Base URL

Each customer has a custom base URL that can be found in the Integration tab of your Connect dashboard. The base URL is unique to your account and infrastructure.
Navigate to Connect → Email API → Integration tab to find your custom base URL. All API requests should use this URL as the base.
All requests require HTTPS. The OpenAPI document (api-reference/openapi-email-api.json) powers the interactive reference and is versioned with each platform release.

​
Available Endpoints

The Email API provides the following main endpoint groups:
  • Authentication: /auth/login, /auth/me, /auth/users
  • API Keys: /api-keys (create, list, get, update, delete), /api-keys/stats/usage
  • Email Sending: /emails/send, /emails/status/{message_id}, /emails/history
  • Webhooks: /webhooks (create, list, get, update, delete, test), /webhooks/stats/*
All endpoints are documented in detail below with interactive examples.

​
Authentication

Use the API key you generated in Connect. Keys are JWT tokens presented as Bearer credentials. 
Authorization: Bearer rbak_xxxxxxxxx
JWT tokens expire if revoked in Connect. Rotate keys through the dashboard before deleting the current token to avoid downtime.

​
Rate limiting

  • Default: 600 requests per minute per workspace.
  • Burst handling: contact RevBridge support to raise limits for VIP workloads.
  • Webhooks inherit automatic retry with exponential backoff when your service responds with 5xx.

​
Features

​
📧 Email Sending

  • Send transactional and marketing emails
  • Support for custom templates
  • High-performance queue system
  • Real-time delivery tracking

​
🔗 Intelligent Webhooks

  • Real-time email event notifications
  • Automatic retry system with exponential backoff
  • HMAC signature for security
  • Complete performance monitoring

​
📊 Analytics and Reports

  • Detailed delivery statistics
  • Engagement metrics (opens, clicks)
  • Deliverability reports
  • Performance dashboard

​
🔐 Security

  • JWT authentication
  • Role-based access control
  • Rate limiting
  • Rigorous data validation
1

Get your base URL

Navigate to Connect → Email API → Integration tab to find your custom base URL. This is unique to your account.
2

Authenticate

Generate an API key in Connect and store it securely. Include the Authorization header on every request.
3

Send messages

Use POST /emails/send with your custom base URL to enqueue transactional or marketing traffic. Provide domain_name for the dedicated infrastructure you provisioned.
4

Track delivery

Poll GET /emails/status/{message_id} or subscribe to webhooks for real-time events like delivered, bounced, and clicked.
Interactive endpoint docs below pull schema details, parameters, and sample payloads directly from the OpenAPI contract shipped with Connect.