Bulk Update Records

Update many records in one request. Send a JSON array of record objects.

POSThttps://secure-api.setshape.com/api/leads/bulk/update/{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

Identify each record with lead_id (the aliases id and leadid are also accepted). Set a value to {delete} to clear it. The response reports IDs and any columns not found.

Field	Requirement	Description
Top-level JSON array	Required	An array of record objects.
`lead_id`	Required	Shape record ID (or `id` / `leadid`).
Account field mappings	Optional	Fields to update; `{delete}` clears a value.

HTTP 200 means Shape accepted and processed the bulk instruction — it does not certify that every individual record updated successfully.

Example request

[
  {
    "lead_id": 60679,
    "firstname": "John",
    "lastname": "{delete}"
  }
]