> For the complete documentation index, see [llms.txt](https://documents.blocksurvey.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documents.blocksurvey.io/audience/delete-contact.md).

# Delete Contact

### **Overview**

Deletes an existing contact from a specified list.

### Authentication

This request requires a `Authorization` header with a valid token. 

**URL:** `DELETE https://api3.blocksurvey.io/contact/delete-contact`

### Request Body

| Field    | Type   | Required | Description                                                                |
| -------- | ------ | -------- | -------------------------------------------------------------------------- |
| teamId   | String | Yes      | ID of the team owning the list.                                            |
| listId   | String | Yes      | ID of the list containing contact.                                         |
| recordId | String | No       | ID of the contact to delete.                                               |
| Email    | String | No       | Email of the contact (optional), but required if recordId is not provided. |

### cURL Example

```bash
curl -X DELETE  https://api3.blocksurvey.io/contact/delete-contact
-H "Authorization: Bearer your-api-key" \
-H "Content-Type: application/json" \
-d '{
    "teamId": "team-123",
    "listId": "list-456",
    "recordId": "contact-789",
    "Email": "new-email@example.com",

}'
```

### Response

**Successful Response**

```json
Success (200)
{
    "success": true,
    "message": "Contact deleted successfully."
}
```