Sailthru
Sailthru (now Engage by Marigold) is a marketing automation platform that helps businesses deliver personalized customer experiences across email, mobile, and web channels. The platform combines a powerful recommendation engine with behavioral data collection to enable marketers to build targeted email campaigns, automate lifecycle messaging, and analyze customer engagement. Sailthru's API provides programmatic access to user data, email delivery, list management, campaign templates, and event tracking, enabling organizations to integrate Sailthru's marketing capabilities into their data pipelines and analytics workflows.
Power end-to-end data operations for your Sailthru API with Nexla. Our bi-directional Sailthru connector is purpose-built for Sailthru, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Sailthru or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Sailthru workflows fast, secure, and fully governed.
Features
Type: API
- Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
- Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
- API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
- Request optimization with intelligent batching, retry, and caching to minimize API calls and costs
Prerequisites
Before creating a Sailthru credential in Nexla, you must obtain your Sailthru API key and API secret from your Sailthru account settings. Sailthru uses a shared-secret hash authentication mechanism — each API request is signed using both the API key and secret, which uniquely identifies and authenticates your account.
Obtain Your Sailthru API Key and Secret
Sailthru API credentials are found in your account's API & Postbacks settings page. Administrator access to your Sailthru account is required to view these credentials.
-
Log in to your Sailthru account at my.sailthru.com.
-
Navigate to Settings in the top navigation bar.
-
Under the Setup section, select API & Postbacks.
-
On the API & Postbacks page, click the lock icon next to your credentials to reveal your API Key and Secret.
-
Copy both the API Key and the Secret and store them securely. Both values are required to authenticate API requests.
Your API secret is a sensitive credential. Do not share it publicly or commit it to version control. Nexla stores these credentials securely and uses them only for authenticated API calls on your behalf.
IP Allowlisting (Recommended)
Sailthru allows you to restrict API access to a specific set of IP addresses for additional security. If your organization requires IP-based access controls:
-
On the API & Postbacks settings page, locate the Allowed IPs field.
-
Enter the Nexla platform IP addresses that should be permitted to make API requests on your behalf.
Contact your Nexla account team for the list of Nexla egress IP addresses to add to the Sailthru allowlist. Restricting API access to known IPs helps prevent unauthorized use of your API credentials.
API Access Requirements
Ensure the following before proceeding:
-
Active Sailthru account — An active Sailthru (or Engage by Marigold) account is required.
-
Administrator access — Only account administrators can view and manage API credentials in the Sailthru settings.
-
API Key and Secret — Both the API key and the API secret are required; neither alone is sufficient for authentication.
-
Network connectivity — Confirm that the Nexla platform can reach Sailthru's API endpoint at
https://api.sailthru.com.
Authenticate
Credentials required
| Field | Required | Secret | Description |
|---|---|---|---|
| API Key | Yes | Yes | Sailthru API Key |
| API Secret | Yes | Yes | Sailthru API Secret |
Create a credential in Nexla
-
After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.
-
Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.
-
Enter your Sailthru API key in the API Key field. This is the unique identifier associated with your Sailthru account that Nexla will include in every API request.
-
Enter your Sailthru API secret in the API Secret field. The secret is used together with the API key to generate a cryptographic signature that authenticates each request. This value should be treated as a password and kept confidential.
Both the API key and API secret can be retrieved from the Settings > Setup > API & Postbacks page in your Sailthru account. Click the lock icon on that page to reveal the credentials.
-
Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.
Use as a data source
To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Sailthru connector tile, then select the credential that will be used to connect to the Sailthru account, and click Next; or, create a new Sailthru credential for use in this flow.
Manual configuration
Sailthru sources are configured to ingest data from any valid Sailthru API endpoint. The Sailthru REST API base URL is https://api.sailthru.com, and all requests must be made over HTTPS. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers. Use GET for retrieving data such as user profiles, campaign details, or list information, or POST for querying or exporting data via Sailthru's Job API, which supports bulk exports and complex queries.
Common Sailthru API endpoints include /user (individual user profile data, custom variables, device information, and engagement history), /list (subscriber lists and list membership), /blast (email campaign blast details and performance data), /job (asynchronous export jobs, such as bulk user or campaign recipient exports), and /stats (statistical data for lists, blasts, or sends). For complete endpoint details and parameters, refer to the Sailthru API Documentation.
Sailthru API responses typically nest the primary data under a key such as lists, blasts, or data—for example, set the Set Path to Data in Response field to $.lists[*] for list data or $.blasts[*] for blast data. Metadata fields such as total, status, or request identifiers alongside the primary data can be captured via the Path to Metadata in Response field. You do not need to include authentication headers in the Request Headers field—Sailthru's API key, secret, and request signature are handled automatically by Nexla based on your Sailthru credential configuration.
Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Sailthru data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.
Use as a destination
Click the + icon on the Nexset that will be sent to the Sailthru destination, and select the Send to Destination option from the menu. Select the Sailthru connector from the list of available destination connectors, then select the credential that will be used to connect to the Sailthru account, and click Next; or, create a new Sailthru credential for use in this flow.
Manual configuration
Sailthru destinations are manually configured to send data to any valid Sailthru API endpoint. Common use cases include creating or updating user profiles, managing list subscriptions, triggering transactional email sends, and updating user purchase or event data. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, data format, endpoint URL, request headers, attribute exclusions, record batching, and response webhooks. Use POST for creating new records or updating existing ones (the primary method for most Sailthru write operations), or DELETE for removing records, such as unsubscribing a user from a list.
Common Sailthru API endpoints for destination operations include /user (create or update user profiles, custom variables, purchase history, and list subscriptions via POST, upserting based on email address or external ID), /list (add or remove users from subscriber lists), /send (trigger transactional email sends using a predefined template), /purchase (record purchase events to power personalized recommendations), and /event (track custom events such as product views or add-to-cart actions). For complete endpoint details, required parameters, and supported request formats, refer to the Sailthru API Documentation.
Sailthru's API accepts data in JSON format for most endpoints—select JSON from the Content Format pulldown menu. You do not need to include authentication headers in the Request Headers field—Sailthru's API key, secret, and request signature are handled automatically by Nexla using your Sailthru credential configuration.
Save & activate
Once all endpoint settings have been configured, click the Done button in the upper right corner of the screen to save and create the destination. To send the data to the configured Sailthru endpoint, open the destination resource menu, and select Activate.
The Nexset data will not be sent to the Sailthru API until the destination is activated. Destinations can be activated immediately or at a later time, providing full control over data movement.