REST API + MisarMail
The MisarMail REST API is a fully RESTful, JSON-based API with OpenAPI 3.0 documentation. Authenticate with Bearer tokens, manage rate limits gracefully, and build any integration you can imagine. SDKs available for Node.js, Python, PHP, and Ruby.
Connect REST API FreeWhat you can do
- ✓Import contacts programmatically from your database
- ✓Trigger transactional campaigns from your backend
- ✓Build a custom unsubscribe management system
- ✓Pull campaign analytics into your BI dashboard
- ✓Create and manage automations from your CI/CD pipeline
How to connect REST API with MisarMail
- 1
Generate an API key
In MisarMail, go to Settings → API → Create New Key. Copy and store your API key securely.
- 2
Choose your HTTP client
Use any HTTP client or our official SDKs for Node.js, Python, PHP, or Ruby.
- 3
Authenticate requests
Add the Authorization: Bearer YOUR_API_KEY header to every API request.
- 4
Make your first API call
Try GET /api/v1/contacts to retrieve your contact list and verify the connection.
- 5
Handle pagination and errors
Use cursor-based pagination for large datasets. Check error codes in our API reference for robust error handling.
Frequently Asked Questions
Is there an OpenAPI spec available?
Yes. The full OpenAPI 3.0 spec is available at /api/v1/openapi.json and can be imported directly into Postman, Insomnia, or any API client.
What are the API rate limits?
The default rate limit is 1,000 requests per minute. Enterprise plans support higher limits with dedicated rate limit quotas.
Are there official SDKs?
Yes. We maintain official SDKs for Node.js (npm: @misarmail/sdk), Python (pip: misarmail), PHP (Composer: misarmail/sdk), and Ruby (gem: misarmail).
Ready to connect REST API?
Start free — no credit card required. The REST API integration is available on all MisarMail plans.