---
title: "corestack_email_send_test"
url: https://docs.corefinity.com/mcp/tools/corestack_email_send_test
type: tool
last_updated: 2026-11-13
feature: email
related:
  - https://docs.corefinity.com/api/reference/site-settings/send-site-email-test.md
  - https://docs.corefinity.com/guides/sites/site-settings/outbound-email.md
---
# corestack_email_send_test

**Send a test email.** Send a test email from a row through its sending domain (a preview row's lands in Mailpit). One at a time, twenty a day per site. Scope: write. Long-running: answers with a task.

- Scope: `write`
- Runs as a task: yes

## When to use it

Send a test email from a row through its sending domain (a preview row's lands in Mailpit). One at a time, twenty a day per site.

The test is sent the way PHP mail is. On a preview row it is held in Mailpit (the command's `result.message` says so), even on a WordPress site whose platform plugins are turned off; there, unlike the test, an SMTP plugin's own mail is not caught (corestack_email_get's `mailpit.note`).

## Inputs

- `site_id` (integer, ≥ 1, required)
- `to` (string, up to 254 characters, required): The address to send the test email to.
- `sending_domain` (string, up to 253 characters): The default when omitted.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "sending_domain": {
      "description": "The default when omitted.",
      "maxLength": 253,
      "type": "string"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    },
    "to": {
      "description": "The address to send the test email to.",
      "maxLength": 254,
      "type": "string"
    }
  },
  "required": [
    "site_id",
    "to"
  ],
  "type": "object"
}
```

## Refusals

- `command_running`: a command is still running on the row; wait for it to finish.
- `state`: the object is not in a state this applies to; read it again. An extra sending domain can be tested once it is verified and the site sends through it.
- `managed_elsewhere` (message: "This site is managed by another control panel"): another control panel manages this site, so use that control panel for it. This is refused before anything else about the site, as in the Control Panel and the API. Nothing was done.
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_email_send_test",
  "arguments": {
    "site_id": 4211,
    "to": "ops@example.co.uk"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_email_send_test with site_id 4211, to ops@example.co.uk. (Send a test email.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [POST /api/corestack/sites/{site}/email/test](https://docs.corefinity.com/api/reference/site-settings/send-site-email-test.md)
- Guide: [Outbound email](https://docs.corefinity.com/guides/sites/site-settings/outbound-email.md)
