API Reference

Assign Users

Assign a record to a Shape user (its owner).

POSThttps://secure-api.setshape.com/api/assign/lead/owner/{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

Both fields are required; missing fields return 422.

Field Description
lead_id Shape record ID.
lead_owner_id Shape user ID to assign.

Example request

curl -X POST https://secure-api.setshape.com/api/assign/lead/owner/{crmid} 
  -H "Authorization: {YOUR_API_AUTHORIZATION_KEY}" 
  -H "Content-Type: application/json" 
  -d '{
    "lead_id": 12345,
    "lead_owner_id": 678
  }'
{
  "lead_id": 12345,
  "lead_owner_id": 678
}