New Easypromos API for Developers

Posted in: Business newsLast update: 12/07/17

We’ve launched an updated version that makes the use of and the integration with our API easier. The Easypromos API allows developers to program automatic export of the users that register in a promotion to integrate the data in external or third party platforms.

The main use of the Easypromos API in promotions is for developers to be able to automatically export the data of the users who register in their promotion and have a software process and make use of this data. For example:

  1. Integrate the user data in a CRM
  2. Real-time validation of user data against an external database
  3. Integrate the users in third party platforms.
  4. Create customized displays, like photo or video galleries, of the participation data Easypromos register.

The use of the API is important because it allows agencies and brands to make the use and the storage of leads and data captured through promotions, contests and sweepstakes on social media automatic.

Note: The API to export user data is only available for White Label promotions. White Label is the most complete version of Easypromos that includes tools for developers like API access, webhooks or tools to customize the design of the promotion via CSS, JS or custom HTML.

Below we’ll explain the news of the new API we’ve launched:


API on account level and not on promotion level

Previously we had an API system that allowed the administrators of a promotion to extract the user data. This was done through an access token that changed per promotion.

The big news is that we’ve moved this access token to account level in Easypromos. We learned that this solution was more intuitive and gave better control and a better experience when integration Easypromos with other platforms or when developing own software through the API.

Now the developers can for example create a unique access token to access the list of all promotions they administer and the list of users in each promotion.

The redesign of the API to account level enables us to be prepared to expand it with new functions (endpoints) that allows the administrators to have access on API level to the same features that you have through our web interface of the management of the promotion.


Security in access control to the API

The update also offers the administrators better control since the access permissions to the API can be defined on promotion level (endpoint) and also on time level. This makes it easy for the account administrator to create new access tokens and define the resources and time of the access. The administrator can revoke and eliminate an access token at any time. For security reasons, a log of all accesses through the API and each access token is also saved internally.


New online documentation

The new API comes with new online documentation with information that’s prepared for the expansion.


Additional specification with Webhooks

The specification in the response to the different calls to the API is totally complementary with Easypromos Webhooks. Webhooks is a feature on promotion level that allows to send user data of promotion participants in real-time to an external server. More information about Easypromos Webhooks.


Support to the integration with external platforms

If you require support to the integration of the data captured in promotions in external platforms, please contact us. We’ll be pleased to hear about your system and see how we can help you.



Randi Jensen

International Business Developer in Easypromos