Skip to main content
POST
/
v1
/
partner_referral_links
Create referral link
curl --request POST \
  --url https://api.example.com/v1/partner_referral_links
{
  "data": {
    "id": "ref_456",
    "key": "ref_456",
    "url": "https://partnero.com?aff=ref_456",
    "default": false,
    "is_additional": false,
    "direct_tracking": false,
    "direct_tracking_redirect": false,
    "direct_tracking_redirect_url": null
  },
  "status": 1
}

Endpoint

POST https://api.partnero.com/v1/partner_referral_links

Request Body

ParameterTypeRequiredDescription
keystringYesUnique key for the referral link
domain_idstringNoDomain ID (from domains endpoint)
is_additionalbooleanNo*Required when domain_id is present
partnerobjectYesPartner to assign the link to
partner.idstringYes*Partner ID (or use key/email)
partner.keystringYes*Partner key (or use id/email)
partner.emailstringYes*Partner email (or use id/key)

Request

cURL
curl --location 'https://api.partnero.com/v1/partner_referral_links' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "partner": {
      "id": "partner_123"
    },
    "key": "ref_456"
  }'

Response

{
  "data": {
    "id": "ref_456",
    "key": "ref_456",
    "url": "https://partnero.com?aff=ref_456",
    "default": false,
    "is_additional": false,
    "direct_tracking": false,
    "direct_tracking_redirect": false,
    "direct_tracking_redirect_url": null
  },
  "status": 1
}

Get Available Domains

Get the list of domains you can use for referral links:
GET https://api.partnero.com/v1/partner_referral_links:domains
{
  "data": [
    {
      "id": null,
      "domain": "partnero.com",
      "url": "https://partnero.com?aff=",
      "is_additional": false
    }
  ],
  "status": 1
}