# 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](https://docs.creator-guard.com/listing/#submit-for-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`](https://docs.creator-guard.com/errors/#lead_locked)); `external_id` at any stage |
| Listing fields | her listing goes live at `ready` (then [`409 listing_locked`](https://docs.creator-guard.com/errors/#listing_locked)) |
| Fee | the end of review; house accounts never set a fee ([`400 invalid_field`](https://docs.creator-guard.com/errors/#invalid_field)) |
| Withdraw | an agency offer is open or under way, or she is closed (then [`409 invalid_state`](https://docs.creator-guard.com/errors/#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`](https://docs.creator-guard.com/reference/#op-getTimeline) and your money in [`GET /v1/leads/{id}/earnings`](https://docs.creator-guard.com/reference/#op-getEarnings) — 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**. |
