Use this API call to update individual records within your Shape instance
To update a lead, send an authorized JSON POST request to https://secure-api.setshape.com/api/update/lead/info
The authentication token must be passed in the request header for every API request. You can find and generate your authentication token in your system settings page under “API Integrations.”
Update leads via Lead ID and include the additional field names to be updated in the request body. To get a list of supported field names, please see the section below titled “How to Get Field Names.”
JSON request body formatting example:
{
“lead_id”: 123,
“firstname”: “John”,
“lastname”: “Doe”,
“phone”: “5555555555”,
“email”: “johndoe@gmail.com”
}
Upon success, the server returns HTTP codes and messages in the header with some additional elements and properties that are set by the server, such as id.
{
“message”: “Lead Updated successfully”,
“columns_not_found”: [],
“lead_id”: 123
}
*columns_not_found: This response key is an array indicating items passed through the API endpoint, but do not exists within Shape. If this is empty, then all items were successfully found.
Field names can be found within your CRM System’s settings pages under: Settings > Marketing Sources > Edit Any Marketing Source > Campaign Source Post URL Instructions.
After navigating to the marketing sources settings page and opening up a campaign, scroll to the bottom of the page to the “Campaign Source Post URL Instructions” section. Here, you will find a searchable table with a breakdown of all of the field names available for use. These field names can also be exported to a CSV via the “Export” dropdown.
