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-track-api.json) powers the interactive reference and is versioned with each platform release.

​
Available Endpoints

The Track API provides the following main endpoint groups:
  • Authentication: /auth/login, /auth/me, /auth/users
  • Public Tracking: /o/{token}.png (open tracking), /c/{token} (click tracking), /u/{token} (unsubscribe)
  • Statistics: /stats/, /stats/dashboard, /stats/timeseries, /stats/activity
  • Deliverability: /deliverability/
  • Suppressions: /suppressions (list, create, delete)
  • Webhook Events: /webhooks/{webhook_id}/events, /webhooks/{webhook_id}/logs, /webhooks/events/recent, /webhooks/events/failed
  • Webhook Admin: /webhooks/health, /webhooks/process-queue, /webhooks/restart-dispatcher, /webhooks/admin/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: 1000 requests per minute per workspace.
  • Tracking endpoints (pixel, clicks, unsubscribe) are public and do not require authentication.
  • API endpoints require JWT authentication.

​
Features

​
🎯 Intelligent Tracking

  • Email opens via transparent pixel
  • Link clicks with secure redirection
  • Automatic unsubscribe system
  • Event geolocation

​
📊 Advanced Analytics

  • Detailed engagement statistics
  • Real-time deliverability metrics
  • Performance reports by domain
  • Event dashboard

​
🚫 Suppression Management

  • Automatic suppression lists
  • Unsubscribe management
  • Spam prevention
  • Compliance with regulations

​
⚡ Performance

  • Asynchronous event processing
  • Redis cache for high performance
  • Optimized queue system
  • Real-time monitoring

​
🔗 Webhooks

  • Instant event notifications
  • Intelligent retry system
  • HMAC signature for security
  • Detailed delivery logs
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

Track opens

Include a transparent 1x1 pixel in your emails. Opens are automatically tracked when the pixel loads.
3

Track clicks

Links are automatically wrapped with tracking tokens. Clicks are registered and users are redirected to the original URL.
4

Monitor events

Use GET /stats/activity with your custom base URL to view detailed activity logs or subscribe to webhooks for real-time notifications.
Interactive endpoint docs below pull schema details, parameters, and sample payloads directly from the OpenAPI contract shipped with Connect.