v1

latestOpenAPI 3.0.02026-07-26870415.2 KB

contacts

Get contact by id

Returns the profile view of a canonical contact record. Use conversation endpoints for transcript and reply workflows.

get/v1/contacts/{id}

Path parameters

idstring required

Example:j57e2g8z4qbydxtjq8rbxprc4x7f2h5d

Query parameters

workspace_idstring

Optional workspace override. If omitted, Conduit resolves the contact's workspace automatically.

Example:j57demo8f8x7c9v0n2q4r6t8y1u3i5o

Response

Contact

Example response

{
  "data": {
    "id": "ph77c0dy0mgdpzmqz6tesry8w184002s",
    "workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
    "first_name": "Jane",
    "last_name": "Doe",
    "image_url": null,
    "type": null,
    "inbox_type_id": "guest",
    "archived": false,
    "ai_paused": false,
    "last_message_at": "2026-04-03T03:14:15.000Z",
    "created_at": "2026-04-01T17:22:10.000Z",
    "channels": [
      {
        "id": "ns782tta8jzdst8a2w5vdcgfnd841nzf",
        "type": "unthreaded_email",
        "value": "jane@example.com"
      }
    ]
  }
}