Change Status

Move a record to a different status. The status title must match a configured status exactly.

POSThttps://secure-api.setshape.com/api/change/lead/status/{crmid}

Replace {crmid} with your Shape system ID — found on the API Integrations page. Every request also needs your auth header — see Using Shape APIs.

Body parameters

Field	Description
`lead_id`	Shape record ID.
`status`	Exact configured status title. An unknown title returns `404` — it is not created here.

Example request

curl -X POST https://secure-api.setshape.com/api/change/lead/status/{crmid} 
  -H "Authorization: {YOUR_API_AUTHORIZATION_KEY}" 
  -H "Content-Type: application/json" 
  -d '{
    "lead_id": 12345,
    "status": "Application Started"
  }'

{
  "lead_id": 12345,
  "status": "Application Started"
}

Status codes

Status	Meaning
400 Bad Request	The company or record cannot be updated.
404 Not Found	The record, required parameter, or named status was not found.
429 Too Many Requests	The Open API allowance was reached.
500 Server Error	The update failed unexpectedly.