# Delete a contact

`DELETE /api/contacts/{phone}`  (operationId: `deleteContact`, group: Contacts)

Permanently deletes the contact and its chat data. This cannot be undone. A caller limited to assigned chats can only delete contacts assigned to them.

Part of the full API, which is included in the Scale plan. Any one of these scopes is enough: `contacts`.

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `phone` | path | string | yes | Contact phone number with the country code, digits only. A leading + is accepted. A 10-digit number with no country code is treated as Indian (91 is added). |

**Response 200**: Deleted.

Example:

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

**Errors specific to this call.** The common ones (401, 403, 429 and the rest) are in the [Errors guide](https://inboxwa.online/docs/api/guide/errors.md).

| Status | error | When |
| --- | --- | --- |
| 404 | `Contact not found` | No such contact, or not one the caller can see. |

Part of the InboxWA API reference: https://inboxwa.online/docs/api . Full reference as one document: https://inboxwa.online/docs/api.md . OpenAPI: https://inboxwa.online/openapi.json