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 on the Developer page, under the API Keys tab. Click the eye icon to reveal it, or the copy icon to copy it.

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