File Format - Outreach Email
Outreach Email File Format
The Outreach Email file allows integrators to send raw email messages through Tulip’s Outreach system. Each row in the CSV represents a single email message to be sent.
The first line of an Outreach Email CSV file must be the header row. Each subsequent row creates a separate outreach job.
File Prefix: TOE
Feature Gate: The environment must have outreach-plus enabled; otherwise, the file will fail to upload any records successfully.
Spec
The following table shows the accepted CSV columns for the Outreach Email entity.
| CSV Header | Data Type | Required | Description |
|---|---|---|---|
Subject | string | Yes | Email subject line |
Content | string | Yes | Email body (HTML or plain text — auto-detected) |
To | string | Yes | Recipient email address |
From | string | Yes | Sender email address |
From Name | string | No | Sender display name |
Employee ID | string | Yes | Internal or External ID of the sending employee |
Customer ID | string | Yes | Internal or External ID of the recipient customer |
Store ID | string | Yes | ID of the associated store |
Campaign ID | string | No | Links the dispatch to a campaign |
Expiry Date | string | No | Expiration time in UTC ISO 8601 format (YYYY-MM-DDTHH:mm:ssZ). If the message has not been dispatched by this date, it will be marked as Expired. |
Start Date | string | No | Scheduled send time in UTC ISO 8601 format (YYYY-MM-DDTHH:mm:ssZ). If in the future, the message is held until this time. |
Important Notes
- All dates must be in UTC ISO 8601 format (
YYYY-MM-DDTHH:mm:ssZ). - Each CSV row creates a separate outreach job.
- Success/failure can be monitored in Admin Console under Outreach Jobs.
- A successfully processed row means the job has been accepted for sending. It does not guarantee delivery.
Outreach Email CSV Example
See the following Outreach Email CSV sample file.