Facebook Actions


This documentation covers the actions and integrations that we support from Facebook.

Applications that support Facebook actions:

Want to run a Facebook contest but not sure where to start? Check out everything you need to know about running Facebook contests with Gleam including powerful demos, best practice examples, feature breakdowns and expert guides.


If a user tries to login or perform any Facebook actions that require authentication then they will be asked to authorize the Gleam Competitions Facebook app.

Facebook authorization page for Gleam


The Facebook Check-in action allows you to award an entry if users check-in or have previously checked-in to a specific location on Facebook.

This action is perfect for local businesses, or businesses that have a physical location that users can check into. It's also a fantastic way to incentivize loyal customers.

Admin View

Gleam interface showing check in Facebook tab

Public View

This action cannot be validated automatically because Gleam does not have access to the entrant's Facebook posts

Entry / Login / Connect

The Facebook Entry action allows you to award an entry for logging into Facebook within the widget. The action has two states, you can award the entry right away, or you can optionally ask the user to Like your Facebook page after login.

This option is preferrable to the Visit action if you are running a contest inside a Facebook Tab, as it will keep users on your Tab rather than sending them away unnecessarily.

Admin View

Gleam interface showing Facebook tab

Public View

Visit a Page

The Facebook Visit action allows you to ask a user to visit a specific Facebook page. If they like the content they might interact with your page or comment on some of your posts. They will also have the option to Like the page after visiting, this is a completely optional step.

Admin View

When setting up the action you will need the URL of the Facebook page, the name of the page then any specific instructions for the user to complete.

You also have the option to ask users to:

  • Optionally Like a Facebook Page
  • Spend x seconds on the Facebook Page
  • Optionally answer a question about the Facebook Page

Gleam interface showing visit Facebook tab

Public View

Users cannot complete the action until they visit the Facebook page, after which they can show their appreciation by also Liking it (provided they like the content).

Liking is a completely optional step & cannot be mandatory for the action to be completed.

Like a Page

This Facebook Like action has now been retired & replaced the by the Facebook Visit action. For more information see our blog post.

Select a Photo From Facebook

Gleam makes it easy to run photo competitions - The Facebook photo select action allows you accept photo submissions from a users Facebook feed or albums as a competition entry or to unlock a reward.

Admin View

This action is very easy to setup, just give it a title (i.e. Select a Photo From Facebook or Show Off Your Latest Style) then give the user some instructions.

Tip: You can use the description to make it clear to the user that the photo must first exist on Facebook before they are able to select it for submission.

Gleam interface showing select a photo Facebook tab

Restrict Selection to #hashtag

This will only show the user any photos that contain a specific #hashtag. If the user only has 1 photo with the required #hashtag then the action will automatically complete, if there's more than 1 then the user will be allowed to choose which to submit.

Automatic Imports

You can setup the Facebook Select action to automatically import photos from certain Facebook sources on the Business plan:

  • Posts to Page: Import photos that have been posted publicly to any Facebook Page
  • Post Comments: Import photos that have been posted pulicly in the comments of any Facebook Post or Photo

Public View

When the user clicks the action we ask them to authenticate with Facebook (if they haven't already), then they will be able to choose from their last 21 Facebook photos to submit.

Facebook Photo / UGC Galleries

Gleam has the ability to send images submitted from the Facebook Selection action into a beautiful photo gallery.

The Gallery can be installed inside a Facebook Tab or even embedded on your own website.

Gleam gallery inside Facebook tab

You can do this by selecting Galleries in the left hand menu, creating a new gallery & choosing the campaign which feeds it photos on the Import tab. You can also choose to automatically show all photos or put them into a moderation queue before they appear in the gallery.

Check out this guide for more information on how to setup a Photo Contest on Gleam.

View Post

Draw attention to a specific Facebook Post or Video with the View Post action, users are welcome to optionally engage with the post if they find the content meaningful.

Admin View

Gleam interface showing view post Facebook tab

Public View

Viral Share

One of the most requested action types is asking users to share something on their personal timeline, however Facebook's policies do not permit you to directly give entries for this. This means that you can't give an entry for sharing a link, but you can give entries to users when they successfully refer a user via a shared link.

You can get users to share your competition on Facebook using our Viral Share action type. This will give users entries when they refer friends who successfully enter the competition.

Please note, users will not see an increase in entries until they sucessfully refer someone that enters. Regardless of how many time they share your link.

Admin View

There's quite a few options to setup this particular action. First give it a title, how you define the title can greatly impact whether or not people will share it.

The second option allows you to lock the Viral Share until the user completes a certain number of other actions first. For example you may not allow users to share until they first like you on Facebook or join your email list.

You can choose to show the share option with any mandatory action types you have created. However the share itself won't count towards a mandatory action (but will still allow users to do it).

Gleam interface showing viral share tab

The default share text is used for everything except Facebook sharing, the text you see here is pulled from the description on your prize. This allows you to have separate text for both Twitter & Facebook.

Public View

This is what the users will see, they are free to take the link generated & share it wherever they want. You also have control over which sharing buttons are present by default.

Share View

If a user shares to Facebook this is the popup they will see, there's a few important areas to cover here.


By default we use the prize image as the og:image that gets shared on Facebook. If you want this image to show you must have a feature image that is at least 287px high.

If you want the image to work perfectly when someone Virally Shares on Facebook then use 1080px x 567px.

Custom Share Image

Business users have the ability to add a Custom Share image to the campaign. This means you can make your Feature Image whatever size you wish (or use the Carousel).

The recommended Facebook Image Size for the custom share image is 1200 x 630.


We currently pull the description for the Facebook share from your Prize. However if you set the Default Share Text during the setup of the action that will be used for everything except Facebook.

Gleam Facebook share popup

Facebook Competition Example

We've created an example competition that you can play with, it contains all of the actions that we've covered in this guide.

Facebook Contest Guides

We have a number of other resources and guides that can help you get more out of your Facebook contest with Gleam.

40+ Facebook Contest Tips + Tricks Using Gleam

Our tips for running a facebook contest. Gleam

The Ultimate Guide to Running a Facebook Contest

Running a facebook contest. Gleam

Facebook Photo Image Size Guide

Facebook photo size guide. Gleam

Known Facebook Issues

Invalid Page ID

There will be certain scenarios when we're unable to find the PageID for a particular page due to their settings. In this instance you will be required to enter the PageID manually.

On Facebook The PageID is located here: Edit Page -> Edit Settings -> Page Info -> Facebook Page ID

Gleam interface showing invalid page ID

Pages With Location Restrictions

Having certain country or strict age restrictons on a page can make it appear blank when users try to like it within the widget.

Country restrictions facebook tab

Facebook Groups

It is not possible to put in a Facebook group page into the Facebook Visit action type, you can just use a normal Visit action.