email_recipients_upload

# email_recipients_upload

Upload a recipient CSV to one DRAFT or SCHEDULE email in the Email app (pApp F00003). Requires csv {emailHeader, encoding utf-8|euc-kr, headerRow}, and file {filename, base64, contentType text/csv} (.csv; bridge limit 10 MiB and 100,000 recipients, the console sets none). The file is relayed once to the mailer in memory and not kept; links are not accepted. A scheduled email needs CHANGE_SCHEDULED_EMAIL. Write; rows are never returned. 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 |
| --- | --- | --- |
| `emailId` | Yes | string; pattern `^[A-Za-z0-9_-]{1,200}$`; Exact email identifier returned by email_drafts_get. |
| `file` | Yes | object; Original recipient CSV (.csv as the console picker accepts; bridge limit 10 MiB and 100,000 recipients, the console sets none). Relayed once to the mailer and not kept. |
| `file.filename` | Yes | string; min length 1; max length 240; pattern `^[^/\\:\x00-\x1f\x7f]+$` |
| `file.base64` | Yes | string; min length 4; max length 13981016 |
| `file.contentType` | Yes | string; max length 120; pattern `^[a-z0-9][a-z0-9!#$&^_.+-]*\/[a-z0-9][a-z0-9!#$&^_.+-]*$`; Original MIME type (image/png, image/jpeg, text/csv). |
| `csv` | Yes | object |
| `csv.encoding` | No | `utf-8`, `euc-kr`; default `utf-8` |
| `csv.headerRow` | No | integer; minimum 1; maximum 100; default `1` |
| `csv.emailHeader` | Yes | string; min length 1; max length 200 |
| `confirmation` | No | `CHANGE_SCHEDULED_EMAIL`; Required for a SCHEDULE email, which keeps its send time with the new recipients. |
| `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. |