Objects

List

Your ReferralHero list, also known as your campaign, is where you store and manage all of your subscribers. Your subscribers will always be added to one list and can't be transferred to another list.
Attributes
Example
Attributes
uuid
string
The unique identifier of the campaign
name
string
The campaign name
subscribers
integer
The total subscribers count
created_at
timestamp
Unix timestamp (expressed in UTC) of when the list has been created.
1
{
2
"uuid": "MFae3b657302",
3
"name": "My amazing sweepstake",
4
"created_at": 1487347070,
5
"subscribers": 0
6
}
Copied!

Subscriber

A subscriber is a person who is added to one of your lists. Subscribers belong to precisely one list and can't be transferred.
Attributes
Example
Attributes
id
integer
The unique identifier of the subscriber
name
string
The name of the subscriber
email
string
The email of the subscriber
extra_field
string
The extra field value of the subscriber
extra_field_2
string
The extra field 2 value of the subscriber
code
string
The referral code of the subscriber
position
string
The position of the subscriber in the list (if applicable)
referred
boolean
True if the subscriber has been referred, false if not.
referral_value
number
The monetay value of the referral.
referral_category
string
The type of referral. Useful for creating reports.
transaction_id
string
The unique ID of the transaction. Useful when tracking referrals for purchases.
referred_by
object
An object containing the subscriber's referrer information.
people_referred
integer
The total number of referrals of the subscriber.
promoted
boolean
True is the subscriber is in the "winners" list, false if not.
promoted_at
timestamp
Unix timestamp (expressed in UTC) of when the subscriber has been promoted.
verified
boolean
True if the subscriber has verified their email address, false if not.
verified_at
timestamp
Unix timestamp (expressed in UTC) of when the subscriber has verified their email address.
risk_level
integer
Subscriber's fraudulence level expressed as an integer from 0 (none) to 5 (extremely likely)
points
integer
The number of points of the subscriber
host
string
Url used to generate the referral link.
source
string
The source of the subscriber.
device
string
The decide used by the subscriber to sign up.
created_at
timestamp
The date the participant was added to the campaign (UTC milliseconds)
updated_at
timestamp
Unix timestamp (expressed in UTC) of the last time the subscriber has been updated.
1
{
2
"id": "sub_1564fabfe0bb",
3
"name": "John Doe",
4
"email": "[email protected]",
5
"extra_field": "+1 228374652",
6
"extra_field_2": "USA",
7
"code": "266-18bc5ad8",
8
"position": null,
9
"referred": false,
10
"referred_by": {
11
"id": "sub_42c5283fd538",
12
"name": null,
13
"email": "[email protected]",
14
"code": "208-a4ff5779",
15
"people_referred": 1,
16
"points": 2
17
},
18
"people_referred": 0,
19
"promoted": false,
20
"promoted_at": null,
21
"verified": true,
22
"verified_at": 1491451155,
23
"points": 1,
24
"risk_level": 3,
25
"host": "https://referralhero.com",
26
"source": null,
27
"device": null,
28
"created_at": 1491451155,
29
"last_updated_at": 1491451155
30
}
Copied!

Reward

The Reward Object contains detailed reward information about a single reward that was set up for a campaign.
Attributes
Example
Attributes
title
string
The name of the reward
description
string
The description of the reward
referrals
integer
The number of referrals needed to win this reward
1
{
2
"title": "30% discount on our Pro Plan",
3
"description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
4
"referrals": 2
5
}
Copied!
Last modified 1yr ago
Copy link