Engage Studio is Treasure AI's native email delivery service. With this export connector, you can trigger transactional email delivery in real time as part of a customer journey activation workflow.
The connector sends email transactions through the Engage Studio Delivery API, supporting personalized content via merge tags and dynamic templates.
- Basic knowledge of Treasure AI
- An email sender configured in Engage Studio. See Email Sender Configuration for details.
- An email template created in Engage Studio. See Engage Content Creation for details.
- A Treasure AI Master API Key
The primary use case for this integration is to incorporate it into a real-time activation workflow for triggered email delivery. Here is an overview of how to configure that workflow:
- In Engage Studio, create an email sender and configure your email domain.
- In Engage Studio, create an email template with optional merge tags for personalization.
- In the Treasure AI Console, create an authentication for this integration.
- In a Real-time Journey, select this authentication for a new triggered activation.
- The connector supports a global rate limit of 1,000 requests per second.
- The connector retries failed requests that return HTTP 500 status codes, up to 3 additional attempts.
- Requests that return HTTP 401 (Unauthorized) are not retried.
- Email sender and template must be pre-configured in Engage Studio before use.
If your security policy requires IP whitelisting, you must add Treasure Data's IP addresses to your allowlist to ensure a successful connection.
Please find the complete list of static IP addresses, organized by region, at the following document
- Open Treasure AI Console.
- Navigate to Integrations Hub > Catalog.
- Search for Treasure Engage V0 in the Catalog.
- Hover over the connector tile and select Create Authentication.
- Ensure the Credentials tab is selected, then enter your credentials.
| Parameter | Required | Description |
|---|---|---|
| Treasure AI Master API Key | Yes | Your Treasure AI Master API Key used to authorize email delivery requests to the Engage Studio Delivery API. |
- Select Continue.
- Enter a name for your connection.
- Select Done.
After creating the authentication, the Treasure Engage V0 Export connector is available for real-time customer journey activations.
To create or update a triggered activation:
- Open your Real-time Journey in Journey Orchestration.
- Select the triggered activation node.
- Enter a Triggered activation name and optional description.
- From the Authentication drop-down menu, select the Treasure Engage V0 authentication you created.
- Configure the integration parameters described below.
- Select Create or Update.
See Creating a Real-time Triggered Activation for additional information.
| Parameter | Required | Description |
|---|---|---|
| Sender Email | Yes | The ID of the email sender configured in Engage Studio. This determines the "From" address for the email. |
| Email Template | No | The ID of the email template (message) created in Engage Studio. When specified, the connector uses this template for the email body. |
| Campaign ID | No | An optional campaign identifier for tracking and reporting purposes. |
| To Address | Yes | The recipient's email address. |
| To Display Name | Yes | The display name shown to the recipient. |
| Values | Yes | A key-value map of merge tag values for email personalization. These values are substituted into the email template's merge tags (for example, {{ profile.first_name }}). |
- The connector retries requests when it receives HTTP 500 status codes.
- If the request succeeds before reaching the maximum retry count (3 retries), the activation log records a success.
- If the request still fails after all retries, the connector logs an error in the activation table.
- Requests that receive HTTP 401 (Unauthorized) are not retried. Verify that the Treasure AI Master API Key is correct if you see 401 errors.
- Activation results and errors are available in the client's activation table for monitoring and troubleshooting.