Reference

Create an invite link

Create an invite link: optional name, expiry in days, usage limit, or 'request to join' (admins approve each person). Follow the operation for the link.

View MarkdownThis page is generated from the source code on every release.

Create an invite link: optional name, expiry in days, usage limit, or 'request to join' (admins approve each person). Follow the operation for the link.

Overview

Name	Value
Code	`groups.create_link`
Scope needed	`groups.admin`
Risk	Write
May need confirmation	No
Runs as	Queues work for a node
Needs `Idempotency-Key`	Yes
Member roles allowed	`owner`, `manager`, `agent`
Needs a worker from version	`1.0.17`
In the app	Inbox → group info → Manage

Input fields

Field	Type	Required
`conversationId`	`uuid`	Yes
`title`	`text`	No
`requestNeeded`	`true/false`	No
`expireDays`	`integer`	No
`usageLimit`	`integer`	No

Example request

curl -X POST https://tlg.builera.app/api/public/v2/ops/groups.create_link \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <unique key per operation>" \
  -d '{"conversationId":"00000000-0000-0000-0000-000000000000"}'

Output fields (`data`)

Field	Type	Required
`ok`	`true`	Yes
`jobId`	`text`	Yes

Example answer

{
  "data": {
    "ok": true,
    "jobId": "00000000-0000-4000-8000-000000000000"
  }
}

Using it over MCP

Not listed on any profile: call tools_describe then tools_run with code: "groups.create_link". Tool name when listed: groups_create_link.

Create an invite link

#Overview

#Input fields

#Example request

#Output fields (data)

#Example answer