Easypromos includes two native integrations with ActiveCampaign that offer the following functionalities:

1. Automatically send to ActiveCampaign the registration data of users who participate in a promotion created with Easypromos.
2. Validate that the email entered by the user during registration already exists in ActiveCampaign.

These two native integrations are included at no additional cost for any customer with a White Label subscription.

For other use cases that are not covered by the native integrations —such as sending the details of the user participations (points earned in a game, survey responses, uploaded purchase receipts) or obtaining information about prizes won—we recommend creating custom connectors using the Easypromos webhooks system, or through the integrations available on Zapier or Make.com.

In this tutorial, we explain step by step how to configure the two native integrations with ActiveCampaign.

1. Automatically send to ActiveCampaign the registration data of users who participate in a promotion created with Easypromos.

What actions can be performed?

1. Automatically sync and import participant emails into any ActiveCampaign list. Easypromos syncs leads with ActiveCampaign in 15-minute intervals.
2. Link the fields from the promotion registration form with the fields in the ActiveCampaign list.
3. Condition the import into the ActiveCampaign list on a checkbox in the registration form (for example, selecting the checkbox corresponding to user consent to be included in the mailing list).

Note: The integration with ActiveCampaign is only available for customers with a Corporate Plan or White Label Plan.

Important: In order to import participant emails into your ActiveCampaign mailing lists, you must enable the 'Email' field in the user registration form, so that users are required to enter their email address when registering for the promotion.

Note: The integration will only import new users who register for the promotion, so make sure to configure the integration before launching the promotion. 

To get started, the administrator must already have an active ActiveCampaign account, as well as a contact list already created, where all the emails of users who have participated in the promotion will be imported.

Once the mailing list has been created, to sync your promotion database with ActiveCampaign follow the steps detailed below:

1. Access your ActiveCampaign account and create a new API in order to obtain the API access credentials and be able to sync Easypromos with ActiveCampaign. To do this, access your account settings, go to the developer section, and create a new key.

2. Access then your promotion from your Easypromos dashboard, and click on the "Integrations" option found in the left-hand menu:

3. Next, click on the ActiveCampaign image to sync the promotion database:

4. You will access the ActiveCampaign module configuration page, where as a first step you must connect to your ActiveCampaign account by entering the API key and the URL.

5. Next, a pop-up will open showing the different mailing lists you have created in ActiveCampaign. Select which ActiveCampaign list you want to import your promotion user data into.

6. Next, a pop-up window will open showing the different registration form fields you have configured in the promotion, as well as the 'Email' field that is always included by default. At this point, you must link the different registration fields with the fields in the ActiveCampaign mailing list, as shown in the following image:

7. Once all the form fields have been linked, automatic import will be enabled. The application itself will automatically sync and import user emails into ActiveCampaign as users register for the promotion (users will be imported automatically within a period of max. 15 minutes).

On this screen, you can see the available integration configuration options:

• Change: From here you can change the ActiveCampaign mailing list you previously selected.
• View and edit field bindings: here you can review the form fields you have linked to the fields in the ActiveCampaign list and make any changes you need.
• Select the promotion consent checkbox: this option allows you to select the form checkbox where you request user consent. If you select this option, the application will only import into ActiveCampaign the emails of users who have accepted this checkbox.
• Generic email filter: if you are launching a B2B campaign, you can exclude contacts with generic email addresses (Gmail, Hotmail, Yahoo, etc.). This way, you will only collect professional contacts

Note: In promotions with Login enabled, only unique users will be sent, not their participations or prizes.

2. Validate that the email entered by the user during registration already exists in ActiveCampaign.

This use case allows you to validate user access to an Easypromos promotion by checking whether the entered email belongs to ActiveCampaign. Validation is performed in real time via the ActiveCampaign API and allows you to restrict participation exclusively to users previously registered in an ActiveCampaign database.

This type of validation is especially useful for private or restricted promotions, such as campaigns aimed exclusively at customers, partners, or employees.

What actions can be performed?

1. Automatically validate the email entered by the user when accessing the promotion, checking whether it exists in ActiveCampaign.
2. Allow or deny access to the promotion depending on whether the email is registered in ActiveCampaign.
3. Display a custom error message when the entered email is not part of ActiveCampaign.

To use this functionality, the administrator must have an active ActiveCampaign account and access to the API connection data (access URL and access key).

To configure email access validation against ActiveCampaign, you will need the ActiveCampaign API access credentials, which will allow Easypromos to perform the email validation.

To do this, access your ActiveCampaign account, go to Settings > Developer, and create a new API (or use an existing one). On this screen you can copy the API access URL and the API access key, which will be used later.

Next, go to the promotion settings in Easypromos. Enter the Editor and go to the Pages > Login and Registration section. You must follow the indicated steps to configure access to the promotion:

1. Under the Login tab, select the Email Access Method, which will be the method on which validation against ActiveCampaign will be applied.

2. Enable the Email restrictions option and select Via external API (webservice). 

This option allows Easypromos to query a system such as ActiveCampaign to validate whether the email entered by the user is valid or not.

Once validation via external API has been selected, configure the webservice with the following values:

• Method: GET
• Content-Type: JSON
• Header:
  • Name: Api-Token
  • Value: {{ACTIVE-CAMPAIGN-API-KEY}}
• Webservice URL:
  {{ACTIVE-CAMPAIGN-API-ACCESS-URL}}/api/3/contacts?search={EMAIL}

This configuration will allow ActiveCampaign to be queried to check whether the email entered by the user exists in its database.

3. To correctly identify when an email does not exist in ActiveCampaign, it is necessary to configure error detection in the advanced webservice options.

In the field Detect error using this text, enter the following text:

"contacts":[]

When the ActiveCampaign response contains this text, it will be interpreted that the email does not belong to any contact and access to the promotion will be denied.

If the entered email does not exist in ActiveCampaign, the system blocks access to the promotion and displays the configured error message.

Finally, you must define the error message that will be shown to users when they enter an email that is not part of ActiveCampaign.

Note: This message supports HTML code, so it is recommended to include, if necessary, a link to a registration form or an informational page where the user can request access.

Once the configuration is complete, access to the promotion will be automatically validated at the moment users enter their email.

Pre-fill form fields from ActiveCampaign

In addition to validating access, you can automatically pre-fill the registration form fields when sending the link of the promotion from ActiveCampaign. This allows users to see their data already completed, speeding up their registration in the promotion.

To do this, you must build dynamic links including the user data (email, first name, and last name).

For example, if the general link to the Easypromos campaign is:

https://a.cstmapp.com/p/990744

and the user data in ActiveCampaign is:

• First name: John
• Last name: Smith
• Email: john.smith1980@gmail.com

The link is constructed as follows:

https://a.cstmapp.com/p/990744?em=john.smith1980@gmail.com&fn=John&ln=Smith

When accessing the promotion through this link, the form fields will be pre-populated with the information sent from ActiveCampaign, and the user will only need to complete eventual additional information requested as well as give consents to the T&Cs of your promotion.