This article is part of our Playground series, where you can learn how to use BeeLiked's API without needing an Account of your own. See the Playground Introduction page for details


We have set up the following Spin the Wheel promotion as a Private Promotion (entry is only possible with unique one use InviteLinks). The promotion has the entry page turned off and so users are not asked for any additional information before being able to spin the wheel.

To enter this promotion, you will need to generate an InviteLink.

Promo ID: 23246

Promo Name: Lucky Wheel Private

The promotion is set up with placeholders to display:

  • First Name {{entrantField(‘first-name’,‘Welcome’)}}

  • Company {{entrantField(‘company’,‘your company’)}}

The placeholders (shortcodes) on the promotion have default text incase data is not sent, this prevents word gaps on the promotion text.

Other personal information is expected but is not displayed on the promo pages

  • Last Name

  • Email Address (this is a Unique Identifier or UID)

POST PARAMETERS

https://api.beeliked.com/v1/addons/entry-links

Field

Type

Description

promotion_id

Integer|Required

Promotion identifier

uid

String (optional, generated when not provided)

Unique identifier of the audience member

uid_field

String (required when uid is provided)

Field used as uid

field_values

Array|Object (optional)

Object containing the form field slugs as keys and data as values

Here's an example

curl \ -X POST https://api.beeliked.com/v1/addons/entry-links \ -H 'Accept: application/json' \ -H "Authorization: Bearer <Your Generated Token>" -d '{ "promotion_id": 23246, "uid": "johndoe@acme.com", "uid_field": "email", "field_values": { "first-name": "John", "last-name": "Doe" }}'

For Retrieving uid_field value we need to call this endpoint,

curl \ -X GET https://api.beeliked.com/v1/promotions/23246 \ -H 'Accept: application/json' \-H "Authorization: Bearer <Your Generated Token>"

Which will give us the number of fields available in that promotion, it will have an attribute is_uid_field.

If the is_uid_field is true then we have to use the slug attribute value ,i.e, for this promotion is email.

The invite-links can be personalized for users and also can be anonymous. If we add the uid and uid_field it creates a personalized invite-links and if the uid is not provided in the request it creates an anonymous invite-link.

See API documentation for more information or install our Postman example


Here are some other relevant articles that may be useful:

Getting started with BeeLiked's API

API Playground - An introduction to this free resource for developers

Personalization - setting up placeholder text in your promotions

API Playground - Retrieving users contact data and permission marketing preferences

API Playground - creating variable text or imagery in private (invite only) promotions

Preview and test your promotions in draft mode

Did this answer your question?