Beta — the platform and this API are in beta. The rules on this page are binding; we may add features and tighten validation without notice.

Lead lifecycle

Every lead has one stage, computed by Creator Guard:

stage Meaning You can
draft Submitted; listing, photos and her confirmations are being completed. Every new lead starts here. edit lead and listing, set the fee, withdraw, submit for review
in_review Creator Guard reviews the profile. edit the listing and the fee, withdraw
ready Approved; we match her with agencies. withdraw, until an agency offer is open
offered Offered to one or more agencies. read
accepted An agency accepted her; the placement fee is due. read
in_placement Fee received; the agency is onboarding her. read
placed Signed with an agency. read
rejected Not a fit; outcome_reason says why. read
lost The placement did not work out (an agency reports it only before payment; after payment Creator Guard decides). read
withdrawn Withdrawn by you. read

New stages may be added; treat an unknown one as "in progress". external_id can be changed at every stage.

next_actions

Do not re-implement these rules — every lead tells you what is possible right now:

json
{
  "can_edit_lead": true, "can_edit_listing": true, "can_edit_fee": true,
  "can_withdraw": true, "can_submit_for_review": false,
  "blockers": ["photos_missing", "consent_missing"]
}

blockers lists what keeps her off the marketplace while she is a draft or in review; how to clear each one: Listing & review. Every blocker, fee_missing included, stops you from submitting her for review. GET /v1/leads?has_blockers=true finds every lead that still needs something.

Edit windows

What Until
Lead fields you submit her for review (then 409 lead_locked); external_id at any stage
Listing fields her listing goes live at ready (then 409 listing_locked)
Fee the end of review; house accounts never set a fee (400 invalid_field)
Withdraw an agency offer is open or under way, or she is closed (then 409 invalid_state)

After review

Creator Guard approves her (ready) or rejects her with a reason. Approved creators are offered to agencies whose search profile fits; agencies see her without contact details, and only the agency that accepts her and pays the placement fee gets them. You see the milestones in GET /v1/leads/{id}/timeline and your money in GET /v1/leads/{id}/earnings — never agency names.

If she withdraws her consent, her listing is taken off the marketplace and she is no longer offered to agencies.

Matching her back to your system

In the API In the portal
id (lead_…) Her lead.
creator_ref (CR-1047) Her creator number, shown with her everywhere.
external_id "Your ref" in My Creators.