Connect your business units programmatically.
MailRivo is built as an API-first platform. Every capability available in our dashboard is exposed via a robust REST interface, allowing you to sync millions of subscribers and trigger global broadcasts with standard HTTP requests.
npm install @mailrivo/sdk-d {
"email": "user@example.com",
"listId": "uuid-v4-list-id",
"customFields": { "plan": "Pro" }
}
High-throughput infrastructure for autonomous teams.
Subscriber Lifecycle API
Manage recipient profiles programmatically. Our `/v1/subscribers` endpoint supports high-concurrency upserts, allowing you to sync user data from your internal databases without worrying about duplicates or rate ceilings.
Interaction Stream
Receive real-time pulses for every subscriber interaction. Listen for opens, clicks, bounces, and complaint events to keep your local database perfectly synced.
Insight Retrieval
Fetch delivery telemetry and engagement metrics via API. Integrate MailRivo's raw data directly into your internal BI tools or custom executive dashboards.
{"day": "2026-04-12", "sent": 12040 }
]
Hardened Key Infrastructure
Our API utilizes the Bearer Token standard. Keys are strictly scoped and can be rotated instantly through the dashboard. All requests are logged with IP and node-id attribution for full audit compliance.
API-Level Isolation
Maintain strict multi-tenancy. Every request is scoped to your user account and filtered by the provided `projectId`. Your data streams never cross boundaries.
Programmatic Broadcasts
Initiate mass campaigns via the `/v1/campaigns` endpoint. Create, schedule, and trigger sends programmatically based on your own internal business logic and product cycles.
Infrastructure built for scale.
The MailRivo API is architected for zero-fail deliverability. Every request is processed through our high-concurrency Fastify middleware, backed by a sub-second response layer that keeps your production environment moving.
Hardened Security
Secure headers and Bearer auth protocols as standard.
Low Latency
Optimized PostgreSQL and Redis layers for sub-100ms API responses.
Predictable Payloads
Strict Zod-based validation on every inbound request.
High Throughput
Engineered to handle thousands of concurrent synchronization events.
"success": true,
"data": [{ "id": "sub_01", ... }],
"metadata": { "total": 12040 }
}