# Delete a Group

Delete an existing contact group (mailing list) from your address book. Once deleted, the group and its associations cannot be recovered.

### <mark style="color:red;">`DELETE`</mark> `/addressbook/groups/{groupID}`&#x20;

#### Required Permission

```
delete:Groups
```

Your API key must have this permission enabled in order to use this endpoint.

### Path Parameters

| Field   | Type   | Required | Description                                   |
| ------- | ------ | -------- | --------------------------------------------- |
| groupID | string | Yes      | The unique ID of the contact group to delete. |

### Example Request

```bash
curl --location --request DELETE 'https://<hostname>/addressbook/groups/aaaa-bbbb-ddddd' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

Replace `YOUR_API_KEY` with your API key and `groupID` with the ID of the group you want to delete.

{% hint style="info" %}
All endpoints shown in this documentation use a **sample base URL**. The production API endpoint is provided by our team upon request.
{% endhint %}

#### Responses

#### Success (HTTP 200)

```json
{
  "success": true
}
```

#### Error Responses

**Authentication / Authorization Error (HTTP 403)**

Returned if the API key does not have the `delete:Groups` permission.

```json
{
  "success": false,
  "error": "Not authorized to delete groups"
}
```

**Group Not Found (HTTP 404)**

Returned if the specified group ID does not exist.

```json
{
  "success": false,
  "error": "Group not found"
}
```

{% hint style="danger" %}
This operation is **permanent** and cannot be undone.
{% endhint %}