Skip to main content
POST
Bulk Delete Deals

Request

Deletion is permanent. Associated activities, notes, and tasks remain on the timeline but lose their deal back-reference. Documents remain available via the document library.

Headers

string
Strongly recommended. Same key returns the same result within 24 hours.

Body Parameters

array
required
Array of deal UUIDs to delete. Maximum 500.
boolean
default:"false"
When true, the API validates input and returns counts but makes no changes.

Response

object
Responses include X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and X-Request-ID. Each successful deletion emits a deal.deleted webhook event.

Example Response

Errors