Kartra Documentation Technical Documentation for Kartra

Email Gateways: overview

Here you will find any necessary information to setup a email gateway.

Some general notes to consider:

1. Kartra has the ability to integrate with four different email systems; SendGrid, PostMark, ElasticEmail, and MailGun.

Email 01

Email 02

 

2. Each gateway will have its own unique method of connecting to the Kartra system.

3. The Kartra user during creation of the integration will be able to test the email gateway by selecting the test option.

*Please Note: The email in the box is the email you want to receive the test.  (Despite the example below, this can be a any type of email service; including free)

4. Upon completion of the gateway, Kartra will present you with a webhook that can be used on your email service provider’s site.

Email 03

SendGrid

Sendgrid integration will require a API key from Sendgrid to integrate into Kartra.

*Please Note: This means most issues will need to be solved via Sendgrid and Sendgrid support.

Upon selecting the Sendgrid tab within the email gateway model window you will be presented with the following.

SendGrid 03

 

You will need to login to Sendgrid on a separate tab and collect the key from the API options within Sendgrid.

After logging into Sendgrid, select the API Keys option within the menu options.

SendGrid 01

 

Then you will create an API key with any name you wish to utilize by selected create API.  Your API key will then be displayed for your use.

SendGrid 02

 

*Please Note: Sendgrid may change their website from what appears in this document; but there should still be an API section with the key information.

Meanwhile on the original tab with Kartra, you will need to copy the “API Key” into the modal window.  At this point the create option will enabled. By selecting create you can now finish your Sendgrid email gateway integration.

If you are unable to find the “API Key” on Sendgrid or have issues with utilizing the webhook on Sendgrid, please contact Sendgrid support.

If your Sendgrid API Key does not work via Kartra, please contact Kartra support.

PostMark

PostMark integration will require a API key from PostMark to integrate into Kartra.

*Please Note: This means most issues will need to be solved via PostMark and PostMark support.

Upon selecting the PostMark tab within the email gateway model window you will be presented with the following.

Postmark 02

 

You will need to login to PostMark on a separate tab and collect the key from the API options within PostMark.

After logging into PostMark, select the server you wish to use, and then select the Credentials tab within the menu options.

Postmark 01

 

*Please Note: PostMark may change their website from what appears in this document; but there should still be an API section with the key information.

Meanwhile on the original tab with Kartra, you will need to copy the “API Key” into the modal window.  At this point the create option will enabled. By selecting create you can now finish your PostMark email gateway integration.

If you are unable to find the “API Key” on PostMark or have issues with utilizing the webhook on PostMark, please contact PostMark support.

If your PostMark API Key does not work via Kartra, please contact Kartra support.

 

*Important Note: What about message streams?

If you were informed by PostMark support that there is an issue with your Kartra setup due to a lack of message streams in our integration, then we want to clarify that Kartra is in fact using message streams contrary to what they may have said. This is a simple misunderstanding as our documentation above does not mention message streams on purpose.

Under most situations with third party programs such as ours, the user (such as yourself) will be the one clarifying what a message contains and hence would need to input the message stream details within an integration to PostMark.

Kartra however does not need to do this because we separate all the different types of emails within our system interface already. Such as purchases, broadcasts, notifications, and etc. So we have already identified which streams need to go to which emails and automatically handle it on the back end so our users do not need to worry about it.

So if PostMark support says Kartra is the cause of your issue due to lack of a “message stream”, please direct them to this documentation or support team (support@kartra.com) to clarify that we do in fact have message streams and they should be unique to each type of email and content coming from your account based on their contents.

Elastic Email

Elastic Email integration will require a API key from Elastic Email to integrate into Kartra.

*Please Note: This means most issues will need to be solved via Elastic Email and Elastic Email support.

Upon selecting the Elastic Email tab within the email gateway model window you will be presented with the following.

ElasticEmail 01

 

You will need to login to Elastic Email on a separate tab and collect the key from the API options within Elastic Email.

After logging into Elastic Email, select the setting menu option, and then select the SMTP/API tab within the menu options.

ElasticEmail 02

*Please Note: Elastic Email may change their website from what appears in this document; but there should still be an API section with the key information.

Meanwhile on the original tab with Kartra, you will need to copy the “API Key” into the modal window.  At this point the create option will enabled. By selecting create you can now finish your Elastic Email email gateway integration.

 

If you are unable to find the “API Key” on Elastic Email or have issues with utilizing the webhook on Elastic Email, please contact Elastic Email support.

If your Elastic Email API Key does not work via Kartra, please contact Kartra support.

MailGun

MailGun integration will require a API key from MailGun to integrate into Kartra.

*Please Note: This means most issues will need to be solved via MailGun and MailGun support.

Upon selecting the MailGun tab within the email gateway model window you will be presented with the following.

Mailgun 04

 

*Please Note: Unlike other email gateways you may notice there is a “Domain region”. Depending on the region of your MailGun gateway setup you will have to set the region via this drop-down to match your own region.

You will need to login to MailGun on a separate tab and collect the key from the API options within MailGun.

After logging into MailGun, select the domain tab, and then select the domain you wish to use.

Mailgun 01

 

You will then be presented with the domain information which will include your “API Base URL” or your domain and your API key.

Mailgun 02

*Please Note: MailGun may change their website from what appears in this document; but there should still be an API section with the key information. If you cannot find your MailGun API Keys, please contact MailGun support.

 

*IMPORTANT NOTE: There is one final check you must do inside your MailGun account.

Go to the “Domains” section, and turn all their Tracking Settings to OFF mode. The reason for that is because MailGun will inject their tracking codes into your Kartra emails which will mess up your email contents, links, etc. These analytics can still be collected within your Kartra analytics, but your MailGun analytics may be inaccurate when this is disabled.

Mailgun 05

Now you’re finally done in MailGun, and it’s time to return to your Kartra interface within the MailGun integration window. Here, you will need to copy the “API Key” and “domain”.

At this point the create option will enabled. By selecting create you can now finish your MailGun email gateway integration.

© 2024 Kartra All Rights Reserved