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:
{
"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. |