ReferralHero
  • Welcome to the Support Center
  • Common Questions
  • Features
    • Subscribers
      • Subscriber Profile
      • Unique Identifier
      • Active Visitors
      • 'Quick Add' Referral
      • Update Referral Status
    • Campaign Templates
      • Contest
      • Website Referral Analysis
      • Net Promoter Score
    • Unique Identifier
      • Phone Number
      • Confirmation Email
        • Thank-You Page
    • Automations
      • A/B Test
    • Security
      • Manual Review & Confirmation
      • Secondary Verification Method
      • High Risk
      • Blacklist
      • ReCaptcha
    • Reward
      • Reward Status
      • Advanced Reward Options
      • Transactions
    • Analytics
      • Active Visitors
      • Subscribers
      • Sources
      • Shares
      • Devices
      • Unsubscribers
    • Misc
      • Memorable referral links
      • 1-Click Signup
      • Forward & Refer
      • Coupon Codes
      • Custom Attribution
  • Integrate
    • Embeddable Widgets
      • Custom Domain
    • Integrations
      • Active Campaign
      • Aweber
      • Blockchain
      • Facebook Pixel
      • Calendly
      • Discord
      • HubSpot
      • Intercom
      • KakaoTalk
      • Klaviyo
      • Mailchimp
      • Salesforce
      • SendLane
      • Slack
      • Stripe
      • Tango Card
      • Telegram
      • Tremendous
      • Twilio
      • Typeform
      • Webhooks
      • Zapier
      • Zoho
    • Platform-specific Instructions
      • Google Tag Manager
      • WordPress
      • Webflow
      • SquareSpace
      • ClickFunnels
      • Unbounce
      • Instapage
      • Shopify
      • Carrd
      • WIX
    • Javascript Web API
      • Getting Started
      • Configuration file
      • Callbacks
      • Add a subscriber
      • Add a Pending Referral
      • Track multi-step conversion events
      • Track Transaction
      • Identify a Subscriber
      • Identify a Referrer
      • Generate Dashboard Widget
      • Generate Sharing-Screen
    • ReactJS
    • REST API
      • Errors
      • Webhooks
      • Objects
      • Endpoint Reference
    • Mobile SDKs
      • iOS SDK
        • Getting Started
        • Public Methods
        • Public Classes
        • API Interaction Methods
      • Android SDK
        • Getting Started
        • Public Methods
        • Public Classes
        • Listeners & Interfaces
      • Flutter SDK
        • Getting Started
        • Public Methods
      • React Native
        • Getting Started
        • Public Methods
      • Mobile App Testing in Development Mode
  • API Tutorials
Powered by GitBook
On this page
  • Overview
  • API Endpoint
  • API Token
  • Responses
  • Rate limiting

Was this helpful?

  1. Integrate

REST API

PreviousReactJSNextErrors

Last updated 11 months ago

Was this helpful?

So you are building an integration with ReferralHero. GREAT! We're very excited that you want to add-on to our platform. Before you dive in and start coding, make sure you read this page to know how to structure your app.

Overview

The ReferralHero API is organized around . Our API has predictable, resource-oriented URLs. is returned by all API responses, including errors.

ReferralHero API is in active development, hence expect things to change. We will add new endpoints and change minor details here and there, but if we introduce breaking changes we will notify you at least 2 weeks in advance.

API Endpoint

Calls for ReferralHero API are relative to the URL https://app.referralhero.com/api/v2

API Token

All API calls require the api_token parameter. You can find your API Token in your ReferralHero Account > API Page.

Your API token carries many privileges, so be sure to keep it secret! Do not share your secret API token in publicly accessible areas such GitHub, client-side code, and so forth.

Also, you should write back-end only code, since front-end code will expose your API token and can be used for malicious activities.

All API requests should be made over . API requests without authentication will fail with the error code "no_token".

Responses

  • Data is returned in JSON.

  • Any non-200 HTTP response code can be considered an error.

Rate limiting

Currently, we apply a "soft" limit of 5,000 API calls per hour. Get in touch with us if you need to increase it. If your request rate exceeds our limits, you will receive an HTTP status of 429 with an error code "too_many_calls".

We hope you enjoy using our API and please report any bugs or unexpected behavior :)

REST
JSON
HTTPS