Docs

Broadcasts

DELETE

Delete Broadcast

DELETE /v1/broadcasts/{broadcastId}

Delete a broadcast permanently.

Use Cases:

  • Remove draft broadcasts that are no longer needed
  • Delete queued broadcasts before they are sent
  • Clean up test broadcasts
  • Remove accidentally created broadcasts

Behavior:

  • Only DRAFT or QUEUED broadcasts can be deleted
  • Broadcast is permanently removed from the workspace
  • Cannot delete broadcasts that have been sent or are sending
  • Returns the deleted broadcast's ID for confirmation

Required Scope: write:broadcasts

Restrictions:

  • Cannot delete broadcasts in SENDING status
  • Cannot delete broadcasts in SENT status
  • Cannot delete broadcasts in COMPLETED status

Important:

  • Deletion is permanent and cannot be undone
  • If you need to cancel a queued broadcast, delete it before the scheduled send time

Path parameters

broadcastIdstringrequired

Broadcast ID

Response

200Broadcast deleted successfully. Returns the deleted broadcast's ID for confirmation.
objectstringrequired
idstringrequired
Copyright © 2026 Kibamail.·Privacy Policy