πŸ“‹Affiliate Applications

Projects can require potential affiliates to apply before joining their referral program. This gives you control over who promotes your project and lets you vet applicants before granting access.

How it works

  1. Build an application form β€” Use the visual Form Builder to create custom fields (text, email, number, select, and more)

  2. Affiliates apply β€” Potential affiliates submit the form with their information

  3. Review applications β€” Your team reviews applications in the dashboard and approves, rejects, or puts them on hold

  4. Approved affiliates join an audience β€” Approved applicants are added to a specific audience, which can have its own reward tiers and rules

Form Builder

The Form Builder lets you create and edit your application form visually β€” no code required. Access it at Participants > Affiliate Applications > Configure Form.

Supported field types

Text, Email, Textarea, Number, Select, Radio, Checkbox, URL

What you can configure per field

  • Label, placeholder, and description

  • Required vs optional

  • Options list (for Select and Radio fields)

  • Validation rules: minimum/maximum length, min/max value, regex pattern

Other capabilities

  • Drag & drop reordering β€” rearrange fields by dragging them

  • Live preview β€” each field shows how it will render for applicants

  • Enable/Disable toggle β€” pause the form without deleting it. Disabling shows a confirmation and automatically rejects new submissions while disabled

  • Unsaved changes protection β€” warns before navigating away with unsaved edits

circle-info

When no form is configured yet, the Affiliate Applications view shows an empty state with a Create Form button to get started.

Application statuses

Status
Description

Pending

Application received, awaiting review

Approved

Affiliate accepted β€” added to a designated audience with access to the referral program

Rejected

Application declined β€” a rejection reason can be provided

On Hold

Application saved for later review

circle-info

All status decisions can include admin notes for internal record-keeping. Batch operations are available for processing multiple applications at once.

Managing applications

Applications are managed in the dashboard at Participants > Affiliate Applications. The management view includes:

  • Summary cards β€” Quick overview of total, pending, approved, rejected, and on-hold applications

  • Applications table β€” Dynamic columns based on your form fields, plus address, date, status, and admin notes

  • Search and sort β€” Find applications by user identifier, sort by date or status

  • Bulk actions β€” Select multiple applications and approve, reject, or hold in batch

Audience assignment

When approving an affiliate, you select a static audience to add them to. This audience determines what reward structure the affiliate receives (tier, multipliers, payout rules).

circle-check

API integration

Projects can also accept affiliate applications programmatically through the API β€” for example, to embed the application form in a custom frontend.

Retrieve the form configuration to render it on your site (API referencearrow-up-right):

Submit an application on behalf of a user (API referencearrow-up-right):

circle-info

Both endpoints are public β€” no API key required. The submission endpoint is rate-limited to 10 requests per 60 seconds per user identifier.

Last updated