JangoMail
To complete the integration, you will need to create an API Token and set up Transactional API Events. Please follow the instructions below to complete the integration.
Create API Token
Authenticate
- Follow the link below: https://api-v2.jangomail.com/documentation#auth
- Authenticate with your username and password
- Fill in your username and password and click SET
Create your API token
- While authenticated, scroll to the following section of the documentation: https://api-v2.jangomail.com/documentation#post-/apitokens
- Click FILL EXAMPLE then click TRY. The token will appear in the RESPONSE as shown below
Use this token as the API Key in your Send Integration
Set Up Transactional API Events
- Navigate to the Transactional Events API section under Settings > Notifications > Transactional Events API: https://app.jangosmtp.com/settings/transactionalevents
Set up the EmailElement webhook for these events: Email Sent, Unsubscribe, Bounce, Block, Complaint. Choose the Email Sent event tab and fill in the following:
| Field | Value |
|---|---|
| Enable events | turn on |
| Data format | JSON |
| URL | https://deliverywebhook.emailelement.com/api/event/jangomail |
| Custom Headers | eventtype:sent |
| Transactional Email ID | id |
| Email Address | |
| Sent Date/Time | date |
Choose the Unsubscribe event tab and fill in the following:
| Field | Value |
|---|---|
| Enable events | turn on |
| Data format | JSON |
| URL | https://deliverywebhook.emailelement.com/api/event/jangomail |
| Custom Headers | eventtype:unsubscribe |
| Transactional Email ID | id |
| Email Address | |
| Unsubscribe Date/Time | date |
Choose the Bounce event tab and fill in the following:
| Field | Value |
|---|---|
| Enable events | turn on |
| Data format | JSON |
| URL | https://deliverywebhook.emailelement.com/api/event/jangomail |
| Custom Headers | eventtype:bounce |
| Transactional Email ID | id |
| Email Address | |
| Bounce Date/Time | date |
| Diagnostic Code | diagnosticCode |
Choose the Block event tab and fill in the following:
| Field | Value |
|---|---|
| Enable events | turn on |
| Data format | JSON |
| URL | https://deliverywebhook.emailelement.com/api/event/jangomail |
| Custom Headers | eventtype:block |
| Transactional Email ID | id |
| Email Address | |
| Block Date/Time | date |
| Diagnostic Code | diagnosticCode |
Choose the Complaint event tab and fill in the following:
| Field | Value |
|---|---|
| Enable events | turn on |
| Data format | JSON |
| URL | https://deliverywebhook.emailelement.com/api/event/jangomail |
| Custom Headers | eventtype:complaint |
| Transactional Email ID | id |
| Email Address | |
| Complaint Date/Time | date |
Example of form filled out:
Remember to SAVE your settings.
That's it! You should be ready to send email using JangoMail.
Set Up JangoMail in EmailElement
- Go to Send Integrations and click Create Send Integration.
- Choose the integration type, pick JangoMail from the list, and click Next.
- Enter a name for the integration.
- Select one or more sender domains. A validated domain carries a green tick and is ready to send from.
- Enter the API token you created.
- Custom Headers are optional, and go on every email this integration sends.
- Click Create.
Test the Integration
- Click Run Test on the integration.
- The result is reported for each sender domain on it.
- One domain succeeding is enough for the integration to go active.
Troubleshooting
| Issue | Solution |
|---|---|
| Authentication failed | Check the credentials are correct and still active in JangoMail. |
| Domain not verified | The sender domain has to be verified in EmailElement and in JangoMail. Check its SPF and DKIM records. |
| Run Test fails for one domain | That domain is not set up in JangoMail. Check it there, and check its DNS records. |
| Nothing recorded in Delivery Events | The webhook is not reaching us. Check the webhook steps above were completed. |