Skip to main content

Authorization

Follow this guide to create a new Sailthru credential that will allow Nexla to authenticate to and exchange data with your Sailthru account.
sailthru_cred_api_auth.png

Sailthru

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.

  1. Log in to your Sailthru account at my.sailthru.com.

  2. Navigate to Settings in the top navigation bar.

  3. Under the Setup section, select API & Postbacks.

  4. On the API & Postbacks page, click the lock icon next to your credentials to reveal your API Key and Secret.

  5. Copy both the API Key and the Secret and store them securely. Both values are required to authenticate API requests.

Keep Your API Secret Secure

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.

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.

Create a Sailthru Credential​

  • To create a new Sailthru credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used to provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

Sailthru API Credentials​

  1. 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.

  2. 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.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. 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.