HomeUser GuidesAPI Reference
Get Started
HomeAPI Reference
Authentication
Branches
Contact Groups
Contacts
Conversations
Error HandlingInvoices
Messages
Orders
Rate LimitingSDKs & Code ExamplesTemplatesTicketsAPI VersioningWABA NumbersWebhooks
User GuideAPI ReferenceCreate BranchDelete Branch

Delete Branch

Permanently delete a branch from the system

Reading time: 1 minute

Delete Branch

Permanently delete a branch from the system.

DELETE{{base_url}}/branches/{id}

Path Parameters

ParameterTypeRequiredDescription
idintegerYesBranch ID

Important Warning:

Deletion is permanent and cannot be undone! The following will occur:

  • āŒ Branch will be permanently deleted
  • āŒ All associated contacts will be unlinked
  • āŒ All attached files will be deleted

It is recommended to backup before deletion.

Example Request

Example Requestbash
curl -X DELETE "{{base_url}}/branches/3" \
-H "Accept: application/json" \
-H "X-Awal-Signature-256: sha256=abc..." \
-H "X-Timestamp: 1704124800" \
-H "X-Domain: your-workspace" \
-H "X-Client-ID: your-client-id"

Example Response

Response200 OK
{
"status": true,
"message": "Branch deleted successfully"
}

Error Codes

CodeDescriptionCauseSolution
404Not FoundBranch not foundVerify branch ID
409ConflictBranch has associated dataRemove associations first

Related

← Back to Branches
View Guide
View