Who This Is For
This guide is for Solitics customers who want to use SendPost as their email sending provider. As a Solitics customer you may have multiple brands and each brand would be associated to a SendPost sub-account as a Provider within your Solitics account.
This can be structured with a single SendPost account with multiple sub-accounts or multiple SendPost accounts with a single sub-account in each one.
Your SendPost representative can help ensure your set up is optimal for your use case. The below instructions use a single SendPost account with multiple sub-accounts for setup but the process is the same if you have multiple SendPost accounts you would just need to set up each account individually.
Before You Begin
You will need an active SendPost account. If you do not have one yet, ask your Solitics account manager for an introduction to the SendPost team, or schedule a setup call directly.
After your meeting completes and any commercials are finalized you will be introduced to your assigned SendPost team in a shared channel to begin your onboarding. This process will include the following:
Account Setup in SendPost:
Part 1: Setting Up SendPost
Step 1: Create Sub-Accounts for Each Brand
Start by setting up your SendPost account at https://app.sendpost.io/register. Once completed, notify your SendPost account manager so they can verify, unlock and upgrade your account for use.
Your SendPost account manager will then create an IP pool in your account with the name transactional. Please verify this has been created if your connection to Solitics has not yet been established please let Solitics know your IP pool has been created on the SendPost side.
Log in to your SendPost account.
Navigate to your profile icon at the top right corner of the screen.
Select Sub-Accounts from the dropdown menu.
Create one sub-account for each brand from which you intend to send emails.
Note: Each sub-account in SendPost corresponds to one brand or provider in your Solitics account. Make sure your sub-account names clearly reflect the brand they represent to avoid confusion later.
Step 2: Add a Sending Domain to Each Sub-Account
Inside each sub-account, navigate to the Domains section.
Add the sending domain that corresponds to that brand.
SendPost will generate a set of DNS records.
Log in to your domain hosting provider and add those DNS records to your zone file.
Return to SendPost. Once the DNS records are verified, you will see a green check mark and a green indicator next to each record confirming the setup is complete.
Important: The scope of a domain is limited to the sub-account it is added to. When adding a new domain, always confirm you are working inside the correct sub-account before saving.
Step 3: Retrieve Your API Keys
You will need to share two types of API keys with your Solitics team.
Account API Key:
Click your profile icon in the top right corner of SendPost.
Select Account from the menu.
Under Account Information you'll be able to find the Account API key. Can be viewed only once, so make sure to save it securely on your end. Otherwise you need to regenerate the key if you need to use it in the future.
Copy your Account API Key.
Sub-Account API Key:
Click your profile icon and select Sub-Accounts.
Find the relevant sub-account and click manage button under API key column
Copy the Sub-Account API Key displayed for that sub-account/regenerate the API key for the subaccount. Same account above, save it securely for future use.
Repeat this for each sub-account. Share both the Account API Key and all Sub-Account API Keys with your Solitics team so they can complete the provider configuration on their end.
Security reminder: Treat your API keys like passwords. Do not share them over email or public channels. Use a secure method such as a password manager or encrypted message to pass them to your Solitics contact.
Step 4: Add the Solitics Webhook Endpoint
Solitics provides a webhook URL that SendPost will use to send email event data back to your Solitics account in real time. This enables Solitics to track events such as:
Email sent
Email processed
Opened
Clicked
Unsubscribed
To add the webhook:
Click your profile icon in SendPost.
Select Webhooks from the menu.
Add the webhook endpoint provided by your Solitics team. The URL follows this format:
https://api.solitics.com/rest/v1/webhooks/{{yourSoliticsBrand}}/TestEmailBuilderSendPostGenericProviderReplace
{{yourSoliticsBrand}}with your actual Solitics brand identifier as given to you by Solitics.You can find your brand name on the top-right corner of your dashboard. Eg: Fashion is the brand name. Then the webhook will be: https://api.solitics.com/rest/v1/webhooks/fashion/TestEmailBuilderSendPostGenericProvider
Enable the Webhook parameters exactly as shown in the following image:
Repeat this step for each sub-account, using the corresponding Solitics brand identifier.
Step 5: Add Your Email Templates to SendPost
Any email template you plan to use inside a Solitics can be added to SendPost. You can organize them using folders and can even sync templates from Stripo. If you are using multiple ESP's then you can add the template on Solitics end.
In each SendPost sub-account, create or import the email templates you want to use in Solitics.
Make sure the template names are clear and recognizable, since they will appear as a selection list when you build workflows in Solitics.
Part 2: Activating SendPost in Solitics
For your setup in Solitics please follow the below or refer to this article on Solitics help desk.
Once the SendPost side is configured, activate the integration from within your Solitics account.
Log in to Solitics.
Go to Settings and select the Providers configuration area.
Choose SendPost as your email provider.
Enter the requested information when prompted. This will include your Sub-Account API Key, which you retrieved in Step 3 above.
Configure how members are identified within the integration. Your Solitics team can guide you on the identification method that best fits your data setup.
Save and activate the integration.
Repeat this process for each brand or sub-account you are connecting.
Confirming a Successful Solitics + SendPost Integrated Account Setup
To verify if the Solitics <> SendPost account setup has been done correctly, you should be able to do the following:
Solitics customer should be able to see all the email templates while creating Solitics workflow and should be able to select them using their template name. The template HTML also will appear on Solitics workflow builder
The emails are sent successfully from Solitics via SendPost. All the stats should correctly get updated at a subaccount and IP level on SendPost
The Solitics customer should be able to see all the webhook events on their Solitics dashboard and in their Solitics CRM
Personalisation:
Unsubscription:
For SendPost to send unsubscription webhook, the below personalisation tag needs to be present in the email templates {{unsubscribe}}
Sample HTTP Post Body:
{
"from": {
"email": "tech@deals.store41mz.com"
},
"to": [
{ "email": "varun@sendx.io"}
],
"subject": "Testing IP pool configuration",
"htmlBody": "Are you receiving my email?
<a href='https://google.com'>Google</a>
<a href='{{unsubscribe}}'> Get me off the list</a>",
"textBody": "Are you receiving my email?",
"trackClicks": true,
"trackOpens": true,
"ippool": "transactional"
}Variable Replacement / If-Else condition and iterating over objects:
Any variable that needs to be replaced, needs to be passed in {{}} such as {{firstname}} or {{phonenumber}} or {{address}}. Note that these fields need to be specified during the API call as custom fields via Solitics
For using if/else condition the below syntax can be used:
{{#if customer}}
My last purchased product is {{last_purchase}}
{{else}}I am not a paid customer
{{/if}}
For iterating over objects the below syntax can be used:
{{#each recommendations}}
{{this.item_name}}
{{/each}}
Important Notes
One sub-account per brand, always. If you add a domain to the wrong sub-account, it will not work for that brand's workflows. Double-check your sub-account selection at each step.
DNS propagation takes time. After adding DNS records, allow up to 24 to 48 hours for full propagation. During this period, the green verification indicator may not appear immediately. Do not proceed to subsequent steps until all DNS records show as verified.
Webhook must be enabled as requested. If you select all the options, contacts having both temporary and permanent issues will be sent to Solitics and all respective contact will be suppressed on Solitics end.
Frequently Asked Questions
Can I use multiple SendPost accounts instead of one account with sub-accounts?
Yes. You can use multiple SendPost accounts, each with a single sub-account. The setup process is identical. You will need to complete all the steps individually for each SendPost account and ensure each is activated separately as a provider in Solitics.
Where do I find my Solitics brand identifier for the webhook URL?
Your Solitics brand identifier name can be located on the top-right corner of your dashboard. If you are unsure what it is, reach out to your Solitics contact before attempting to configure the webhook in SendPost.
The green DNS verification indicator is not showing up. What should I do?
First, confirm the DNS records were added correctly at your domain hosting provider. DNS propagation can take up to 48 hours, so wait before concluding there is an issue. If the records still show as unverified after 48 hours, contact the SendPost support team with a screenshot of your DNS zone file for review.
My email templates are not appearing in the Solitics workflow builder. Why?
The integration might not have been configured correctly. Check the API keys and ensure correct account is connected with Solitics.
I shared my API keys. Is there anything else my Solitics team needs from me?
In most cases, the API keys and the webhook URL are sufficient for the Solitics team to complete their side of the configuration. However, keep your SendPost contact looped in during setup. They can confirm whether your account structure is optimal and help resolve any access or configuration issues.
Who do I contact if something goes wrong during setup?
For issues within SendPost such as domain verification, API key access, or webhook configuration, contact the SendPost support team using the in app chat. For issues within the Solitics platform such as provider activation or workflow configuration, reach out to your Solitics account manager.