Connect ReferralHero to Your AI Agent

Ask your AI assistant to work with ReferralHero: review referral campaigns and subscriber rankings.

Try a ReferralHero Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill ReferralHero

Review campaign leaders

Read the top subscribers and configured rewards.

/oo ReferralHero: Get ReferralHero leaderboard for campaign [campaign ID] with count [number], then list rewards and summarize returned rankings.

Review a subscriber

Read a verified subscriber record.

/oo ReferralHero: Get ReferralHero campaign [campaign ID] subscriber [subscriber ID] and explain its returned referral fields.

Start Working with ReferralHero

Install OOMOL

Set up oo CLI and the oo Skill in your agent.
Install OOMOL →
Connect ReferralHero

Connect using your ReferralHero API Token.
Connect ReferralHero →
Give Your Agent a Task

Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →

Choose Your Agent

Codex Claude Code Cursor Hermes

An account with access to the ReferralHero resources used in your task.

ReferralHero Tools

ReferralHero exposes campaigns, subscribers, rewards, and conversion operations for an AI assistant to review referral participation.

Review campaign leaders

Read the top subscribers and configured rewards.

Review a subscriber

Read a verified subscriber record.

11 tools

Create List

Create a ReferralHero referral campaign with a name and default referral URL.

referralhero.create_list

List Lists

List active ReferralHero referral campaigns in the connected account.

referralhero.list_lists

Get Leaderboard

Get the highest-ranked subscribers in a ReferralHero campaign.

referralhero.get_leaderboard

List Rewards

List the rewards configured for a ReferralHero campaign.

referralhero.list_rewards

Add Subscriber

Add a subscriber to a ReferralHero campaign using its configured identifier.

referralhero.add_subscriber

List Subscribers

List subscribers in a ReferralHero campaign with pagination and optional sorting.

referralhero.list_subscribers

Get Subscriber

Retrieve one verified ReferralHero subscriber by ID.

referralhero.get_subscriber

Update Subscriber

Update fields on one verified ReferralHero subscriber.

referralhero.update_subscriber

Delete Subscriber

Delete one subscriber from a ReferralHero campaign.

referralhero.delete_subscriber

Track Conversion

Track the second conversion event for a two-step or three-step referral campaign.

referralhero.track_conversion

Confirm Referral

Confirm the third conversion event for a verified ReferralHero subscriber.

referralhero.confirm_referral

Frequently Asked Questions

Can I create a referral campaign?

create_list creates a campaign using name and website as its default referral URL.

Does track_conversion record the final conversion?

It records the second event for two- or three-step campaigns; confirm_referral records the third event for a verified subscriber.

Does adding a subscriber always use email?

Use the identifier configured for the campaign rather than assuming a universal email identifier.