# ReferralHero API Documentation

This is the complete API documentation for connecting to the ReferralHero API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **ReferralHero connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/referralHero/actions/{actionSlug}/run
```

## ReferralHero actions

- POST `add-subscriber` Add Subscriber
- POST `create-coupon-group` Create Coupon Group
- POST `create-coupons` Create Coupons
- POST `create-list` Create List
- DELETE `delete-subscriber` Delete Subscriber
- GET `get-list-leaderboard` Get List Leaderboard
- GET `list-all-level2-referrals` List All Level 2 Referrals
- GET `list-coupon-groups` List Coupon Groups
- GET `list-coupons` List Coupons
- GET `list-level1-referrals` List Level 1 Referrals
- GET `list-level2-referrals` List Level 2 Referrals
- GET `list-level3-referrals` List Level 3 Referrals
- GET `list-list-rewards` List List Rewards
- GET `list-lists` List Lists
- GET `list-referred-subscribers` List Referred Subscribers
- GET `list-rewards-for-all-subscribers` List Rewards for All Subscribers
- GET `list-subscriber-rewards` List Subscriber Rewards
- GET `list-subscribers` List Subscribers
- GET `retrieve-subscriber-by-email` Retrieve Subscriber by Email
- GET `retrieve-subscriber-by-id` Retrieve Subscriber by ID
- GET `retrieve-subscriber-by-mwr` Retrieve Subscriber by MWR
- POST `track-bulk-transactions` Track Bulk Transactions
- POST `track-single-transaction` Track Single Transaction
- PUT `update-subscriber` Update Subscriber