Connect Mailchimp Transactional to send auth link emails from your own domain
Mailchimp Transactional is the email sending service inside Mailchimp, previously called Mandrill. With a credential linked, the Send message panel on an auth link lists Mailchimp Transactional under Email provider, and the From email domain list shows the sender domains in your Mailchimp Transactional account. Without one, the panel only offers "Formpiece - will use noreply@formpiece.com". The page says it is used for forms that have auth links, which need a Geosearch subscription.
You are responsible for the Mailchimp Transactional account and its domains. Formpiece cannot guarantee delivery when the account is set up wrongly.
Step by step
- Click Settings in the Simpro Bookings menu, then Mailchimp Transactional under Auth.
- Paste the key into Mailchimp Transactional API Key.
- Click Create Mailchimp Transactional credential. When the account already has one the button reads Update Mailchimp Transactional credential.
The key goes to Formpiece, which asks Mailchimp Transactional whether it accepts the key before anything is stored. It is then encrypted. The box is a password field, and the page says the key is stored encrypted and is not shown again. A saved credential shows "Saved. Enter a new key to replace it" in the box.
A new credential is called "Mailchimp Transactional integration for Simpro Bookings" under Integration Credentials. If the account has credentials already, a Mailchimp Transactional Credential dropdown appears above the key. Choosing one that has a saved key lets you click Update Mailchimp Transactional credential with the box empty, which links it to your forms without changing the key. Choosing one without a saved key makes the box required.
When it goes wrong
The page says "Mailchimp Transactional credentials updated" but the key is not saved
When Mailchimp Transactional turns the key down, the Formpiece API answers "Mailchimp Transactional did not accept this API key. Check it under Settings > API keys in Mailchimp Transactional." and does not store the key. The page does not show that answer, so you can still see the success message. The box showing "Saved. Enter a new key to replace it" is the sign that a key is stored.
I cannot unlink Mailchimp Transactional
Clearing the dropdown leaves the button greyed out while the key box is empty, and typing a key with nothing selected makes a new credential. There is no unlink on this page.
I only see the Formpiece sender on an auth link
The provider is listed under Email provider only when a credential is linked here. If it is linked and the From email domain list is empty, the account has no sender domain.
Other errors
A key over 256 characters, a credential that belongs to another vendor, or a credential that is no longer on your account are refused by the API. The page shows the API's message in red.