MailerSend Developer Documentation

website·Indexed 37 days ago

https://developers.mailersend.com/

Documentation for MailerSend's transactional email, SMS, and WhatsApp delivery systems. Includes guides on API authentication, webhooks, and email threading, as well as references for the /v1/ API, official SDKs for PHP, Node.js, Python, Go, Ruby, and Java, a command-line interface (CLI), and a Model Context Protocol (MCP) server for AI integration.

Tokens
73.2K
Snippets
385
Records
474
Agent score
68%

What's inside MailerSend

  1. Retrieve a specific blocklist monitor

    Get detailed information about a specific blocklist monitor using its ID. The response structure differs based on whether the monitor is a single entity or an IP range:

    1. Single Monitor (Domain or IP): If has_children is false, the response includes a hits array detailing the specific blocklists where the address is listed.
    2. IP Range Monitor: If has_children is true (created from a CIDR block), the response includes a children array containing all individual child monitors and their statuses. No hits array is provided for the parent range.
    GET https://api.mailersend.com/v1/blocklist-monitoring/{monitor_id}
  2. Retrieve a specific email verification list

    Retrieve detailed information about a single email verification list using its unique ID. By setting the detailed query parameter to true, the response will include an emails object containing paginated verification results for the addresses in that list.
    GET https://api.mailersend.com/v1/email-verification/{email_verification_id}?detailed=true&page=1&limit=100
  3. Retrieve a specific SMS recipient

    Get detailed information about a single SMS recipient, including their phone number, status, and a history of SMS messages sent to them, by providing the sms_recipient_id in the URL path.
    GET https://api.mailersend.com/v1/sms-recipients/{sms_recipient_id}

    URL Parameters:

    • sms_recipient_id (string, required): The unique identifier of the SMS recipient.
  4. Retrieve a single scheduled message by ID

    Use the GET /v1/message-schedules/{message_id} endpoint to get detailed information about a specific scheduled message, including its subject, domain, and sending date. The message_id can be obtained from the response headers of the 'Send an email' request or from the 'Get scheduled messages' list response.
    GET https://api.mailersend.com/v1/message-schedules/{message_id}
  5. Retrieve a list of inbound routes

    Retrieve information about multiple inbound routes using a GET request to /v1/inbound. You can filter by domain and paginate the results.
    GET https://api.mailersend.com/v1/inbound

    Query Parameters:

    • domain_id (string, optional): Filter routes by domain ID.
    • page (int, optional): Page number. Minimum: 1.
    • limit (int, optional): Number of results per page. Min: 10, Max: 100. Default: 10.
  6. Retrieve details for a single domain

    Fetch detailed information about a specific domain using its unique domain ID. This includes verification status, DNS activity, and specific domain settings such as click and open tracking configurations.
    GET https://api.mailersend.com/v1/domains/{domain_id}

    URL Parameters:

    • domain_id (string, required): The unique identifier of the domain.