Delete a template

Delete a WhatsApp message template group from your account.

Delete a WhatsApp message template group. This removes the template from Meta (via the WhatsApp Business Management API) and from Connectly. Deleting templates you no longer use frees capacity against your WABA's template limit.

Deletion is permanent. Any in-flight or scheduled campaign that still references the template by name may fail to send once the template has been removed from Meta. Make sure the template is no longer in use before deleting it.

Checking whether a template is in use

There is no API to tell you which campaigns reference a template. Before deleting, confirm the template is no longer needed by reviewing your active and scheduled campaigns and automations in the Connectly dashboard. If a send that uses the template is still pending when you delete it, that send will fail at delivery time.

DELETE /v1/businesses/{businessId}/templates/{templateGroupId}

The request takes no body. templateGroupId is the template name (the same name you supplied when creating it). To look it up, list your templates with Get templates and use the template group's name.

Path Parameters

Name	Type	Description
businessId	String	Your business ID (UUID format).
templateGroupId	String	The template name (e.g. order_confirmation) — the name you set when creating it, shown as both id and name per group in Get templates. This is not an internal UUID. Deleting by name removes the whole template group (all language variants).

200: OK

{}

The endpoint is idempotent: deleting a template that doesn't exist (or was already deleted) also returns 200 with an empty body.

Example

Request

curl -X DELETE "https://api.connectly.ai/v1/businesses/<business_id>/templates/<template_name>" \
  -H "X-API-Key: <your_api_key>"

Response

{}

If the same template name is registered on more than one WhatsApp channel (WABA) under your business, this endpoint removes it from the channel resolved by default. Targeting a specific channel is not yet supported.