Easypromos is a platform that covers multiple use cases in the management of digital promotions. The platform incorporates different interfaces and mechanisms that facilitate its integration into the client’s processes and tools, with the goal of achieving maximum automation.

Easypromos’ integration capabilities can be divided into the following 7 main blocks:

1. Integration with user systems

2. Integration with user segments

3. Displaying promotions within websites or apps

4. Automated data extraction

5. Real-time code validation

6. Integration with loyalty point systems

7. Other advanced integrations

1. Integration with users system

You can restrict participation in the promotion to make it exclusive to the users of your own system. Easypromos offers different mechanisms to make this possible:

1.1. Autologin API

Used when the promotion is displayed within a website or app where the user is already authenticated. The website or app sends the user’s information to Easypromos via API, and then the promotion loads. 

More information.

1.2. Open ID Connect (SSO)

Direct integration with the client’s Single Sign-On (SSO) system. The user is redirected to the client’s authentication system and, once validated, automatically returns to the promotion to participate. Ideal for providers such as Okta, Ping ID, Microsoft Entra ID, JumpCloud, OneLogin, Gigya, among others.

More information.

1.3. Real-time validation (Webservice)

Allows you to configure a registration field (for example, email or customer number) to validate in real time, through a webservice, whether it exists in the client’s database. If it does not exist, an error message is displayed with a link to register. Ideal for promotions aimed at increasing newsletter subscribers.

More information.

1.4. User data via URL

The user’s data is sent directly through parameters in the URL, which makes it possible to automatically identify the participant. It is especially useful for campaigns distributed by email: the user receives a personalized link and, upon clicking, accesses the promotion directly.

More information.

2. Integration with user segments

Easypromos can integrate with the user segments or groups defined in the client’s system. This integration works together with user authentication and allows mapping the client’s groups to Easypromos segments.

In this way, it is possible to create specific promotional dynamics for each group, offering personalized incentives and managing different legal requirements, for example, in the case of minors or junior users.

Practical use examples:

• Grant additional entries in a giveaway to users in the Paid Subscribers group as opposed to free members.
• Provide access to exclusive coupons and discounts only to users in the VIP group.
• Restrict participation in a grand prize wheel to users in the Premium group.

Resources:

• How user segments work.
• Integration of segments via Autologin API or OpenID Connect.
• Segments management REST API.

3. Displaying promotions within websites or apps

Easypromos offers different options to integrate promotions directly into the client’s website or app, always ensuring a responsive and brand-adapted experience:

3.1. Widgets

These allow you to embed any promotion as an iframe on a webpage. The widget automatically adapts to the content and is 100% responsive.

• User guide.
• Troubleshooting guide.

3.2. Popups

The promotion is displayed as a popup within the client’s website. You can configure parameters such as delay time or frequency of appearance.

• More information.

3.3. WordPress plugin

We provide an official plugin that allows you to easily embed promotions in WordPress posts or pages.

• User guide.
• Official WordPress plugin page.

3.4. Custom domains

It is possible to display the promotion on a client’s custom domain. This is ideal for full-page promotions, reinforcing brand identity.

• More information.

3.5. Webviews in mobile apps

Direct integration of promotions within mobile applications using webviews. This allows the promotion to be displayed as another screen within the app, maintaining the native experience and avoiding the need for users to leave the application.

• Download PDF on how to integrate Easypromos in your Mobile App.

4. Automated data extraction

Easypromos offers different interfaces to automatically send user, participations and prizes data to external platforms. This allows, for example, adding new users to a CRM, synchronizing subscribers with an Email Marketing tool, or sending prize information to a management system.

The available mechanisms are:

4.1. Webhooks

They send data in real time to an external service when an event occurs in the promotion.

• More information about Webhooks.

Available events:

1. New user registered: sends the user’s data when registering in the promotion. Ideal for adding users to a CRM or management system.
2. New participation registered: sends the specific participation data (e.g., points earned in a game or prize won in a wheel).
3. Prize assigned: sends complete information for each prize won and the corresponding user.
4. Prize claimed: triggers when the user completes the claim form with additional data.
5. Virtual coins transaction: sends each operation involving virtual coins (positive when earning coins, negative when spending them), including the amount, updated balance, and user data.
    

4.2. REST API

Complete API with access to the main platform components: promotions, stages, users, participations, prizes, organizing brands, etc. Allows creating advanced automations, navigating promotions, and retrieving all related data.

• Introduction to the REST API.
• OpenAPI 3.0 Specification.

4.3. Native integrations

Direct synchronization with leading marketing and CRM platforms, such as Mailchimp, Constant Contact, Campaign Monitor, HubSpot, Selligent, Brevo, among others.

• Complete list of integrations.

4.4. Zapier

Integration with Zapier.com, with a one-to-one correspondence between Easypromos webhooks and Zapier triggers.

• Easypromos on Zapier.
• Connection guide.

4.5. Other automation platforms

Easypromos can be integrated via Webhooks with solutions such as Make.com or n8n.

4.6. Custom integrations

We offer a service to develop custom connectors to synchronize users or data with proprietary systems. These integrations allow automatically mapping all registration form fields and sending the data in real time to the client’s system. For more information, contact our sales team.

5. Real-time code validation

In promotions where users must enter a code to participate, Easypromos allows validating that code in real time via an external webservice that confirms whether it is valid or not.

Typical use cases:

• A user purchases a product with a unique code. When entering it in Easypromos, the system validates it in real time against the client’s database.
• To participate, the user is asked to enter an invoice or receipt number, which is automatically validated against the client’s receipt system.

This validation is applied as a prerequisite to allow the user to participate in the promotion.

Resources:

• Real-time validations via webservice.

6. Integration with loyalty points systems

One of the most common use cases for Easypromos is its integration with loyalty programs. With a single connection, all Easypromos promotional mechanics and games can be enabled to engage program users.

These programs are usually based on a coins system that users accumulate through purchases and later redeem for rewards. Thanks to the integration with Easypromos, it is possible to:

• Award virtual coins for completing games, surveys, or other actions within Easypromos.
• Access to promotional activities provided in exchange for coins.
• Redeem program coins for prizes managed in Easypromos.
• Directly manage coins calculations from Easypromos.
• Send coins to Easypromos for actions performed on the client’s website or platform.

Resources:

• Virtual coins system: the key to the integration, this feature allows points to be accumulated and later used. More information.
• Virtual coins management API: this API allows sending coin transactions, synchronizing point balances between Easypromos and the platform. API Documentation.
• Download PDF: How to integrate Easypromos into a loyalty web portal.

7. Other advanced integrations

Easypromos’ flexible architecture, based on promotions, stages, requirements, users, entries, prizes, virtual coins, and validation points, together with a complete REST API and the Webhook event system, allows covering advanced use cases that go beyond the previous six sections.

Some of the highlighted possibilities include:

• Code validation via REST API as a participation requirement.
     
   Example: Integrate Easypromos into a WhatsApp chatbot, where the user enters a code and the API validates whether it is correct. If valid, it determines if the user has won an Instant Win prize.
     
• Completing entries in Check-In type stages via REST API.
     
   Example: Connect Easypromos with the client’s purchase system. Each time a user buys a product, they are automatically registered in Easypromos, awarding points or virtual currencies.
     
• Querying requirements with virtual coins.
     
  Example: A betting app reports to Easypromos whenever a user places a bet. Through the API, it checks if the user has reached 5 bets, and if so, unlocks access to a prize wheel.
     
• Querying points of sale for a promotion via API.
     
   Example: A brand launches a promotion in which users win digital coupons redeemable at physical stores. Easypromos handles all the logic, and the client can also display a map on their website with the points of sale obtained directly from the API.

In short, using only the REST API, Easypromos can operate as a backend promotion management system: code validation, prize assignment, fraud control, scalability, concurrency, user notifications, and prize delivery management, without needing to use the platform’s frontend features.

REST API Specification.