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

**Make a sending domain the default.** Make a verified sending domain the default, carrying mail no other domain matches. No new credentials; applies within a minute. Scope: write.

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

## When to use it

Make a verified sending domain the default, carrying mail no other domain matches. No new credentials; applies within a minute.

The default is also the one removed last: to remove the current default, make another domain the default first.

## Inputs

- `site_id` (integer, ≥ 1, required)
- `sending_domain` (string, up to 253 characters, required): From corestack_email_get domains[].

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "sending_domain": {
      "description": "From corestack_email_get domains[].",
      "maxLength": 253,
      "type": "string"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id",
    "sending_domain"
  ],
  "type": "object"
}
```

## Refusals

- `state`: only a verified sending domain the site already sends through can be the default, and it must not be the default already. Also when an earlier change to the site's mail login did not finish: retry that change first.
- `busy`: another email change is running on the row; try again in a minute.
- `upstream_unavailable`: the site's mail settings could not be saved; retry.
- `unavailable`: email sending is set up on the production row only (staging and development rows send to a test inbox); use the production row.
- `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_make_default",
  "arguments": {
    "site_id": 4211,
    "sending_domain": "mg.example.org"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_email_make_default with site_id 4211, sending_domain mg.example.org. (Make a sending domain the default.) Tell me what it returned.
```

## The same task elsewhere

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