Documentation
Version
Platform Dashboard GuideREST API ReferenceMCP Server for AI AgentsBuilding ConnectorsWebhooks & EventsAutomations & Integrations
READ

get_link

Fetch one Smart Link by id, with its stable code, its destination, the three addresses to share and its lifetime clicks. Read-only.

Read one Smart Link when the creator names it: to hand back the web address, the bot deep link or the embed page, or to check its state before changing it. The row is the same as list_links returns; get_link_funnel has the members and the revenue behind it.

Read-only. Never mutates anything.

Share urls.web where the slug is fine to change later; print urls.bot or a QR of urls.web and rely on code, which survives every rename because the slug's redirect runs through the portal, where the code takes over.

Requires ability

project-link:view

The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.

Runs the same action as

GET/v1/projects/{project}/links/{smartLink}

The REST endpoint and this tool share one action, so validation, permissions and events are identical.

Annotations

Read-only

It reads and never changes anything.

project_id*string

UUID of the project the link belongs to.

link_id*string

UUID of the Smart Link to fetch.

{  "data": {    "id": "7c2e5a90-3f41-4b8d-9e62-1a0d4c8b7f35",    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",    "name": "YouTube description",    "slug": "youtube",    "code": "K7PMQ2X",    "destination": { "type": "plan", "plan_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80", "plan_name": "Premium" },    "urls": {      "web": "https://my.subscriby.net/jane/go/youtube",      "bot": "https://t.me/JaneBot?start=via_K7PMQ2X",      "embed": "https://my.subscriby.net/jane/embed/plans?via=K7PMQ2X"    },    "state": "live",    "expires_at": null,    "archived_at": null,    "clicks": { "total": 48, "last_at": "2026-11-21T09:58:12+00:00" },    "created_at": "2026-11-20T09:14:02+00:00",    "updated_at": "2026-11-21T10:02:40+00:00"  }}
RESOURCE_NOT_FOUND

unknown project_id or link_id, a link of another project, or a project outside the token's scope.

AUTHENTICATION_REQUIRED

no authenticated user on the request.

TOKEN_MISSING_ABILITY

token lacks project-link:view.

Related

list_linksfind the id.get_link_funnelthe figures behind the link.Smart Links APIthe REST equivalent.

How is this guide?

Last updated on

create_link

Create a Smart Link on a project, a tracked address for one channel. Returns the link with its stable code and the three addresses to share. On every plan.

get_link_funnel

Read the funnel behind a project's Smart Links, one link or all of them with the Direct row and totals that add up to the project's own figures. Read-only, lifetime by design.