Skip to navigation

Delete a lead

View as Markdown

Delete a lead and all of its related data, including its contacts, opportunities, activities, tasks and custom objects. This can’t be undone.

The lead’s contacts are deleted right away. Everything else, including the lead itself, is deleted in the background, so the lead may still be returned for a short time after this request succeeds.

Returns an empty object on success. Returns 404 if the lead doesn’t exist, 403 if it exists but you don’t have access to it, and 400 if you don’t have permission to delete leads.

Authentication

AuthorizationBasic
Use your API key as the username and leave the password empty.
OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired

Response

Successful response

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error