Delete a contact

DEL/api/v2/contacts/{username_or_id}

Deletes a contact. Its username gets a _deleted suffix, which frees the username for a new contact. You can still fetch the deleted contact by id.

Rate limit 150 requests per minute

Headers

x-api-keyheaderRequired
Your API key.
Content-Typeheader
application/json. Not needed for this request.

Path parameters

username_or_idstringRequired
Instagram username or contact id.

Errors

Error	When
404`contact_not_found`	No contact with that username or id in your organization.
409`contact_already_deleted`	The contact is already deleted.

Request

curl -X DELETE "https://app.dmtracker.ai/api/v2/contacts/jane.fitness" \
  -H "x-api-key: $DMTRACKER_API_KEY" \
  -H "Content-Type: application/json"

Response 200

{
  "status": "success",
  "message": "Contact deleted successfully",
  "data": {
    "id": "7c1e9a52-3f4b-4d2a-9e61-0b8f2d5c4a17",
    "username": "jane.fitness_deleted",
    "full_name": "Jane Cooper"
  }
}

Shortened. data is the full contact object.