Skip to main content
Event types follow the format {entity}.{action} (e.g., promoter.created). When subscribing, you provide the exact event type strings you want to receive.

Promoters

Event typeDescription
promoter.createdA new promoter signed up or was created via the API.
promoter.updatedA promoter’s account details were changed.
promoter.deletedA promoter was deleted.
promoter.profile.updatedA promoter’s profile fields (name, address, etc.) were updated.
promoter.balance.updatedA promoter’s earnings, current, or paid balance changed.

Promoter campaigns

Event typeDescription
promoter_campaign.createdA promoter was added to a campaign.
promoter_campaign.updatedA promoter’s participation in a campaign was changed (e.g., status, ref_id).
promoter_campaign.deletedA promoter was removed from a campaign.

Referrals

Event typeDescription
referral.createdA new referral (lead or customer) was tracked.
referral.updatedA referral’s details changed (e.g., status, plan, cancellation).
referral.deletedA referral was deleted.

Commissions

Event typeDescription
commission.createdA new commission was created.
commission.updatedA commission was updated (e.g., approved, denied, amount changed). The changes field in the payload contains the specific fields that changed.
commission.deletedA commission was deleted.

Payouts

Event typeDescription
payout.createdA new payout was created.
payout.updatedA payout was updated (e.g., marked as paid).
payout.deletedA payout was deleted.
payout.commissions.createdA commission was added to a payout.
payout.commissions.updatedA payout commission record was updated.
payout.commissions.deletedA commission was removed from a payout.

Payout methods

Event typeDescription
payout_method.createdA promoter added a new payout method.
payout_method.updatedA payout method was updated.
payout_method.deletedA payout method was removed.

Payments batches

Event typeDescription
payments_batch.createdA new payment batch was created.
payments_batch.updatedA payment batch was updated.
payments_batch.deletedA payment batch was deleted.

Contract documents

Event typeDescription
contract_document.signedA promoter signed a contract document.