Returning.AIDocs
v1

Features / Earn

.md

Social quests

Members can earn coins or XP through supported actions on your connected social accounts. Checks and available actions vary by network: some happen inside the widget and others use Verify.

Last checked 29 Sep 2026

Category
Earn. Members do not spend coins to take part.
Your cost comes from
Configured action and post rewards, connected members, and the posts and accounts that become earnable.
Rewards are credited
After a qualifying action or verification processes successfully, without manual review. Network or processing failures can delay crediting.

What members see#

  1. Open Socials in the member portal or an embedded Socials widget.
  2. Connect a social account or enter an Instagram username. A configured connect reward normally pays once per network after successful processing.
  3. Find a supported action in a connected account's feed. Up to eight posts appear per account at once.
  4. Complete the action and press Verify where the network requires it. Some actions happen inside the widget.
  5. After successful reward processing, coins and XP appear in the member's normal balance.
Illustration: A member connects a supported network before its quests appear. Example reward amounts are synthetic.
Illustration: An example X post with available, completed and claimed states. The post and rewards are examples; this is not a product screenshot.

Ordinary repeat verification does not pay an existing reward twice. Post rewards are scoped to a post, action and connected account. Follow rewards are per connected page, and connect rewards are per network in the community. Reversals are separate, so these rules are not a lifetime spending cap.

What you control#

Connect your organisation's account on a supported network, then configure its Social Quests tab. A tab without an account shows “No account connected.”

Which action works on which network

Social action support by network
NetworkConnectFollowLikeCommentShare or repost
InstagramEnter a usernameNoNoYesNo
FacebookYesNoYesYesNo
LinkedInYesNo admin settingIn widgetIn widgetIn widget
XYesYesIn widgetIn widgetIn widget
YouTubeYesSubscribeNoRecent commentsNo

Instagram checks the comment, not a like. Facebook has no member follow quest. X follow starts at zero reward, so set an amount before offering it. YouTube comment checks search recent comments and stop paging after reaching older comments; members should verify soon after posting.

Social quest settings
SettingWhat it does
AccountSelect the connected community account for this network. Several accounts per network are supported. Member connection is separate; Instagram members enter a username.
Enable SocialsThe master switch for this network. When off, its quests do not pay.
Default Earning Methods and Rewards AdjustmentsConfigure XP and coin amounts for supported actions. Rows have display switches and start off in the admin. Before enabling a network, review account and post amounts; set unwanted rewards to zero.
Maximum No. of ActionsThis field does not create repeatable quests or a campaign budget. Existing rewards normally block another payment for the same action, post and account.
Custom Earning Methods & AdjustmentsOverride reward amounts and comment criteria for a displayed post. Turning the override off returns it to the defaults; Reset Settings for All Displayed Posts to Default clears every override.
Default Criteria for CommentsSet a minimum word count and optional keyword rules: Contains All, Contains Any or Exact Match. Test the exact wording and punctuation you plan to accept.
Role PermissionsChoose which members, roles or tags can see the connected account's quests.
Enable PenaltySet supported reversal checks. Rows start off; the suggested multiplier is 2x, with a minimum of 1x. A detected reversal can deduct more than the remaining balance. Coverage varies by network and age of the action.
Post DisplayAutomatic displays the latest posts. Custom lets you choose and reorder up to eight posts. Only displayed posts can earn.
Starting amounts and comment criteria

These are prefilled admin amounts in XP / coins, not a recommended budget. Rows start switched off in the admin. Review all account and post amounts before enabling a network.

Prefilled social reward amounts in XP and coins
NetworkConnectFollowLikeCommentShare
Instagram10 / 10Not offeredNot offered10 / 6Not offered
Facebook10 / 10Not offered10 / 106 / 6Not offered
LinkedIn10 / 10Not offered10 / 106 / 66 / 6
X10 / 100 / 010 / 106 / 66 / 6
YouTube10 / 106 / 6Not offered6 / 6Not offered

Comment matching ignores case and normalises common punctuation and emojis. Test the exact words and punctuation you plan to accept with the saved post.

Check each network's rules

Network rules on rewarding engagement can differ and change. Check the current rules for every network and action before offering coins or XP for follows, likes, comments or shares.

How members are paid#

  • Verify and pay: for actions completed on the network, Verify checks available evidence. For supported actions inside the widget, the action response is used. Successful processing updates balances and history without staff approval; failures may need a retry.
  • In-widget actions: supported X and LinkedIn likes, comments and reposts occur inside the widget and pay when the network accepts them.
  • Ordinary repeat checks: an existing reward blocks duplicate payment. Post rewards are scoped to the action, post and connected account; connect and follow have network and page scopes.
  • Displayed posts only: a post that rotates out of the feed can no longer earn through that quest.
  • Comments: verification checks the latest matching comment returned by the network. A member can correct a failed comment and retry; Instagram may need a new comment. Use Test Comment where available.
  • Zero reward: set an unwanted action to zero XP and zero coins on every relevant account and post, then verify the saved configuration.
  • Penalties: where supported and enabled, a later detected reversal can deduct the original reward times your multiplier. Coverage and timing vary; do not treat it as a complete control.

Ways to use it#

These are example setups. Use only the actions supported on your chosen network, then check that network's current engagement rules.

Content

Weekly insight comments

20 coinsexample per comment

  • Select one or two recent analysis posts.
  • Use a minimum word count and matching words.
  • Budget per commenter and displayed post.

Suits Teams with regular market content.

Watch Verification uses the latest matching comment returned by the network.

Education

YouTube tutorial comments

8 wordsexample minimum

  • Select tutorial videos in Custom display.
  • Ask a question that learners answer in comments.
  • A subscribe quest can be a separate entry action.

Suits New-trader education.

Watch Watching is not a supported quest action. Check network rules before rewarding comments or subscriptions.

Event

Launch post boost

80 coinsone-account example total

  • On X or LinkedIn, pin an event post in Custom display.
  • Set supported like, comment and repost rewards.
  • The example uses 20, 30 and 30 coins for ordinary completion on one account.

Suits A dated announcement or event.

Watch A Custom post stays earnable while displayed with non-zero rewards. Remove it or clear rewards when the campaign ends.

Always on

Regular feed rewards

8 postsvisible per account

  • Use automatic recent-post display.
  • Keep supported action rewards modest.
  • Confirm audience eligibility and budget controls before a restricted launch.

Suits Communities with frequent posts.

Watch Eight posts at 25 coins each total 200 coins for one completion per post on one account. More posts or accounts add opportunities; penalties are supplementary.

Community

Chat-group join

Milestonesuse a submission

  • Social quests cannot verify chat-group membership.
  • Create a milestone submission for proof such as a screenshot or username.
  • An admin approves it, with an attempt limit.

Suits Members joining a chat community.

Watch Budget staff review time as well as the milestone reward.

Planning your economics#

At the example rates, 500 participants and 12 posts generate an estimated 54,000 engagement coins or $270.00 per month. Their initial connect and follow actions add 15,000 coins or $75.00. Change the assumptions below.

Planning tool · not the admin panel

Quest budget planner

Plan initial connection rewards and monthly post engagement using your own completion estimates.

1 · Your audience

Confirm who can qualify for rewards before using this as a cost boundary.

%

Connection estimate assumes connect and follow rewards on each modelled network. Check the support matrix.

Model one account's Automatic feed. At most 8 posts appear at once.

2 · Rewards in coins
3 · Completion rates

Your estimates for the share of participants doing each action on each displayed post.

%
%
%
%
4 · Value
$

200 coins ≈ $1.00

Monthly engagement coins

54,000 coins

$270.00 coin face value

Initial connect and follow
15,000 coins · $75.00
One pass of modelled posts
264 coins · $1.32
Coin face value per paid engagement
$0.041
Coin face value per estimated net-new follower
$0.083
These dollar figures value issued coins. Actual cash cost depends on redemption and fulfilment. Monthly post rewards model one connected community account; more connected accounts or posts add coins. These are planning estimates, not a spend limit built into the platform.

How it adds up

Participants500Members times link share
Coins per post9Expected per participant
Paid actions6,600Per month
Trading equivalent540 FX lots

One pass through the modelled posts

One-account post rewards264 coins$1.32 · 2.64 lots
Initial connection and follow30 coins

Participants are planned audience size times link share. Monthly coins are participants times posts times expected coins per post. Coin face value per paid engagement divides the monthly value of issued coins by estimated paid actions.

Example assumptions: 100 coins per FX lot and a $0.005 coin value. Monthly post rewards model one account; initial connect and follow rewards use the average networks linked. Other accounts and posts can add cost. This is not an enforced cap.

Timing and limits#

  • If verification is already in progress or a network is delayed, members may be asked to retry. Follow the message shown.
  • Automatic display uses up to eight recent posts per account. Refresh Posts requests an update; network availability can delay it. A post earns only while it stays displayed.
  • YouTube comment checks search recent comments and stop paging after reaching older comments. Older comments may not be found.
  • Penalty checks skip LinkedIn, posts no longer displayed and checks without usable network evidence. Deleted-comment checks have a five-day age limit. Confirm the live schedule separately.
  • Social coins enter the normal member wallet and can be spent in the Store like other coins.
If a YouTube quest will not verify

For a subscription or comment, first check that the member is using the connected YouTube account and the exact channel or video shown in the quest.

Not supported yet#

What is not a social quest

Telegram-style group joins, Discord or WhatsApp membership, link visits, video watching, quizzes, proof uploads and admin-reviewed tasks belong outside Social Quests. For a join task, use a Milestones custom condition with a member submission and admin approval.

  • Not supported

    Additional networks

    Social Quests supports the five networks in the matrix above, not Telegram, Discord, WhatsApp or other networks.

  • Not supported

    Unsupported action combinations

    There is no Instagram like or follow quest, Facebook follow quest, or LinkedIn follow setting in the admin.

  • Not supported

    Repeatable and sequenced quests

    Ordinary repeat checks of an existing reward do not pay twice. There is no daily repeat or built-in follow-then-comment sequence.

  • Not supported

    Campaign dates and budgets

    Quests have no start or expiry date, campaign budget or total-spend cap. Posts only earn while displayed.

  • Not supported

    Comment relevance

    Word count and keyword checks exist, but a semantic relevance check is not active.

  • Not supported

    Public quest-management API

    There is no published API for creating social quests or reading quest completion state.

For your developers#

No social quest management endpoints are published. These published reads can help you reconcile member activity and balances.

Example prizes, reward rates and planner figures are synthetic planning assumptions, not Returning.AI defaults or a rate card. Configuration limits and stated admin defaults are identified in the guide.