Affiliates API

Affiliates

The Affiliates API plays a crucial role in managing partners that have onboarded your affiliate programs. Each partner within your program is associated with a unique Affiliate Object, which encapsulates a rich set of information. This data, including their email address, the specific affiliate program they're part of, and their current balance.

One of the key functions provided by the Affiliates API is the ability to manage affiliates effectively. This includes abilities to approve or decline affiliates' applications, reflecting your discretion in forming business relationships. You have the capability to offer bonus payments, bolstering your affiliates' motivation and potentially improving their performance. Conversely, the API also supports the deduction of amounts from their balances, facilitating the management of situations like erroneous payments or policy breaches.

The API additionally grants the ability to remove affiliates from their associated programs. This could be critical in scenarios such as the termination of partnerships or the breach of affiliate agreements.

API Endpoints

Description

Method

URL

POST

/v2/affiliates/approve/:id

POST

/v2/affiliates/decline/:id

GET

/v2/affiliates/retrieve/:id

DELETE

/v2/affiliates/:id

GET

/v2/affiliates/list

GET

/v2/affiliates/blocked/:id

Add Bonus

POST

/v2/affiliates/bonus/add/:id

POST

/v2/affiliates/bonus/deduct/:id

POST

/v2/affiliates/unblock/:id

GET

/v2/affiliates/payouts/list

GET

/v2/affiliates/payouts/retrieve/:id

Send Email

POST

/v2/affiliates/send-email/:id

Webhook Events

There are four webhook notification events associated with the Affiliates API.

  • affiliate-approved
  • affiliate-declined
  • affiliate-signup
  • affiliate-removed

You can see examples of notification events here:

Permissions

The default set of permissions are view, edit and remove.