# MCP: marketing

Source: <https://telegafirst.com/docs/mcp-marketing>
Locale: ru
releaseGitSha: 0bb11ef116e17ec64c802d5476eaff442e53d252
sourceContentDigest: 70219ec7a2668c630d53a0b21a073c63db65e928aaaea2df685853b4821b98f7
Version: 9

# MCP: marketing

Определения инструментов. Обновляйте tools/list после изменения прав. required\_scopes: ALL.

## create\_marketing\_campaign

Create a campaign atomically with its mandatory first source link. Provide a destination \`target\` and \`first\_link\`; a campaign without a source does not exist. A source is either \`link\` or \`code\_word\`; pass \`code\_word\` only for the latter. The platform owns public addressing. Returns the campaign and its tenant-local \`seqNum\` values.

Scopes (ALL): \["marketing:write"]. Risk: "write".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-create-marketing-campaign)

## create\_marketing\_link

Create a source link under a campaign addressed by \`campaign\_seq\_num\`. Use \`kind:"link"\` for a normal source or \`kind:"code\_word"\` with \`code\_word\` for text matching. The link receives its own tenant-local \`seqNum\`; raw ids and public registry codes are never accepted.

Scopes (ALL): \["marketing:write"]. Risk: "write".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-create-marketing-link)

## delete\_marketing\_campaign

Soft-delete a marketing campaign by its tenant-local \`seqNum\`. Idempotent: deleting an absent or already-deleted campaign returns deleted:true.

Scopes (ALL): \["marketing:write"]. Risk: "destructive".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-delete-marketing-campaign)

## delete\_marketing\_link

Disable a marketing source link by its tenant-local \`seqNum\`, preserving attribution history. A missing or foreign seqNum is NOT\_FOUND. Repeating deletion of an existing already-inactive link is idempotent and returns deleted:true.

Scopes (ALL): \["marketing:write"]. Risk: "destructive".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-delete-marketing-link)

## list\_marketing\_campaigns

List the tenant marketing campaigns with CRM-visible statistics: clicks, users, orders, payments, and the latest statistics refresh. A campaign is a destination/aggregate and includes its source links; it has no type or public address. Each source has its tenant-local \`seqNum\`, the only id accepted by source-link mutations. 0-cost read.

Scopes (ALL): \["marketing:read"]. Risk: "read".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-list-marketing-campaigns)

## list\_marketing\_links

List all tenant marketing source links for batch operations. Each row includes its tenant-local \`seqNum\` and a signed QR PNG URL. QR URLs expire after 900 seconds (15 minutes); download a large batch promptly and request a fresh list after expiry. 0-cost read.

Scopes (ALL): \["marketing:read"]. Risk: "read".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-list-marketing-links)

## update\_marketing\_campaign

Update a campaign by its tenant-local \`seqNum\`. Patch its display name, destination target, delivery button, or active flag. Source kind/code words belong to links and cannot be edited through a campaign. A foreign or missing seqNum is NOT\_FOUND.

Scopes (ALL): \["marketing:write"]. Risk: "write".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-update-marketing-campaign)

## update\_marketing\_link

Update a source link by its tenant-local \`seqNum\`. Only title, comment, and active state are mutable; source kind and code word are immutable. A foreign or missing seqNum is NOT\_FOUND.

Scopes (ALL): \["marketing:write"]. Risk: "write".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-update-marketing-link)