Delete Contact

Permanently delete a contact from your Splashify Pro workspace, along with its conversations and message history. Useful for honouring data-deletion / GDPR / DPDP requests from your own system.

Warning: This is a hard delete — the contact, its conversations, and its messages are removed and cannot be restored. To temporarily hide a contact instead, archive it from the app UI.

Endpoint

Headers

Request body

Identify the contact by either phone_number or contact_id.

{
  "phone_number": "919876543210"
}

Example

curl -X POST https://api.splashifypro.com/api/v1/public/contacts/delete \
  -H "Authorization: Basic YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "phone_number": "919876543210" }'

Successful response — 200 OK

{
  "result": true,
  "message": "Contact deleted successfully"
}

Error response — 404 Not Found

{
  "result": false,
  "message": "Contact not found"
}

Status codes

Implementation tips

• Idempotency — a second delete for the same contact returns 404. Treat 404 as "already deleted" rather than an error in cleanup jobs.
• Prefer contact_id when you have it — it's a direct lookup and avoids any ambiguity when two contacts share a number across channels.