# 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

| Network | Connect | Follow | Like | Comment | Share or repost |
| --- | --- | --- | --- | --- | --- |
| Instagram | Enter a username | No | No | Yes | No |
| Facebook | Yes | No | Yes | Yes | No |
| LinkedIn | Yes | No admin setting | In widget | In widget | In widget |
| X | Yes | Yes | In widget | In widget | In widget |
| YouTube | Yes | Subscribe | No | Recent comments | No |

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.

| Setting | What it does |
| --- | --- |
| Account | Select the connected community account for this network. Several accounts per network are supported. Member connection is separate; Instagram members enter a username. |
| Enable Socials | The master switch for this network. When off, its quests do not pay. |
| Default Earning Methods and Rewards Adjustments | Configure 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 Actions | This 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 & Adjustments | Override 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 Comments | Set 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 Permissions | Choose which members, roles or tags can see the connected account's quests. |
| Enable Penalty | Set 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 Display | Automatic 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.

| Network | Connect | Follow | Like | Comment | Share |
| --- | --- | --- | --- | --- | --- |
| Instagram | 10 / 10 | Not offered | Not offered | 10 / 6 | Not offered |
| Facebook | 10 / 10 | Not offered | 10 / 10 | 6 / 6 | Not offered |
| LinkedIn | 10 / 10 | Not offered | 10 / 10 | 6 / 6 | 6 / 6 |
| X | 10 / 10 | 0 / 0 | 10 / 10 | 6 / 6 | 6 / 6 |
| YouTube | 10 / 10 | 6 / 6 | Not offered | 6 / 6 | Not 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.

Launch

### One-time follower drive

120 coins two-page example total

- Offer connect and follow where both actions are supported.
- At 20 connect and 40 follow coins, one page on each of two networks totals 120 coins initially.
- Use Role Permissions for display; confirm eligibility and budget controls before launch.

Suits A newly launched community channel.

Watch Additional pages, post rewards and reversals sit outside this example. Check each network's rules.

Content

### Weekly insight comments

20 coins example 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 words example 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 coins one-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 posts visible 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

Milestones use 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

Members in planned audience

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

Share who link an account %

Average networks linked per participant

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

Posts displayed in month

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

2 · Rewards in coins

Connect account

Follow account

Like post

Comment on post

Share or repost

3 · Completion rates

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

Like completion %

Comment completion %

Share completion %

Already following you %

4 · Value

Value of one coin $

200 coins ≈ $1.00

Coins per FX lot

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

Participants 500 Members times link share

Coins per post 9 Expected per participant

Paid actions 6,600 Per month

Trading equivalent 540 FX lots

#### One pass through the modelled posts

One-account post rewards 264 coins $1.32 · 2.64 lots

Initial connection and follow 30 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](https://docs.returning.ai/features/milestones.md) 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.

- [Get user activity stats Daily net counts of recorded social actions, including deductions after reversals.](https://docs.returning.ai/api-reference/gamification/get-user-activity-stats.md)
- [Search user gamification logs Read social reward and penalty history.](https://docs.returning.ai/api-reference/gamification/search-user-gamification-logs.md)
- [Get daily user XP and coin changes](https://docs.returning.ai/api-reference/gamification/get-daily-user-xp-and-coin-changes.md)
- [Update User XP and Currency Manual balance corrections.](https://docs.returning.ai/api-reference/users/update-user-xp-and-currency.md)

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.
