Skip to navigation

Delete a lead status

View as Markdown

Delete a lead status. Returns an empty object on success.

Returns 400 if any leads still have this status, so move them to another status first. Also returns 400 if this is the organization's last lead status. Requires the Manage Customizations permission, otherwise returns 403.

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
ID of the lead status.

Response

Successful response

Errors

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