Connect Mailgun to send auth link emails from your own domain
With a Mailgun credential linked, the Send message panel on an auth link lists Mailgun under Email provider, and the From email domain list shows the active domains in your Mailgun account. Without one, the panel only offers "Formpiece - will use noreply@formpiece.com". The page says Mailgun is used for forms that have auth links, which need a Geosearch subscription.
You are responsible for the Mailgun account and its domains. Formpiece cannot guarantee delivery when the Mailgun account is set up wrongly.
Step by step
- Click Settings in the Simpro Bookings menu, then Mailgun under Auth.
- Paste the key into Mailgun API Key.
- Click Create Mailgun credential. When the account already has a Mailgun credential the button reads Update Mailgun credential.
The key goes to Formpiece, which asks Mailgun 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 "Mailgun integration for Simpro Bookings" under Integration Credentials. If the account has Mailgun credentials already, a Mailgun Credential dropdown appears above the key. Choosing a credential that has a saved key lets you click Update Mailgun 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 "Mailgun credentials updated" but the key is not saved
When Mailgun turns the key down, the Formpiece API answers "Mailgun did not accept this API key. Check it under API security in Mailgun." 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 Mailgun
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
Mailgun is listed under Email provider only when a Mailgun credential is linked here. If it is linked and the From email domain list is empty, Mailgun has no active domain on that account.
Other errors
A key that is too long (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.