Skip to content

Review applications

When a creator on the Network applies to one of your Network-listed programs, the application lands in Admin → Network → Requests for you to review.

What you see

Each request card shows:

  • Creator — name + handle (clickable to their public profile)
  • Email + applied to which offering
  • Preferred slug — what they want their share-link path to be (/r/<slug> under your custom domain or theirs); we’ll fall back if there’s a collision
  • Bio — from their Network profile
  • Pitch message — optional note they wrote when applying

Approve

Type a decision note (optional, included in their email) and click Approve + provision.

Behind the scenes:

  1. Network creates a Partnership row linking creator ↔ vendor ↔ offering
  2. Network calls back into your brand instance to create:
    • A Partner row for the creator (email, name, source = openpartner_network)
    • A scoped grant — they can only create Links for the program tied to this offering, not anything else
    • The Link itself with the requested slug (or <slug>-<random> if there’s a collision)
  3. Network emails the creator their share link
  4. They show up in Partners with a “via Network” badge and start with one Link active

The approved row moves out of Pending into the Approved tab. You can still see it for auditability; status flips can be undone from the partner’s row if needed.

Reject

Type a decision note (helpful — explains the rejection in the email they’ll get) and click Reject. The application is closed; no Partner is created on your side. The creator sees the status change in their My applications page on the Network.

A rejected creator can re-apply (they’re not blocked from your offering forever). If you want to permanently exclude someone, just keep rejecting — there’s no shadow-ban currently.

Bulk decisions

Not yet — each request is one click. If you have a flood of applicants and want bulk approval, that’s a feature request worth filing on GitHub.

What changes for the creator on approve

  • They get a share link (with their preferred slug if available)
  • The offering shows up under their My partnerships with live earnings
  • The offering’s detail page swaps from “Apply to promote” to a copyable share URL
  • Their partnerships count on their Network profile increments

What changes for you on approve

  • Partner appears in Admin → Partners with the “via Network” badge
  • They show in Programs for that partner with grantSource: 'offering'
  • Their first Link appears in Admin → Links
  • Once they start driving clicks, attribution + commissions flow as normal

When approval fails

The federation chain (Network → openpartner /partners → openpartner /links) can fail if:

  • Email is already taken on your brand from a previous attempt
  • Program has been deleted on your side
  • Network is unreachable from your instance

The Network responds with 422 federation_failed and the request stays in Pending. You can retry — federation is idempotent by email + offering, so a second approve won’t create duplicates.

If retries keep failing, check the federation_failed detail field for the upstream error. Most issues are configuration-side (missing program, mismatched URL) and resolve once fixed.