Delete Contact

Deletes a specific contact by ID.

Endpoint

DELETE https://api.smsleopard.com/v1/contacts/:id

Authentication

This endpoint requires Basic Authentication using your API credentials. Click to Generate Credentials (API Keys and Secrets) (opens in a new tab)

Path Parameters

Code Examples

# Replace {contact_id} with the actual contact ID
curl -X DELETE "https://api.smsleopard.com/v1/contacts/123" \
  -u "your_api_key:your_api_secret" \
  -H "Content-Type: application/json"

Response

Success Response (200 OK)

{
  "message": "Contact deleted successfully"
}

Response Fields

Error Responses

401 Unauthorized

{
  "error": "Unauthorized",
  "message": "Invalid API credentials"
}

404 Not Found

{
  "error": "Not Found",
  "message": "Contact with the specified ID does not exist"
}

403 Forbidden

{
  "error": "Forbidden",
  "message": "You don't have permission to delete this contact"
}

Usage Notes

• Once a contact is deleted, it cannot be recovered
• Make sure you have the correct contact ID before making the deletion
• The contact will be removed from all associated groups
• Any custom metadata associated with the contact will also be deleted