--- title: Mailersend API Integration on Truto slug: mailersend category: Email canonical: "https://truto.one/integrations/detail/mailersend/" --- # Mailersend API Integration on Truto **Category:** Email **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Roles** — The Role object represents a role of a User. - **Users** — The User object represents a User. ## How it works 1. **Link your customer's Mailersend account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Mailersend.** The Proxy API is a 1-to-1 mapping of the Mailersend API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Enable white-labeled transactional email for your customers** — Let your users connect their own MailerSend accounts so emails (invoices, receipts, alerts) are sent from their domain with their branding — not yours. This improves deliverability and trust without you managing email infrastructure per tenant. - **Sync user and role data from MailerSend accounts** — Pull team member details and roles from your customers' MailerSend accounts using Truto's Unified User Directory API. This is useful for access control, audit logging, or displaying which team members have email-sending permissions inside your product. - **Build a Bring Your Own Email Provider (BYOP) workflow** — SaaS platforms offering notification or communication features can let end users pick MailerSend as their email provider. Truto handles the auth and connection lifecycle so your team focuses on the product experience, not OAuth flows and token management. - **Power event-driven email and SMS dispatch from your platform** — When internal events fire (e.g., payment failed, order shipped), your platform can route them through the customer's MailerSend account to send templated emails or SMS messages. This keeps the customer in control of their messaging while your SaaS orchestrates the logic. - **Surface email deliverability insights inside your product** — Fetch analytics, message statuses, and suppression lists from MailerSend to build in-app dashboards showing open rates, bounces, and spam complaints — giving your users visibility without leaving your product. ## What you can build - **Team member and role directory sync** — Use Truto's Unified User Directory API to pull MailerSend users and their roles into your app for permissions management, onboarding flows, or audit trails. - **In-app MailerSend template picker** — Fetch the customer's MailerSend templates and let them map app events to specific email templates directly within your settings UI — no context switching required. - **Embedded email performance dashboard** — Query MailerSend analytics and message data to render open rates, click rates, and bounce metrics as a native widget inside your product. - **Automated suppression list sync** — Periodically pull hard bounces, unsubscribes, and spam complaints from MailerSend into your platform to automatically suppress bad addresses and protect your users' sender reputation. - **Webhook auto-registration for real-time email status updates** — Programmatically register MailerSend webhooks on behalf of your users so delivery, open, and bounce events flow back into your app in real time — zero manual setup for the end user. - **Unified email + SMS notification flow** — Leverage MailerSend's dual email and SMS capabilities to let your users configure multi-channel notification sequences triggered by events in your platform. ## FAQs ### What authentication method does MailerSend use? MailerSend uses API token-based authentication. End users generate a token from their MailerSend dashboard and provide it during the connection flow. Truto securely stores and manages these tokens so your team doesn't have to. ### Which Truto Unified APIs are available for MailerSend? MailerSend is currently mapped to Truto's Unified User Directory API, which supports reading Users and Roles from connected accounts. Additional tools and unified API mappings can be built on request based on your use case. ### Are there specific tools or proxy endpoints available for MailerSend today? There are no pre-built tools for MailerSend at this time. Truto builds tools on request — if you need support for templates, message dispatch, analytics, suppressions, or webhooks, the Truto team can scope and deliver these based on your requirements. ### Does MailerSend enforce rate limits on its API? Yes. MailerSend applies rate limits that vary by endpoint and plan tier. Truto handles retry logic and rate-limit awareness so your integration degrades gracefully under load without you writing custom backoff logic. ### Can I use Truto's proxy to call MailerSend endpoints not yet covered by a Unified API? Yes. Truto's proxy pass-through lets you make authenticated requests to any MailerSend API endpoint using the stored credentials, even if a unified model or dedicated tool hasn't been built yet. This gives you immediate access while custom tools are being developed. ### How fresh is the user and role data synced via the Unified User Directory API? Data is fetched in real time from the MailerSend API on each request through Truto. There is no caching layer introducing staleness — what MailerSend returns is what your application receives.