Update status

PATCH/api/v2/contacts/{username_or_id}/status

Changes a contact's status, for example to mark a deal as won.

Rate limit 300 requests per minute

Headers

x-api-keyheaderRequired
Your API key.
Content-TypeheaderRequired
application/json

Path parameters

username_or_idstringRequired
Instagram username or contact id.

Body

statusstringRequired
open, won, lost or abandoned.
changed_bystring
Email of the team member, shown in the activity log.

Errors

Error	When
400`missing_fields`	`status` is missing.
400`invalid_status`	`status` is not one of the allowed values.
400`invalid_changed_by`	changed_by is not a valid email address.
403`user_not_in_organization`	The changed_by email belongs to someone outside your organization.
404`unknown_changed_by`	No user with the changed_by email.
404`contact_not_found`	No contact with that username or id in your organization.

Request

curl -X PATCH "https://app.dmtracker.ai/api/v2/contacts/jane.fitness/status" \
  -H "x-api-key: $DMTRACKER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "won"
  }'

Response 200

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

Shortened. data is the full contact object.