---
title: "Delete Contact"
description: "Delete an existing contact from your Bulkit account."
---

# Delete Contact

Use this endpoint to remove a contact from your Bulkit account by contact ID.

## HTTP method and path

```http
DELETE /api/v2/contacts/:id
```

## Authorization requirements

This endpoint supports:

- **Bearer token (recommended):** `Authorization: Bearer <your_api_token>`
- Legacy headers: `X-API-Key` and `X-API-Secret`
- URL query parameter: `?apikey=<your_api_token>`

## Authorization example

```http
Authorization: Bearer bk_live_8n6JQv3K1h9Lp0Md
```

## Parameters

| Parameter | Location | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `id` | Path | Yes | string / integer | Contact ID or UUID to delete |
| `Authorization` | Header | Yes (recommended) | string | `Bearer <your_api_token>` |
| `X-API-Key` | Header | Optional (legacy) | string | Your Bulkit key |
| `X-API-Secret` | Header | Optional (legacy) | string | Your Bulkit secret |
| `apikey` | Query | Optional fallback | string | API key used in URL authorization |

## Request examples

<CodeGroup>

```bash curl
curl -X DELETE "https://api.bulkitsms.com/api/v2/contacts/442" \
  -H "Authorization: Bearer bk_live_8n6JQv3K1h9Lp0Md"
```

```python python.py
import requests

response = requests.delete(
    "https://api.bulkitsms.com/api/v2/contacts/442",
    headers={
        "Authorization": "Bearer bk_live_8n6JQv3K1h9Lp0Md",
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())
```

```go main.go
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest(http.MethodDelete, "https://api.bulkitsms.com/api/v2/contacts/442", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer bk_live_8n6JQv3K1h9Lp0Md")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}

	fmt.Println(string(body))
}
```

```php php
<?php

$ch = curl_init("https://api.bulkitsms.com/api/v2/contacts/442");

curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "DELETE",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer bk_live_8n6JQv3K1h9Lp0Md",
    ],
]);

$response = curl_exec($ch);

if ($response === false) {
    throw new Exception(curl_error($ch));
}

curl_close($ch);
echo $response . PHP_EOL;
```

</CodeGroup>

## Success response example

```json
{
  "status": "success",
  "message": "Contact deleted successfully"
}
```

## Error response examples

```json
{
  "status": "error",
  "message": "Invalid credentials"
}
```

```json
{
  "status": "error",
  "message": "Contact not found"
}
```

## Notes

- delete operations are scoped to the authenticated account
- deleting a contact removes it from future contact-based send workflows