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.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_token).
promoter_campaign.deletedA promoter was removed from a campaign.
promoter_campaign.acceptedA promoter’s campaign application was accepted.
promoter_campaign.pendingA promoter’s campaign participation was set to pending review.
promoter_campaign.rejectedA promoter’s campaign application was rejected.
promoter_campaign.blockedA promoter was blocked from a campaign.
promoter_campaign.inactiveA promoter was set to inactive in a campaign.

Referrals

Event typeDescription
referral.createdA new referral (lead or customer) was tracked.
referral.updatedA referral’s details changed (e.g., state, plan, cancellation).
referral.deletedA referral was deleted.
referral.convertedA referral (lead) was converted to a customer.
referral.cancelledA referral was cancelled.
referral.movedA referral was moved from one campaign to another. Only fires when an affiliate crosses a campaign upgrade/downgrade threshold and the campaign has referral moving enabled.

Commissions

Event typeDescription
commission.createdA new commission was created.
commission.updatedA commission was updated. The changes field in the payload contains the specific fields that changed.
commission.deletedA commission was deleted.
commission.approvedA commission was approved.
commission.pendingA commission was set to pending.
commission.deniedA commission was denied.

Payouts

Event typeDescription
payout.createdA new payout was created.
payout.updatedA payout was updated.
payout.deletedA payout was deleted.
payout.pendingA payout was set to pending.
payout.processingA payout started processing.
payout.completedA payout was completed successfully.
payout.failedA payout failed.
payout.cancelledA payout was cancelled.
payout.commissions.addedA commission was added to a payout.
payout.commissions.removedA 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.
payments_batch.initiatedA payment batch was initiated.
payments_batch.processingA payment batch started processing.
payments_batch.completedA payment batch completed successfully.
payments_batch.failedA payment batch failed.

Contract documents

Event typeDescription
contract_document.signedA promoter signed a contract document.