# Send Newsletter Test

Sends a newsletter’s published email as a test to one specified address, not its audience. An address not yet in the account becomes a tagged test contact and may start automations. Name the address and disclose that effect before calling. A never-published body is refused (publish it with publish-newsletter-email-content); edits made since publication are not sent (the test uses the older published body). For a split test, messageId selects the variant emailId.

## Input schema:

```json
{
  "type": "object",
  "properties": {
    "newsletterId": {
      "type": "integer",
      "description": "ID of the newsletter to send a test of",
      "minimum": 1
    },
    "recipientEmail": {
      "type": "string",
      "description": "Address to send the test to; any address, and one that is not a contact yet becomes one",
      "minLength": 3,
      "maxLength": 250
    },
    "messageId": {
      "type": [
        "null",
        "integer"
      ],
      "description": "For a split test: the emailId of the variant to test, as get-newsletter-split-test lists it; omit otherwise",
      "default": null,
      "minimum": 1
    },
    "accountId": {
      "type": [
        "null",
        "integer"
      ],
      "description": "User ID of the account; omit for the account the access token works in",
      "default": null,
      "minimum": 1
    }
  },
  "required": [
    "newsletterId",
    "recipientEmail"
  ],
  "additionalProperties": false
}
```

## Output schema:

```json
{
  "type": "object",
  "required": [
    "accountId",
    "newsletterId",
    "emailId",
    "recipient",
    "audienceReached",
    "newsletterStatus",
    "messages",
    "warnings"
  ],
  "properties": {
    "accountId": {
      "type": "integer"
    },
    "newsletterId": {
      "type": "integer"
    },
    "emailId": {
      "type": "integer"
    },
    "recipient": {
      "type": "string"
    },
    "audienceReached": {
      "type": "boolean"
    },
    "newsletterStatus": {
      "type": "string"
    },
    "messages": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}
```

