Skip to main content
POST
/
v1
/
referrals
/
{campaignId}
/
members
/
{memberId}
/
holders
Add Referral Code Holders with Campaign ID
curl --request POST \
  --url https://{cluster}.voucherify.io/v1/referrals/{campaignId}/members/{memberId}/holders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>' \
  --data '{
  "holders": [
    {
      "source_id": "cst-prsn01",
      "name": "Alex Doe",
      "email": "alex-doe@your.domain.com",
      "country": "England"
    },
    {
      "source_id": "cst-prsn02",
      "name": "Alex Joe",
      "email": "alex-joe@your.domain.com",
      "country": "Wales"
    }
  ],
  "metadata": {
    "influencer_code": true
  }
}'
{
  "holders": [
    {
      "id": "rh_0f198761748966ffab",
      "created_at": "2024-07-23T10:40:48.579Z",
      "redeemable_id": "v_uOrG9tQresN9X51gbAoo0a2vY4MLV9lS",
      "redeemable_object": "voucher",
      "campaign_id": "camp_vVk4unz3k4gA023fk9XoSiTh",
      "campaign_type": "REFERRAL_PROGRAM",
      "voucher_type": "DISCOUNT_VOUCHER",
      "customer_id": "cust_r8yoJtgAAF2pqU1yuICtk9bv",
      "holder_role": "REFEREE",
      "object": "redeemable_holder",
      "metadata": {
        "influencer_code": true
      }
    },
    {
      "id": "rh_0f198761748966ffac",
      "created_at": "2024-07-23T10:40:48.579Z",
      "redeemable_id": "v_uOrG9tQresN9X51gbAoo0a2vY4MLV9lS",
      "redeemable_object": "voucher",
      "campaign_id": "camp_vVk4unz3k4gA023fk9XoSiTh",
      "campaign_type": "REFERRAL_PROGRAM",
      "voucher_type": "DISCOUNT_VOUCHER",
      "customer_id": "cust_uCLPtbQkQayw6t40O9IMPQzV",
      "holder_role": "REFEREE",
      "object": "redeemable_holder",
      "metadata": {
        "influencer_code": true
      }
    }
  ]
}

Authorizations

​
X-App-Id
string
header
required
​
X-App-Token
string
header
required
​
Authorization
string
header
required

Path Parameters

​
campaignId
string
required
Example:
​
memberId
string
required
Example:

Body

application/json
​
holders
Customer Id And Source Id · object[]
required
​
metadata
object

Response

​
holders
Customer Redeemable · object[]
required