---
title: "POST /v1/set_lead_status"
method: POST
path: "/v1/set_lead_status"
tags: ["GTM verbs"]
---

# POST /v1/set_lead_status

`POST /v1/set_lead_status`

## Request

- Base URL: `https://api.layrcake.dev`
- URL: `https://api.layrcake.dev/v1/set_lead_status`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `campaign_lead_id` string, uuid, required
  - `status` 'interested' | 'meeting_booked' | 'won' | 'not_interested' | 'out_of_office' | 'neutral', required
  - `proof` string
  - `dry_run` boolean

## Response `200`

Successful outcome

- object
  - `result` union, required
    - object
      - `campaign_lead_id` string, required
      - `previous_status` 'interested' | 'meeting_booked' | 'won' | 'not_interested' | 'out_of_office' | 'neutral', nullable, required
      - `status` 'interested' | 'meeting_booked' | 'won' | 'not_interested' | 'out_of_office' | 'neutral', required
      - `suppression_applied` boolean, required
      - `provider_sync_status` 'pending' | 'synced' | 'failed' | 'unsupported', required
    - object
      - `dry_run` true, required
      - `advisory` true, required
      - `evaluated_at` string, required
      - `plan` object, required
        - `verb` 'set_lead_status', required
        - `plan_version` 3, required
        - `input_version` string, required
        - `credits_estimate` string, required
        - `would_exceed` string[], required
        - `warnings` string[], required
        - `would` object, required
          - `previous_status` string, nullable, required
          - `status` string, required
          - `changed` boolean, required
          - `suppression_applied` boolean, required
          - `sync_queued` boolean, required
  - `layrcake` object, required
    - `request_id` string, uuid, required
    - `credits_charged` string, required
    - `credits_available` string, required
    - `replayed` boolean
    - `route` object
      - `used` 'balanced' | 'cheapest' | 'broadest' | 'fastest', required
      - `source` 'request' | 'key' | 'guess' | 'default', required

## Other responses

- `4XX`: Caller, scope, confirmation, or credit error
- `5XX`: Provider or service error

---

[API](https://skmtc.dev/layrcake/apis/layrcake-api.md) · [All operations](https://skmtc.dev/layrcake/apis/layrcake-api/llms.txt) · [OpenAPI document](https://skmtc.dev/layrcake/apis/layrcake-api/revisions/24c80e33c274?raw)