Mark Converted API

The Mark Converted API allows you to mark a lead as converted in your database. This is particularly useful when conversions happen outside of the chat (e.g., on your website or during a call) and you want to sync this status back into TailorTalk.

API Endpoint

https://service.tailortalk.ai/api/v1/mark_converted

Headers

Key Value
Authorization Agent <token>

You can find agent_token in the Manage Agent page.

text

Request Body

Parameter Required Description
contact_ids ✅ List of WhatsApp numbers (with country code, e.g., "919876543210") or Instagram user name (e.g., "shivajbd")

Example Request

{
    "contact_ids": [
        "919876543210",
        "shivajbd"
    ]
}

Response Format

The API returns a JSON object confirming the status update. The response payload is wrapped automatically under a data field with success: true:

{
    "data": {
        "message": "Lead status updated to converted.",
        "updated_count": 2
    },
    "success": true
}

Notes

  • Ensure that the agent access token is included in the request headers.
  • The API will find the corresponding lead for each contact and update its status. If a contact has no associated lead in the database, it will be skipped.
XLinkedIn