email_audience_apply

publ Reference
# email_audience_apply

Assign a recipient segment or decide-later (recipientType LATER) to one email in the Email app (pApp F00003). A scheduled email needs CHANGE_SCHEDULED_EMAIL. Write; does not send. A lost receipt stays pending and is never resent; task_resume only observes, and prepared work needs the identical apply. Called without confirmToken it previews and returns a confirmToken; repeating the same input with it executes once.

## Inputs

| Field | Required here | Contract |
| --- | --- | --- |
| `target` | Yes | one of: `SEGMENT`, `LATER` (by `recipientType`) |
| `target.emailId` | Yes | When `target.recipientType` is `SEGMENT`: string; pattern `^[A-Za-z0-9_-]{1,200}$`; Exact email identifier returned by email_drafts_get. |
| `target.segmentId` | Yes | When `target.recipientType` is `SEGMENT`: string; pattern `^[A-Za-z0-9_-]{1,200}$` |
| `target.emailId` | Yes | When `target.recipientType` is `LATER`: string; pattern `^[A-Za-z0-9_-]{1,200}$`; Exact email identifier returned by email_drafts_get. |
| `change` | Yes | object |
| `change.action` | Yes | `assign` |
| `change.confirmation` | No | `CHANGE_SCHEDULED_EMAIL` |
| `confirmToken` | No | string; pattern `^ct[a-f\d]{32}$`; The confirmToken from this tool's preview result. Omit it to preview; repeat the same input with it to execute. |