> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to MailerSend

The MailerSend connector lets your AI agent act in each user's MailerSend account. Each user connects their own MailerSend access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 56 tools.

**Authentication:** Bearer Token
**Categories:** Communication, Marketing
**Tools:** 56: 31 read, 17 write, 8 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=MAILERSEND)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the MailerSend connection

   In **AgentKit > Connections**, create a MailerSend connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

   **Console steps with screenshots:**

   Register a MailerSend API token with Scalekit so it can call MailerSend on behalf of your users. MailerSend sends the token as a Bearer token. You need a MailerSend account with at least one domain added, because each token is created for a domain.

   1. ### Create a MailerSend API token

      - Sign in to [MailerSend](https://app.mailersend.com) and go to **Developer Tools** → **API tokens**.
      - Click **Create new token** and give it a name, such as `Scalekit`.
      - Select the domain the token is for.
      - Set an **expiration date**. If you leave it empty, MailerSend expires the token after 24 hours.
      - Choose the access: **Full access**, or **Custom access** with the endpoints your agent uses, such as **Email** to send and **Activity** or **Analytics** to read. A call outside the token's access fails with `403`.
      - Click **Generate token** and copy the token. It starts with `mlsn.`.

      > caution: Copy the token now
      >
      > MailerSend shows the token only once. Store it in a secrets manager. If you lose it, delete the token in **API tokens** and create a new one.

      See MailerSend's [Managing API tokens](https://www.mailersend.com/help/managing-api-tokens) for every access option.

   2. ### Create a connection in Scalekit

      - In the [Scalekit dashboard](https://app.scalekit.com), go to **AgentKit** → **Connections** → **Create Connection**.
      - Search for **MailerSend** and click **Create**.
      - Note the **Connection name**. Use it as `connection_name` in your code, for example `mailersend`.

   3. ### Add a connected account

      A connected account links a user ID in your app to a MailerSend API token. Add one in the dashboard to test. In production, each user adds their own through the authorization link: they paste their MailerSend API token on the page it opens.

      **In the dashboard, to test**

      - Open the connection and click the **Connected Accounts** tab → **Add account**.
      - Fill in **Your User's ID** and **API Token**, then click **Save**.

      **From your backend, if your app already has the token**

      For example, when users enter it on a settings page in your app:

        **Node.js**

        ```typescript
        import { ConnectorStatus } from '@scalekit-sdk/node'

        const { connectedAccount } = await scalekit.actions.upsertConnectedAccount({
          connectionName: 'mailersend',
          identifier: 'user_123',
          authorizationDetails: {
            details: {
              case: 'staticAuth',
              value: { details: { token: process.env.USER_MAILERSEND_TOKEN } },
            },
          },
        });
        console.log(connectedAccount && ConnectorStatus[connectedAccount.status]);
        ```

        **Python**

        ```python
        response = scalekit_client.actions.upsert_connected_account(
            connection_name="mailersend",
            identifier="user_123",
            authorization_details={"static_auth": {"token": user_mailersend_token}},
        )
        print(response.connected_account.status)
        ```

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'mailersend'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize MailerSend:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'mailersend_account_get',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "mailersend"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize MailerSend:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="mailersend_account_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their MailerSend credentials there. If your app already has a user's credentials, add the account from your backend instead, as the console steps above show. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'mailersend_account_get',
  toolInput: {},
  connector: 'mailersend',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="mailersend_account_get",
    tool_input={},
    connection_name="mailersend",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `mailersend_account_get`

Get Account · Read-only

Get the account's plan, email usage, rate limits and resource limits.
Returns name, status, plan_type, data_retention_days, emails (sent, received, limit), rate_limits, resources and addons.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `mailersend_activity_list`

List Email Activity · Read-only

List raw email events (sent, delivered, bounced, opened, clicked, unsubscribed and more) for a domain in a date range.
Returns data, an array of activities with id, type, created_at and the email (from, subject, recipient, status), plus meta and links for paging.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `date_from` (`string`, required): Start of the range: a Unix timestamp, ISO 8601 (2026-11-01T00:00:00Z) or 'YYYY-MM-DD HH:MM:SS', in UTC. Example: 2026-11-01T00:00:00Z
- `date_to` (`string`, required): End of the range, in the same formats as date_from; must be later than date_from. Example: 2026-11-13T23:59:59Z
- `domain_id` (`string`, required): Domain ID (from mailersend_domains_list) Example: jy7zpl9xqo4l5vx6
- `event` (`array`, optional): Only these event types. Example: ["delivered", "hard_bounced"]
- `limit` (`integer`, optional): Results per page, 10 to 100. Defaults to 25. Example: 25
- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1

Example input: `{"date_from":"<date_from>","date_to":"<date_to>","domain_id":"<domain_id>"}`

### `mailersend_analytics_by_date_get`

Get Analytics by Date · Read-only

Get counts of email events per day, week, month or year over a range of up to 183 days.
Returns data with date_from, date_to, group_by and stats, an array of buckets with date and a count per requested event.
Use mailersend_analytics_opens_by_get for opens by country or email client.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `date_from` (`string`, required): Start of the range: a Unix timestamp, ISO 8601 (2026-11-01T00:00:00Z) or 'YYYY-MM-DD HH:MM:SS', in UTC. Example: 2026-11-01
- `date_to` (`string`, required): End of the range, in the same formats as date_from; must be later than date_from (not in the future) Example: 2026-11-13
- `event` (`array`, required): Events to count. Example: ["sent", "delivered", "opened", "clicked"]
- `domain_id` (`string`, optional): Domain ID (from mailersend_domains_list); leave empty for all domains. Example: jy7zpl9xqo4l5vx6
- `group_by` (`string`, optional): Bucket size. Defaults to days. Example: days. One of: `days`, `weeks`, `months`, `years`.
- `tags` (`array`, optional): Only emails with these tags. Example: ["order-shipped"]

Example input: `{"date_from":"<date_from>","date_to":"<date_to>","event":["sent","delivered","opened","clicked"]}`

### `mailersend_analytics_opens_by_get`

Get Opens by Country or Client · Read-only

Get email opens broken down by recipient country, email client name or client type over a range of up to 183 days.
Returns data with date_from, date_to and stats, an array with name (country code, client or type) and count.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `date_from` (`string`, required): Start of the range: a Unix timestamp, ISO 8601 (2026-11-01T00:00:00Z) or 'YYYY-MM-DD HH:MM:SS', in UTC. Example: 2026-11-01
- `date_to` (`string`, required): End of the range, in the same formats as date_from; must be later than date_from (not in the future) Example: 2026-11-13
- `dimension` (`string`, required): Breakdown: country, ua-name (email client name) or ua-type (client type) Example: country. One of: `country`, `ua-name`, `ua-type`.
- `domain_id` (`string`, optional): Domain ID (from mailersend_domains_list); leave empty for all domains. Example: jy7zpl9xqo4l5vx6
- `tags` (`array`, optional): Only emails with these tags. Example: ["order-shipped"]

Example input: `{"date_from":"<date_from>","date_to":"<date_to>","dimension":"country"}`

### `mailersend_api_quota_get`

Get API Quota · Read-only

Check how many API requests remain in the current daily quota. Does not count toward the quota.
Returns quota, remaining and reset (when the quota resets).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `mailersend_bulk_email_status_get`

Get Bulk Email Status · Read-only

Check the progress and result of a bulk email request.
Returns data with state (queued, processing, completed), total_recipients_count, suppressed_recipients_count, validation_errors_count, messages_id and validation_errors.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bulk_email_id` (`string`, required): Bulk email ID returned by mailersend_bulk_email_send. Example: 614470d1588b866d0454f3e2

Example input: `{"bulk_email_id":"<bulk_email_id>"}`

### `mailersend_domain_dns_records_get`

Get Domain DNS Records · Read-only

Get the DNS records (SPF, DKIM, return-path, custom tracking, inbound routing) to publish for a domain.
Returns data with each record's hostname, type, value and status.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `domain_id` (`string`, required): Domain ID. Example: jy7zpl9xqo4l5vx6

Example input: `{"domain_id":"<domain_id>"}`

### `mailersend_domain_get`

Get Domain · Read-only

Retrieve one domain with its verification status and settings.
Returns data with id, name, dkim, spf, tracking, is_verified, is_dns_active and domain_settings.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `domain_id` (`string`, required): Domain ID. Example: jy7zpl9xqo4l5vx6

Example input: `{"domain_id":"<domain_id>"}`

### `mailersend_domain_recipients_list`

List Domain Recipients · Read-only

List the recipients that have received email from one domain.
Returns data, an array with id, email, created_at, updated_at and deleted_at, plus meta for paging.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `domain_id` (`string`, required): Domain ID. Example: jy7zpl9xqo4l5vx6
- `limit` (`integer`, optional): Results per page, 10 to 100. Defaults to 25. Example: 25
- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1

Example input: `{"domain_id":"<domain_id>"}`

### `mailersend_domains_list`

List Domains · Read-only

List the sending domains in the account.
Returns data, an array with id, name, dkim, spf, tracking, is_verified, is_dns_active, domain_settings and created_at, plus meta for paging.
Use this to get a domain_id for other tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Results per page, 10 to 100. Defaults to 25. Example: 25
- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1
- `verified` (`boolean`, optional): Only verified (true) or unverified (false) domains. Example: true

Example input: `{}`

### `mailersend_email_get`

Get Email · Read-only

Retrieve one sent email with its current status and its activity events.
Returns data with id, from, subject, status, recipient, tags, created_at and activities (event type and time).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `email_id` (`string`, required): Email ID from mailersend_emails_list. Example: 5ee0b166b251345e407c9207

Example input: `{"email_id":"<email_id>"}`

### `mailersend_emails_list`

List Emails · Read-only

Search the sending log of one domain: one row per email, filtered by date range, status, interaction, recipient, subject, tag or template.
Returns data, an array of emails with id, from, subject, status, recipient, tags, template_id, created_at and the latest interaction, plus meta and links for paging.
Use this to find emails. Use mailersend_email_get for one email's events and mailersend_activity_list for raw events.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `date_from` (`string`, required): Start of the range: a Unix timestamp, ISO 8601 (2026-11-01T00:00:00Z) or 'YYYY-MM-DD HH:MM:SS', in UTC. Example: 2026-11-01 00:00:00
- `date_to` (`string`, required): End of the range, in the same formats as date_from; must be later than date_from. Example: 2026-11-13 23:59:59
- `domain_id` (`string`, required): Domain ID (from mailersend_domains_list) Example: jy7zpl9xqo4l5vx6
- `interaction` (`array`, optional): Only emails with these recipient interactions (OR) Example: ["opened"]
- `limit` (`integer`, optional): Results per page, 10 to 1000. Defaults to 25. Example: 50
- `message_id` (`string`, optional): Exact message ID. Example: 61487a14608b1d0b4d506633
- `page` (`integer`, optional): Page number, 1 to 100. Example: 1
- `recipient_email` (`string`, optional): Exact recipient address. Example: jane@example.com
- `status` (`array`, optional): Only emails with these statuses (OR) Example: ["delivered"]
- `subject` (`string`, optional): Part of the subject (at least 3 characters, case-insensitive) Example: shipped
- `tag` (`string`, optional): Exact tag. Example: order-shipped
- `template_id` (`string`, optional): Exact template ID. Example: vywj2lpokkm47oqz

Example input: `{"date_from":"<date_from>","date_to":"<date_to>","domain_id":"<domain_id>"}`

### `mailersend_identities_list`

List Sender Identities · Read-only

List sender identities (single verified sender addresses), optionally by domain or address.
Returns data, an array with id, email, name, reply_to_email, reply_to_name, is_verified, resends and domain, plus meta.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `domain_id` (`string`, optional): Domain ID (from mailersend_domains_list); leave empty for all domains. Example: jy7zpl9xqo4l5vx6
- `limit` (`integer`, optional): Results per page, 10 to 100. Defaults to 25. Example: 25
- `order` (`string`, optional): Sort direction. Defaults to asc. Example: desc. One of: `asc`, `desc`.
- `order_by` (`string`, optional): Sort field. Defaults to created_at. Example: created_at. One of: `email`, `created_at`, `verified_at`.
- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1
- `query` (`string`, optional): Filter by email address. Example: orders@

Example input: `{}`

### `mailersend_identity_get`

Get Sender Identity · Read-only

Retrieve one sender identity.
Returns data with id, email, name, reply_to_email, reply_to_name, is_verified and domain.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `identity_id` (`string`, required): Sender identity ID. Example: 7z3m5jgrogdpyo6n

Example input: `{"identity_id":"<identity_id>"}`

### `mailersend_inbound_route_get`

Get Inbound Route · Read-only

Retrieve one inbound route.
Returns data with id, name, address (the receiving address), domain, enabled, filters, forwards and priority.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `inbound_id` (`string`, required): Inbound route ID. Example: vy3j2l1xz8mm97yo

Example input: `{"inbound_id":"<inbound_id>"}`

### `mailersend_inbound_routes_list`

List Inbound Routes · Read-only

List inbound routes, which forward received email to addresses or webhooks.
Returns data, an array with id, name, address, domain, enabled, filters, forwards and priority, plus meta.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `domain_id` (`string`, optional): Domain ID (from mailersend_domains_list); leave empty for all domains. Example: jy7zpl9xqo4l5vx6
- `limit` (`integer`, optional): Results per page, 10 to 100. Defaults to 25. Example: 25
- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1

Example input: `{}`

### `mailersend_message_get`

Get Message · Read-only

Retrieve one message with the emails it produced and their statuses.
Returns data with id, emails (id, from, subject, status, recipient, tags) and domain.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `message_id` (`string`, required): Message ID (the X-Message-Id from a send) Example: 5e42957d51f1d94a1070a733

Example input: `{"message_id":"<message_id>"}`

### `mailersend_messages_list`

List Messages · Read-only

List sent messages (one per send request, which can hold several emails).
Returns data, an array with id, created_at and updated_at, plus meta for paging. Use mailersend_message_get for its emails.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `domain_id` (`string`, optional): Domain ID (from mailersend_domains_list); leave empty for all domains. Example: jy7zpl9xqo4l5vx6
- `limit` (`integer`, optional): Results per page, 10 to 100. Defaults to 25. Example: 25
- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1

Example input: `{}`

### `mailersend_recipient_get`

Get Recipient · Read-only

Retrieve one recipient with its domain and suppression state.
Returns data with id, email, created_at, domain, emails, blocklist, hard_bounces, spam_complaints and unsubscribes.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `recipient_id` (`string`, required): Recipient ID. Example: 5ee0b174b251345e407c92dc

Example input: `{"recipient_id":"<recipient_id>"}`

### `mailersend_recipients_list`

List Recipients · Read-only

List recipients that have received email, optionally for one domain.
Returns data, an array with id, email, created_at, updated_at and deleted_at, plus meta.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `domain_id` (`string`, optional): Domain ID (from mailersend_domains_list); leave empty for all domains. Example: jy7zpl9xqo4l5vx6
- `limit` (`integer`, optional): Results per page, 10 to 100. Defaults to 25. Example: 25
- `page` (`integer`, optional): Page number, 1 to 1000. Example: 1

Example input: `{}`

### `mailersend_scheduled_message_get`

Get Scheduled Message · Read-only

Retrieve one scheduled message.
Returns data with message_id, subject, send_at, status, status_message and domain.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `message_id` (`string`, required): Message ID of the scheduled send. Example: 61e01c4a2e4b0e6a9f8d4f55

Example input: `{"message_id":"<message_id>"}`

### `mailersend_scheduled_messages_list`

List Scheduled Messages · Read-only

List messages scheduled with send_at.
Returns data, an array with message_id, subject, send_at, status (scheduled, sent, error) and status_message, plus meta.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `domain_id` (`string`, optional): Domain ID (from mailersend_domains_list); leave empty for all domains. Example: jy7zpl9xqo4l5vx6
- `limit` (`integer`, optional): Results per page, 10 to 100. Defaults to 25. Example: 25
- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1
- `status` (`string`, optional): Only scheduled messages with this status. Example: scheduled. One of: `scheduled`, `sent`, `error`.

Example input: `{}`

### `mailersend_sms_activity_list`

List SMS Activity · Read-only

List SMS delivery events (processed, queued, sent, delivered, failed), optionally by number, date range or status.
Returns data, an array with from, to, created_at, content, status and sms_message_id, plus meta.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `date_from` (`string`, optional): Start of the range: a Unix timestamp, ISO 8601 (2026-11-01T00:00:00Z) or 'YYYY-MM-DD HH:MM:SS', in UTC. Example: 2026-11-01T00:00:00Z
- `date_to` (`string`, optional): End of the range, in the same formats as date_from; must be later than date_from. Example: 2026-11-13T23:59:59Z
- `limit` (`integer`, optional): Results per page, 10 to 100. Defaults to 25. Example: 25
- `page` (`integer`, optional): Page number, 1 to 1000. Example: 1
- `sms_number_id` (`string`, optional): Only activity for this phone number ID. Example: 7z3m5jgrogdpyo6n
- `status` (`array`, optional): Only these statuses. Example: ["delivered", "failed"]

Example input: `{}`

### `mailersend_sms_message_get`

Get SMS Message · Read-only

Retrieve one SMS message with its per-recipient deliveries.
Returns data with id, from, to, text, paused, created_at and sms (each with status and segment count).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `sms_message_id` (`string`, required): SMS message ID. Example: 7z3m5jgrogdpyo6n

Example input: `{"sms_message_id":"<sms_message_id>"}`

### `mailersend_sms_messages_list`

List SMS Messages · Read-only

List sent SMS messages.
Returns data, an array with id, from, to, text, paused and created_at, plus meta.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Results per page, 10 to 100. Defaults to 25. Example: 25
- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1

Example input: `{}`

### `mailersend_sms_numbers_list`

List SMS Phone Numbers · Read-only

List the SMS phone numbers on the account.
Returns data, an array with id, telephone_number, paused and created_at, plus meta.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Results per page, 10 to 100. Defaults to 15. Example: 15
- `page` (`integer`, optional): Page number. Example: 1
- `paused` (`boolean`, optional): Only paused (true) or active (false) numbers. Example: false

Example input: `{}`

### `mailersend_suppressions_list`

List Suppressions · Read-only

List entries on one suppression list: blocklist, hard bounces, spam complaints, unsubscribes or the on-hold list.
Returns data, an array of entries (id, recipient or pattern, created_at, and the reason or domain), plus meta for paging.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `list` (`string`, required): Suppression list to read. Example: hard-bounces. One of: `blocklist`, `hard-bounces`, `spam-complaints`, `unsubscribes`, `on-hold-list`.
- `domain_id` (`string`, optional): Domain ID (from mailersend_domains_list); leave empty for all domains. Example: jy7zpl9xqo4l5vx6
- `limit` (`integer`, optional): Results per page, 10 to 100. Defaults to 25. Example: 25
- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1

Example input: `{"list":"blocklist"}`

### `mailersend_template_get`

Get Template · Read-only

Retrieve one template with its stats and tags.
Returns data with id, name, type, image_path, personalization variables, template_stats (total, delivered, opened, clicked) and tags.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `template_id` (`string`, required): Template ID. Example: vywj2lpokkm47oqz

Example input: `{"template_id":"<template_id>"}`

### `mailersend_templates_list`

List Templates · Read-only

List email templates, optionally for one domain.
Returns data, an array with id, name, type, image_path and created_at, plus meta for paging.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `domain_id` (`string`, optional): Domain ID (from mailersend_domains_list); leave empty for all domains. Example: jy7zpl9xqo4l5vx6
- `limit` (`integer`, optional): Results per page, 10 to 100. Defaults to 25. Example: 25
- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1

Example input: `{}`

### `mailersend_webhook_get`

Get Webhook · Read-only

Retrieve one webhook.
Returns data with id, url, events, name, enabled, version, secret (for signature checks) and domain.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `webhook_id` (`string`, required): Webhook ID. Example: 2351ndgwr4zqx8ko

Example input: `{"webhook_id":"<webhook_id>"}`

### `mailersend_webhooks_list`

List Webhooks · Read-only

List the webhooks of a domain.
Returns data, an array with id, url, events, name, enabled, version, editable and created_at.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `domain_id` (`string`, required): Domain ID (from mailersend_domains_list) Example: jy7zpl9xqo4l5vx6
- `limit` (`integer`, optional): Results per page, 10 to 100. Defaults to 25. Example: 25
- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1

Example input: `{"domain_id":"<domain_id>"}`

### `mailersend_blocklist_add`

Add to Blocklist · Write

Block sending to specific addresses or to addresses matching patterns.
Returns data, the created blocklist entries with id, type (exact or pattern), pattern and created_at.
Use mailersend_suppressions_add for hard bounces, spam complaints or unsubscribes.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `domain_id` (`string`, optional): Domain ID; leave empty to block for every domain. Example: jy7zpl9xqo4l5vx6
- `patterns` (`array`, optional): Patterns to block, such as *@example.com. Required unless recipients is set. Example: ["*@spam-domain.example"]
- `recipients` (`array`, optional): Email addresses to block. Required unless patterns is set. Example: ["spammer@example.com"]

Example input: `{}`

### `mailersend_bulk_email_send`

Send Bulk Email · Write

Queue up to 500 separate email messages in one asynchronous request.
Returns bulk_email_id and a message; check delivery with mailersend_bulk_email_status_get.
Use this for many different messages. Use mailersend_email_send for one message.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `messages` (`array`, required): Email objects, each with the same fields as a single send: from (email, name), to (email, name), subject, html or text or template_id, and optional personalization, tags, attachments and settings. Example: [{"from": {"email": "orders@example.com"}, "to": [{"email": "jane@example.com"}], "subject": "Hi", "text": "Hello"}]

Example input: `{"messages":[]}`

### `mailersend_domain_add`

Add Domain · Write

Add a sending domain to the account.
Returns data with the new domain's id and settings. Next publish its records (mailersend_domain_dns_records_get) and call mailersend_domain_verify.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Domain name, lowercase, not starting with www. Example: mail.example.com
- `custom_tracking_subdomain` (`string`, optional): Alphanumeric custom tracking subdomain. Example: links
- `inbound_routing_subdomain` (`string`, optional): Alphanumeric inbound routing subdomain. Example: inbound
- `return_path_subdomain` (`string`, optional): Alphanumeric return-path subdomain. Example: mta

Example input: `{"name":"<name>"}`

### `mailersend_domain_settings_update`

Update Domain Settings · Write

Change a domain's sending and tracking settings (pause sending, click/open/content/unsubscribe tracking, custom tracking, precedence bulk).
Returns data with the domain and its updated domain_settings.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `domain_id` (`string`, required): Domain ID. Example: jy7zpl9xqo4l5vx6
- `custom_tracking_enabled` (`boolean`, optional): Use the custom tracking subdomain. Example: false
- `custom_tracking_subdomain` (`string`, optional): Alphanumeric custom tracking subdomain. Example: links
- `ignore_duplicated_recipients` (`boolean`, optional): Drop duplicate recipients in one send. Example: false
- `precedence_bulk` (`boolean`, optional): Add the Precedence: bulk header. Example: false
- `send_paused` (`boolean`, optional): Pause all sending from the domain. Example: false
- `track_clicks` (`boolean`, optional): Track clicks. Example: true
- `track_content` (`boolean`, optional): Keep email content viewable in the dashboard. Example: true
- `track_opens` (`boolean`, optional): Track opens. Example: true
- `track_unsubscribe` (`boolean`, optional): Add an unsubscribe link and track unsubscribes. Example: true
- `track_unsubscribe_html` (`string`, optional): HTML unsubscribe footer; must contain {{unsubscribe}}. Example: Click [here]({{unsubscribe}}) to unsubscribe.

- `track_unsubscribe_html_enabled` (`boolean`, optional): Use the HTML unsubscribe footer. Example: true
- `track_unsubscribe_plain` (`string`, optional): Plain-text unsubscribe footer; must contain {{unsubscribe}}. Example: Unsubscribe: {{unsubscribe}}
- `track_unsubscribe_plain_enabled` (`boolean`, optional): Use the plain-text unsubscribe footer. Example: true

Example input: `{"domain_id":"<domain_id>"}`

### `mailersend_domain_verify`

Verify Domain · Write

Check a domain's DNS records now and update its verification status.
Returns message and data with dkim, spf, mx, tracking, cname and rp_cname booleans.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `domain_id` (`string`, required): Domain ID. Example: jy7zpl9xqo4l5vx6

Example input: `{"domain_id":"<domain_id>"}`

### `mailersend_email_send`

Send Email · Write

Send one email with inline HTML or text, or a MailerSend template, to up to 50 recipients.
Returns 202 Accepted with no body; the message ID is in the X-Message-Id response header (send_at sends return it as well).
Use this for a single message. Use mailersend_bulk_email_send for many different messages in one call.
Prerequisite: from_email must be on a verified domain (see mailersend_domains_list).

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `to` (`array`, required): Recipients, 1 to 50 (1 until the account is approved), each an object with email and an optional name. Example: [{"email": "jane@example.com", "name": "Jane Doe"}]
- `attachments` (`array`, optional): Attachments (25 MB total after decoding), each with filename, content (base64), and optional disposition (attachment or inline) and id (Content-ID for inline images) Example: [{"filename": "invoice.pdf", "content": "JVBERi0xLjQK", "disposition": "attachment"}]
- `bcc` (`array`, optional): BCC recipients (max 10), each with email and optional name. Example: [{"email": "audit@example.com"}]
- `cc` (`array`, optional): CC recipients (max 10), each with email and optional name. Example: [{"email": "boss@example.com"}]
- `from_email` (`string`, optional): Sender email address on a verified domain. Not required when template_id has a default sender. Example: orders@example.com
- `from_name` (`string`, optional): Sender display name (no < or >) Example: Acme Orders
- `headers` (`array`, optional): Custom headers (Professional and Enterprise plans), each with name and value. Example: [{"name": "X-Order-ID", "value": "A1001"}]
- `html` (`string`, optional): HTML body (max 2 MB). Provide html, text or template_id. Example: Hi {{name}}, your order shipped.

- `in_reply_to` (`string`, optional): Message-ID this email replies to (for threading) Example: <abc123@mail.example.com>
- `language` (`string`, optional): Language for template translations and unsubscribe text. Example: en. One of: `de`, `en`, `es`, `fr`, `it`, `lt`, `nl`, `pl`, `pt-BR`.
- `list_unsubscribe` (`string`, optional): List-Unsubscribe header value, RFC 8058 compliant (Professional and Enterprise plans) Example: <mailto:unsubscribe@example.com>
- `personalization` (`array`, optional): Per-recipient {{var}} data. Each item has email (one of the to addresses) and data (an object of variable names to values) Example: [{"email": "jane@example.com", "data": {"name": "Jane", "order_id": "A1001"}}]
- `precedence_bulk` (`boolean`, optional): Set the Precedence: bulk header, overriding the domain setting. Example: false
- `references` (`array`, optional): Message-IDs this email references (for threading) Example: ["<abc123@mail.example.com>"]
- `reply_to_email` (`string`, optional): Reply-To address. Example: help@example.com
- `reply_to_name` (`string`, optional): Reply-To display name. Example: Acme Support
- `send_at` (`integer`, optional): Schedule the send for this Unix timestamp, at most 72 hours ahead. Leave empty to send now. Example: 1794700800
- `subject` (`string`, optional): Subject line (max 998 characters). Not required when template_id has a default subject. Supports {{var}} personalization. Example: Your order {{order_id}} has shipped
- `tags` (`array`, optional): Up to 5 tags for analytics. Example: ["order-shipped"]
- `template_id` (`string`, optional): ID of a MailerSend template to use as the content (see mailersend_templates_list) Example: vywj2lpokkm47oqz
- `text` (`string`, optional): Plain-text body (max 2 MB). Provide html, text or template_id. Example: Hi {{name}}, your order shipped.
- `track_clicks` (`boolean`, optional): Track clicks for this email, overriding the domain setting. Example: true
- `track_content` (`boolean`, optional): Keep the email content viewable in the dashboard, overriding the domain setting. Example: true
- `track_opens` (`boolean`, optional): Track opens for this email, overriding the domain setting. Example: true

Example input: `{"to":[{"email":"jane@example.com","name":"Jane Doe"}]}`

### `mailersend_email_verify`

Verify Email Address · Write

Check whether one email address is deliverable. Uses one email verification credit.
Returns status, one of valid, catch_all, mailbox_full, role_based, unknown, syntax_error, typo, mailbox_not_found, disposable or mailbox_blocked.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `email` (`string`, required): Address to verify (max 320 characters) Example: jane@example.com

Example input: `{"email":"<email>"}`

### `mailersend_identity_create`

Create Sender Identity · Write

Add a sender identity on a domain. MailerSend emails the address a verification link.
Returns data with the identity's id, email and is_verified (false until the link is clicked).

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `domain_id` (`string`, required): Domain ID the address belongs to. Example: jy7zpl9xqo4l5vx6
- `email` (`string`, required): Sender address (max 320 characters, unique per domain) Example: orders@example.com
- `add_note` (`boolean`, optional): Add personal_note to the verification email. Example: false
- `name` (`string`, optional): Sender display name. Example: Acme Orders
- `personal_note` (`string`, optional): Note for the verification email (max 250 characters, no links or addresses) Example: Please confirm so we can send order emails
- `reply_to_email` (`string`, optional): Default Reply-To address. Required when reply_to_name is set. Example: help@example.com
- `reply_to_name` (`string`, optional): Default Reply-To name. Example: Acme Support

Example input: `{"domain_id":"<domain_id>","email":"<email>"}`

### `mailersend_identity_update`

Update Sender Identity · Write

Change a sender identity's name or default Reply-To.
Returns data with the updated identity.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `identity_id` (`string`, required): Sender identity ID. Example: 7z3m5jgrogdpyo6n
- `add_note` (`boolean`, optional): Add personal_note to the verification email. Example: false
- `name` (`string`, optional): Sender display name. Example: Acme Orders
- `personal_note` (`string`, optional): Note for the verification email. Example: Please confirm
- `reply_to_email` (`string`, optional): Default Reply-To address. Required when reply_to_name is set. Example: help@example.com
- `reply_to_name` (`string`, optional): Default Reply-To name. Example: Acme Support

Example input: `{"identity_id":"<identity_id>"}`

### `mailersend_inbound_route_create`

Create Inbound Route · Write

Create an inbound route that receives email for a domain and forwards it to email addresses or webhook URLs.
Returns data with the route's id and address (the address that receives mail).

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `domain_enabled` (`boolean`, required): true to receive mail at a custom inbound address on your domain (inbound_domain); false to use the generated MailerSend inbound address. Example: false
- `domain_id` (`string`, required): Domain ID the route belongs to. Example: jy7zpl9xqo4l5vx6
- `forwards` (`array`, required): Where to forward each message (1-5), each with type (email or webhook) and value (an address or URL) Example: [{"type": "webhook", "value": "https://example.com/inbound"}]
- `match_filter` (`object`, required): Which senders to accept: type match_all, match_sender, match_domain or match_header, and for the latter three up to 5 filters with comparer, value and (for headers) key. Example: {"type": "match_all"}
- `name` (`string`, required): Route name (max 191 characters) Example: Support inbox
- `catch_filter` (`object`, optional): Which recipients to catch (required when domain_enabled is true): type catch_all or catch_recipient, and for catch_recipient up to 5 filters, each with a comparer (equal, contains, starts-with, ...) and a value. Example: {"type": "catch_recipient", "filters": [{"comparer": "equal", "value": "support"}]}
- `catch_type` (`string`, optional): For catch_recipient filters: all filters must match (all) or any one (one). Defaults to all. Example: all. One of: `all`, `one`.
- `inbound_domain` (`string`, optional): Custom inbound address domain, ending with your domain name. Required when domain_enabled is true. Example: inbound.example.com
- `inbound_priority` (`integer`, optional): Route priority 0-100 (0 runs first), unique per domain. Required when domain_enabled is true. Example: 10
- `include_attachments` (`boolean`, optional): Forward attachments. Defaults to true. Example: true
- `match_type` (`string`, optional): For match filters: all filters must match (all) or any one (one). Defaults to all. Example: all. One of: `all`, `one`.

Example input: `{"domain_enabled":true,"domain_id":"<domain_id>","forwards":[{"type":"webhook","value":"https://example.com/inbound"}],"match_filter":{"type":"match_all"},"name":"<name>"}`

### `mailersend_inbound_route_update`

Update Inbound Route · Write

Replace an inbound route's settings. Omitted catch_type and match_type reset to all.
Returns data with the updated route.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `domain_enabled` (`boolean`, required): true to receive mail at a custom inbound address on your domain (inbound_domain); false to use the generated MailerSend inbound address. Example: false
- `forwards` (`array`, required): Where to forward each message (1-5), each with type (email or webhook) and value (an address or URL) Example: [{"type": "webhook", "value": "https://example.com/inbound"}]
- `inbound_id` (`string`, required): Inbound route ID. Example: vy3j2l1xz8mm97yo
- `match_filter` (`object`, required): Which senders to accept: type match_all, match_sender, match_domain or match_header, and for the latter three up to 5 filters with comparer, value and (for headers) key. Example: {"type": "match_all"}
- `name` (`string`, required): Route name (max 191 characters) Example: Support inbox
- `catch_filter` (`object`, optional): Which recipients to catch (required when domain_enabled is true): type catch_all or catch_recipient, and for catch_recipient up to 5 filters, each with a comparer (equal, contains, starts-with, ...) and a value. Example: {"type": "catch_recipient", "filters": [{"comparer": "equal", "value": "support"}]}
- `catch_type` (`string`, optional): For catch_recipient filters: all filters must match (all) or any one (one). Defaults to all. Example: all. One of: `all`, `one`.
- `inbound_domain` (`string`, optional): Custom inbound address domain, ending with your domain name. Required when domain_enabled is true. Example: inbound.example.com
- `inbound_priority` (`integer`, optional): Route priority 0-100 (0 runs first), unique per domain. Required when domain_enabled is true. Example: 10
- `include_attachments` (`boolean`, optional): Forward attachments. Defaults to true. Example: true
- `match_type` (`string`, optional): For match filters: all filters must match (all) or any one (one). Defaults to all. Example: all. One of: `all`, `one`.

Example input: `{"domain_enabled":true,"forwards":[{"type":"webhook","value":"https://example.com/inbound"}],"inbound_id":"<inbound_id>","match_filter":{"type":"match_all"},"name":"<name>"}`

### `mailersend_sms_send`

Send SMS · Write

Send an SMS from one of your MailerSend phone numbers to up to 50 US or Canadian numbers.
Returns 202 Accepted; the SMS message ID is in the X-SMS-Message-Id response header.
Prerequisite: an SMS phone number on the account (see mailersend_sms_numbers_list).

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `from` (`string`, required): Your MailerSend phone number, E.164. Example: +18332647501
- `text` (`string`, required): Message text (max 2048 characters; ( ) [ ] < > not allowed). Supports {{ var }} personalization. Longer than 160 GSM-7 characters is sent as several segments. Example: Hi {{ name }}, your code is 123456
- `to` (`array`, required): Recipient numbers in E.164 (1-50, US or CA, no duplicates). With a trial number each must be a verified recipient. Example: ["+12065550123"]
- `personalization` (`array`, optional): Per-number data for {{ var }}: each item has phone_number (one of to) and data (an object) Example: [{"phone_number": "+12065550123", "data": {"name": "Jane"}}]

Example input: `{"from":"<from>","text":"<text>","to":["+12065550123"]}`

### `mailersend_suppressions_add`

Add Suppressions · Write

Add addresses to the hard-bounce, spam-complaint or unsubscribe list for a domain, so MailerSend stops sending to them.
Returns data, the created entries with id, recipient and created_at.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `domain_id` (`string`, required): Domain ID the suppression applies to. Example: jy7zpl9xqo4l5vx6
- `list` (`string`, required): Suppression list to add to. Example: unsubscribes. One of: `hard-bounces`, `spam-complaints`, `unsubscribes`.
- `recipients` (`array`, required): Email addresses to add. Example: ["jane@example.com"]

Example input: `{"domain_id":"<domain_id>","list":"hard-bounces","recipients":["jane@example.com"]}`

### `mailersend_template_create`

Create Template · Write

Create an HTML template.
Returns data with the new template's id and name. Send with mailersend_email_send template_id.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `html` (`string`, required): HTML body (max 2 MB). Supports {{var}} personalization. Example: Hi {{name}}, your order {{order_id}} shipped.

- `text` (`string`, required): Plain-text body (max 2 MB) Example: Hi {{name}}, your order {{order_id}} shipped.
- `categories` (`array`, optional): Category IDs to assign. Example: ["z86org8wkd4ew13v"]
- `domain_id` (`string`, optional): Domain ID to attach the template to. Example: jy7zpl9xqo4l5vx6
- `name` (`string`, optional): Template name (max 50). Defaults to Template. Example: Order shipped
- `tags` (`array`, optional): Up to 5 tags. Example: ["orders"]

Example input: `{"html":"<html>","text":"<text>"}`

### `mailersend_template_update`

Update Template · Write

Change a template's HTML, text, name, domain, categories or tags.
Returns data with the updated template.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `template_id` (`string`, required): Template ID. Example: vywj2lpokkm47oqz
- `auto_generate` (`boolean`, optional): Generate the text version from the HTML. Example: true
- `categories` (`array`, optional): Category IDs; an empty array removes all. Example: ["z86org8wkd4ew13v"]
- `domain_id` (`string`, optional): Domain ID to attach the template to. Example: jy7zpl9xqo4l5vx6
- `html` (`string`, optional): New HTML body. Example: Hi {{name}}

- `name` (`string`, optional): New name (max 50) Example: Order shipped v2
- `tags` (`array`, optional): Up to 5 tags. Example: ["orders"]
- `text` (`string`, optional): New plain-text body. Example: Hi {{name}}

Example input: `{"template_id":"<template_id>"}`

### `mailersend_webhook_create`

Create Webhook · Write

Create a webhook that receives email events for a domain.
Returns data with the webhook's id, url, events, enabled, version and signing secret.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `domain_id` (`string`, required): Domain ID the webhook belongs to. Example: jy7zpl9xqo4l5vx6
- `events` (`array`, required): Event types to send. Example: ["activity.delivered", "activity.hard_bounced"]
- `name` (`string`, required): Webhook name (max 50) Example: Delivery events
- `url` (`string`, required): Public HTTPS URL that receives events (max 191, unique) Example: https://example.com/mailersend/webhook
- `enabled` (`boolean`, optional): Turn the webhook on. Defaults to true. Example: true
- `version` (`integer`, optional): Payload version: 2 (recommended) or 1 (deprecated, stops December 1, 2026). Defaults to 1. Example: 2. One of: `1`, `2`.

Example input: `{"domain_id":"<domain_id>","events":["activity.delivered","activity.hard_bounced"],"name":"<name>","url":"<url>"}`

### `mailersend_webhook_update`

Update Webhook · Write

Change a webhook's URL, name, events, status or payload version.
Returns data with the updated webhook.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `webhook_id` (`string`, required): Webhook ID. Example: 2351ndgwr4zqx8ko
- `enabled` (`boolean`, optional): Turn the webhook on or off. Example: false
- `events` (`array`, optional): Event types to send. Example: ["activity.delivered"]
- `name` (`string`, optional): New name. Example: Delivery events
- `url` (`string`, optional): New URL. Example: https://example.com/mailersend/webhook
- `version` (`integer`, optional): Payload version (2 cannot go back to 1) Example: 2. One of: `1`, `2`.

Example input: `{"webhook_id":"<webhook_id>"}`

### `mailersend_domain_delete`

Delete Domain · Destructive

Delete a sending domain.
Returns no content (204).

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `domain_id` (`string`, required): Domain ID. Example: jy7zpl9xqo4l5vx6

Example input: `{"domain_id":"<domain_id>"}`

### `mailersend_identity_delete`

Delete Sender Identity · Destructive

Delete a sender identity.
Returns no content (204).

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `identity_id` (`string`, required): Sender identity ID. Example: 7z3m5jgrogdpyo6n

Example input: `{"identity_id":"<identity_id>"}`

### `mailersend_inbound_route_delete`

Delete Inbound Route · Destructive

Delete an inbound route.
Returns no content (204).

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `inbound_id` (`string`, required): Inbound route ID. Example: vy3j2l1xz8mm97yo

Example input: `{"inbound_id":"<inbound_id>"}`

### `mailersend_recipient_delete`

Delete Recipient · Destructive

Delete a recipient record.
Returns no content (204).

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `recipient_id` (`string`, required): Recipient ID. Example: 5ee0b174b251345e407c92dc

Example input: `{"recipient_id":"<recipient_id>"}`

### `mailersend_scheduled_message_delete`

Cancel Scheduled Message · Destructive

Cancel a scheduled message, up to 10 minutes before its send time.
Returns no content (204).

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `message_id` (`string`, required): Message ID of the scheduled send. Example: 61e01c4a2e4b0e6a9f8d4f55

Example input: `{"message_id":"<message_id>"}`

### `mailersend_suppressions_delete`

Delete Suppressions · Destructive

Remove entries from a suppression list by ID, or clear the whole list.
Returns no content (204).

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `list` (`string`, required): Suppression list to delete from. Example: unsubscribes. One of: `blocklist`, `hard-bounces`, `spam-complaints`, `unsubscribes`, `on-hold-list`.
- `all` (`boolean`, optional): true removes every entry on the list. Required unless ids is set. Example: false
- `domain_id` (`string`, optional): Domain ID; required with all to clear one domain's list. Example: jy7zpl9xqo4l5vx6
- `ids` (`array`, optional): Entry IDs to remove. Required unless all is true. Example: ["5e42957d51f1d94a1070a733"]

Example input: `{"list":"blocklist"}`

### `mailersend_template_delete`

Delete Template · Destructive

Delete a template.
Returns no content (204).

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `template_id` (`string`, required): Template ID. Example: vywj2lpokkm47oqz

Example input: `{"template_id":"<template_id>"}`

### `mailersend_webhook_delete`

Delete Webhook · Destructive

Delete a webhook.
Returns no content (204).

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `webhook_id` (`string`, required): Webhook ID. Example: 2351ndgwr4zqx8ko

Example input: `{"webhook_id":"<webhook_id>"}`

## Related

Other Communication connectors ([all 132](/agentkit/connectors/?category=communication)):

- [Gmail](/agentkit/connectors/gmail/): Scalekit connector, OAuth, 48 tools
- [Slack](/agentkit/connectors/slack/): Scalekit connector, OAuth, 96 tools
- [Google Calendar](/agentkit/connectors/googlecalendar/): Scalekit connector, OAuth, 30 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
