Documentation version: 2026-11-16.2
Canonical: https://docs.creator.gg/tools/email_campaigns_preflight.md

# email_campaigns_preflight

Check a draft email campaign, sender, selected audience and optional A/B test without saving, sending or scheduling. Subject tests use two to four subjects; content tests use distinct existing HTML/plain-text templates from this workspace. Returns an unsaved plan, not provider acceptance, a spam check or real inbox preview. A later send/schedule can automatically deliver the winning variant to the rest of the audience.

## Execution

Call this MCP tool at https://mcp.creator.gg/mcp. The connection selects the workspace. A tool name is not a REST route.

Effect: reads data or returns an account-screen link.

## Behavior and limits

Uses current reads and returns an unsaved plan. No requestId, operation claim, provider POST, test email or schedule is created. Sender, draft, audience and content-template checks repeat on a later send/schedule. This is not a spam score, domain readiness check, real inbox preview or a saved native A/B draft. Read guides/email-experiments.

## Example arguments

Examples illustrate the schema. Replace placeholder IDs with workspace IDs and recalculate dates. For mutations, use a new requestId for each new action and retain it for identical retries.

```json
{
  "campaignId": "campaign_example",
  "recipients": {
    "type": "tag",
    "tagIds": [
      "tag_example"
    ]
  },
  "emailMeta": {
    "subject": "A useful first step"
  },
  "abTest": {
    "testType": "subjectLine",
    "testDuration": 3600,
    "testSize": 30,
    "winningCriteria": "openRate",
    "variations": [
      {
        "subject": "Your first useful step"
      },
      {
        "subject": "Make your next step simpler"
      }
    ]
  }
}
```

## Input schema

Generated from the executable tool contract. The behavior notes and related guide cover rules that JSON Schema cannot express.

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "recipients": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "contact"
            },
            "contactIds": {
              "minItems": 1,
              "maxItems": 100,
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 300,
                "pattern": "^[A-Za-z0-9_-]+$"
              }
            },
            "freezeList": {
              "default": true,
              "type": "boolean",
              "const": true
            }
          },
          "required": [
            "type",
            "contactIds"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "tag"
            },
            "tagIds": {
              "minItems": 1,
              "maxItems": 100,
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 300,
                "pattern": "^[A-Za-z0-9_-]+$"
              }
            },
            "freezeList": {
              "default": true,
              "type": "boolean",
              "const": true
            }
          },
          "required": [
            "type",
            "tagIds"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "segment"
            },
            "segment": {
              "type": "string",
              "enum": [
                "engaged_last_7_days",
                "engaged_last_30_days",
                "engaged_last_60_days",
                "engaged_last_5_campaigns",
                "unengaged_last_5_campaigns"
              ]
            },
            "freezeList": {
              "default": true,
              "type": "boolean",
              "const": true
            }
          },
          "required": [
            "type",
            "segment"
          ],
          "additionalProperties": false
        }
      ]
    },
    "emailMeta": {
      "type": "object",
      "properties": {
        "subject": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500
        },
        "fromName": {
          "description": "Optional override. Defaults to the authenticated user's profile name, falling back to the workspace name.",
          "type": "string",
          "minLength": 1,
          "maxLength": 500
        },
        "fromEmail": {
          "description": "Optional override. Defaults to the current email of the user who authorized this agent connection; workspace_status exposes defaultEmailSender. This does not verify sender/domain readiness.",
          "type": "string",
          "format": "email",
          "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
        },
        "replyToAddress": {
          "type": "string",
          "format": "email",
          "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
        },
        "previewText": {
          "type": "string",
          "maxLength": 500
        }
      },
      "required": [
        "subject"
      ],
      "additionalProperties": false
    },
    "timeZone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "abTest": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "testType": {
              "type": "string",
              "const": "subjectLine"
            },
            "testDuration": {
              "type": "integer",
              "minimum": 1,
              "maximum": 604800,
              "description": "Test duration in seconds, at most seven days. Picking a winner can automatically send to the remaining audience."
            },
            "testSize": {
              "type": "number",
              "minimum": 1,
              "maximum": 100,
              "description": "Percentage of the audience allocated to the test, split across its variations."
            },
            "winningCriteria": {
              "type": "string",
              "enum": [
                "openRate",
                "clickRate"
              ]
            },
            "variations": {
              "minItems": 2,
              "maxItems": 4,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "subject": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500,
                    "pattern": "^[^\\r\\n\\x00-\\x1f\\x7f]+$"
                  }
                },
                "required": [
                  "subject"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "testType",
            "testDuration",
            "testSize",
            "winningCriteria",
            "variations"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "testType": {
              "type": "string",
              "const": "emailContent"
            },
            "testDuration": {
              "type": "integer",
              "minimum": 1,
              "maximum": 604800,
              "description": "Test duration in seconds, at most seven days. Picking a winner can automatically send to the remaining audience."
            },
            "testSize": {
              "type": "number",
              "minimum": 1,
              "maximum": 100,
              "description": "Percentage of the audience allocated to the test, split across its variations."
            },
            "winningCriteria": {
              "type": "string",
              "enum": [
                "openRate",
                "clickRate"
              ]
            },
            "variations": {
              "minItems": 2,
              "maxItems": 4,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "templateId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 300,
                    "pattern": "^[A-Za-z0-9_-]+$"
                  },
                  "subject": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500,
                    "pattern": "^[^\\r\\n\\x00-\\x1f\\x7f]+$"
                  }
                },
                "required": [
                  "templateId"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "testType",
            "testDuration",
            "testSize",
            "winningCriteria",
            "variations"
          ],
          "additionalProperties": false
        }
      ]
    },
    "sendAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
    }
  },
  "required": [
    "campaignId",
    "recipients",
    "emailMeta"
  ],
  "additionalProperties": false
}
```

## Result interpretation

Inspect status, message and operation-specific data; list and record shapes vary. A completed read or accepted request does not prove delivery or publication. Reconcile unknown outcomes. HUMAN_ACTION_REQUIRED returns instructions without performing the action.

## Related guides

- [email-experiments](https://docs.creator.gg/guides/email-experiments.md)
- [Recovery](https://docs.creator.gg/guides/recovery.md)
- [Copywriting](https://docs.creator.gg/guides/copywriting.md)
- [Unsubscribe and content](https://docs.creator.gg/guides/email-content.md)
- [Readiness](https://docs.creator.gg/guides/readiness.md)
- [Email subscription preferences](https://docs.creator.gg/guides/email-preferences.md)
