---
title: "Delete contact(s) by phone number"
method: POST
path: "/delete-contact/"
tags: ["Contacts"]
---

# Delete contact(s) by phone number

`POST /delete-contact/`

## Request

- Base URL: `http://api.smsfusion.com.au`
- URL: `http://api.smsfusion.com.au/delete-contact/`
- Auth: one of:
  - API key in query parameter `key`
  - HTTP basic

Deletes every row matching the number (there is no unique constraint on listid+msisdn). msisdn is a literal digit-string match, not phone-number-parsed

## Query parameters

- `key` string, required
- `msisdn` string, required
- `listid` integer

## Response `200`

Deleted (count may be 0)

- object
  - `success` boolean
  - `msisdn` integer
  - `deleted` integer
  - `lists` integer[]

## Other responses

- `401`: FIELD_EMPTY (no msisdn) or VALIDATION_FAILED (array-style msisdn)
- `404`: listid given but not found or not owned
- `405`: Method not allowed - POST only

---

[API](https://skmtc.dev/smsfusion/apis/sms-fusion-api.md) · [All operations](https://skmtc.dev/smsfusion/apis/sms-fusion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smsfusion/apis/sms-fusion-api/revisions/a88b2793a6e9?raw)