Reference
Customer profile
One person with notes, chats (on allowed accounts) and lists.
View MarkdownThis page is generated from the source code on every release.
One person with notes, chats (on allowed accounts) and lists.
Overview
| Name | Value |
|---|---|
| Code | people.get |
| Scope needed | crm.read |
| Risk | Read |
| May need confirmation | No |
| Runs as | Answers right away |
Needs Idempotency-Key |
No |
| Member roles allowed | owner, manager, agent, viewer |
| In the app | People → profile |
Input fields
| Field | Type | Required | Description |
|---|---|---|---|
personId |
uuid |
Yes |
Example request
curl -X POST https://tlg.builera.app/api/public/v2/ops/people.get \
-H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"personId":"00000000-0000-0000-0000-000000000000"}'Output fields (data)
| Field | Type | Required |
|---|---|---|
person |
object |
Yes |
notes |
object[] |
Yes |
conversations |
object[] |
Yes |
listIds |
text[] |
Yes |
Example answer
{
"data": {
"person": {
"untrusted": true,
"id": "00000000-0000-4000-8000-000000000000",
"tg_user_id": 1,
"username": "text",
"first_name": "text",
"last_name": "text",
"bio": "text",
"is_bot": true,
"is_premium": true,
"is_contact": true,
"stage_id": "00000000-0000-4000-8000-000000000000",
"tags": [
"text"
],
"temperature": "text",
"temperature_reason": "text",
"owner_account_id": "00000000-0000-4000-8000-000000000000",
"source": "text",
"listed": true,
"last_interaction_at": "2026-10-22T12:00:00.000Z",
"created_at": "2026-10-22T12:00:00.000Z"
},
"notes": [
{
"id": "00000000-0000-4000-8000-000000000000",
"body": "text",
"author_id": "00000000-0000-4000-8000-000000000000",
"created_at": "2026-10-22T12:00:00.000Z"
}
],
"conversations": [
{
"id": "00000000-0000-4000-8000-000000000000",
"account_id": "00000000-0000-4000-8000-000000000000",
"status": "open",
"last_message_at": "2026-10-22T12:00:00.000Z",
"unread_count": 1
}
],
"listIds": [
"text"
]
}
}Using it over MCP
Tool people_get is listed on the profiles: Discover (prospecting). On other profiles, find it with tools_search and run it with tools_run.