Skip to main content

Documentation Index

Fetch the complete documentation index at: https://talktohumans.app/docs/llms.txt

Use this file to discover all available pages before exploring further.

TalkToHumans is a LinkedIn workspace to grow your business. The public API and MCP expose connected accounts, contacts, network, and conversation records. Base URL:
https://api.talktohumans.app
Current public surfaces:
  • API: /v1
  • MCP: /mcp

API Reference

All endpoints live under /v1.

Response envelope

List endpoints return data under a data key:
{
  "data": {}
}
Errors use a structured JSON shape:
{
  "code": "bad_request",
  "message": "Invalid request parameters"
}
Common status codes:
StatusMeaning
200Request succeeded.
400Invalid query parameter, cursor, account ID, or contact ID.
401Missing, malformed, invalid, or expired credential.
403API access is not enabled for the workspace.
429Rate limit exceeded.
500Unexpected server error.

Pagination

List endpoints use cursor pagination. Request parameters:
  • limit: defaults to 10; maximum is 25.
  • cursor: pass the data.pagination.next_cursor value from the previous page.
Response:
{
  "pagination": {
    "limit": 10,
    "has_more": true,
    "next_cursor": "eyJ1cGRhdGVkX2F0Ijoi..."
  }
}