# createMarketingLink Source: Locale: ru releaseGitSha: ea133cd4ad87fe549ef000b139be145be9bd1717 sourceContentDigest: b8aa1dfe92300bc998cb37dc833e114b9d279a193aa9ad143698bb96c8f5243d Version: 2 # createMarketingLink `POST /api/v1/tools/marketing/links` createMarketingLink ## Авторизация и права Scopes: ALL. Auth alternatives: OR; scopes внутри альтернативы: ALL. | Поле | Значение | | - | - | | security.0.hubApiKey | \[] | | security.1.hubBearer | \[] | | securitySchemes.hubApiKey.in | "header" | | securitySchemes.hubApiKey.name | "X-Api-Key" | | securitySchemes.hubApiKey.type | "apiKey" | | securitySchemes.hubBearer.scheme | "bearer" | | securitySchemes.hubBearer.type | "http" | | x-required-scopes | \["marketing:write"] | ## Параметры запроса | Поле | Значение | | - | - | | 0.in | "header" | | 0.name | "Idempotency-Key" | | 0.required | true | | 0.schema | [0.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | ## Тело запроса | Поле | Значение | | - | - | | content.application/json.schema | [MarketingLinkCreateRequest](https://telegafirst.com/docs/schema-70d419259d97ee4c4820a6825c9d069e6c9c1c02eea2168b7fbeedb19da13246) | | required | true | ## Ответы | Поле | Значение | | - | - | | 201.content.application/json.schema | [MarketingLinkResponse](https://telegafirst.com/docs/schema-ab4cc8d99474697ad039c7ab2ff7481f9930d2cdb04e0de58365991448c41dee) | | 201.description | "Actual control-plane projection; QR signatures expire after 900 seconds" | | 201.headers.X-Bot-Username.description | "Public active bot handle, when configured" | | 201.headers.X-Bot-Username.schema | [201.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 201.headers.X-Client-Slug.description | "Authenticated active tenant slug" | | 201.headers.X-Client-Slug.schema | [201.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 201.headers.X-RateLimit-Limit.description | "Effective requests-per-minute budget" | | 201.headers.X-RateLimit-Limit.schema | [201.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 201.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" | | 201.headers.X-RateLimit-Remaining.schema | [201.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 201.headers.X-RateLimit-Reset.description | "Reset as Unix seconds" | | 201.headers.X-RateLimit-Reset.schema | [201.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | ## Ошибки | Поле | Значение | | - | - | | 400.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 400.description | "VALIDATION\_ERROR or missing POST IDEMPOTENCY\_KEY\_REQUIRED" | | 400.headers.X-Bot-Username.description | "Public active bot handle, when configured" | | 400.headers.X-Bot-Username.schema | [400.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 400.headers.X-Client-Slug.description | "Authenticated active tenant slug" | | 400.headers.X-Client-Slug.schema | [400.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 400.headers.X-RateLimit-Limit.description | "Effective requests-per-minute budget" | | 400.headers.X-RateLimit-Limit.schema | [400.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 400.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" | | 400.headers.X-RateLimit-Remaining.schema | [400.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 400.headers.X-RateLimit-Reset.description | "Reset as Unix seconds" | | 400.headers.X-RateLimit-Reset.schema | [400.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 401.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 401.description | "INVALID\_API\_KEY: absent, invalid, revoked or conflicting key headers; session JWT refused" | | 401.headers.X-Bot-Username.description | "Public active bot handle, when configured" | | 401.headers.X-Bot-Username.schema | [401.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 401.headers.X-Client-Slug.description | "Authenticated active tenant slug" | | 401.headers.X-Client-Slug.schema | [401.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 401.headers.X-RateLimit-Limit.description | "Effective requests-per-minute budget" | | 401.headers.X-RateLimit-Limit.schema | [401.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 401.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" | | 401.headers.X-RateLimit-Remaining.schema | [401.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 401.headers.X-RateLimit-Reset.description | "Reset as Unix seconds" | | 401.headers.X-RateLimit-Reset.schema | [401.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 403.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 403.description | "INSUFFICIENT\_SCOPE or resource/plan refusal" | | 403.headers.X-Bot-Username.description | "Public active bot handle, when configured" | | 403.headers.X-Bot-Username.schema | [403.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 403.headers.X-Client-Slug.description | "Authenticated active tenant slug" | | 403.headers.X-Client-Slug.schema | [403.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 403.headers.X-RateLimit-Limit.description | "Effective requests-per-minute budget" | | 403.headers.X-RateLimit-Limit.schema | [403.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 403.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" | | 403.headers.X-RateLimit-Remaining.schema | [403.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 403.headers.X-RateLimit-Reset.description | "Reset as Unix seconds" | | 403.headers.X-RateLimit-Reset.schema | [403.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 404.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 404.description | "NOT\_FOUND for a missing or foreign tenant sequence" | | 404.headers.X-Bot-Username.description | "Public active bot handle, when configured" | | 404.headers.X-Bot-Username.schema | [404.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 404.headers.X-Client-Slug.description | "Authenticated active tenant slug" | | 404.headers.X-Client-Slug.schema | [404.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 404.headers.X-RateLimit-Limit.description | "Effective requests-per-minute budget" | | 404.headers.X-RateLimit-Limit.schema | [404.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 404.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" | | 404.headers.X-RateLimit-Remaining.schema | [404.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 404.headers.X-RateLimit-Reset.description | "Reset as Unix seconds" | | 404.headers.X-RateLimit-Reset.schema | [404.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 409.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 409.description | "CONFLICT for duplicate identity or in-flight idempotent command" | | 409.headers.X-Bot-Username.description | "Public active bot handle, when configured" | | 409.headers.X-Bot-Username.schema | [409.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 409.headers.X-Client-Slug.description | "Authenticated active tenant slug" | | 409.headers.X-Client-Slug.schema | [409.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 409.headers.X-RateLimit-Limit.description | "Effective requests-per-minute budget" | | 409.headers.X-RateLimit-Limit.schema | [409.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 409.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" | | 409.headers.X-RateLimit-Remaining.schema | [409.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 409.headers.X-RateLimit-Reset.description | "Reset as Unix seconds" | | 409.headers.X-RateLimit-Reset.schema | [409.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 413.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 413.description | "PAYLOAD\_TOO\_LARGE or ITEM\_COUNT\_EXCEEDED" | | 413.headers.X-Bot-Username.description | "Public active bot handle, when configured" | | 413.headers.X-Bot-Username.schema | [413.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 413.headers.X-Client-Slug.description | "Authenticated active tenant slug" | | 413.headers.X-Client-Slug.schema | [413.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 413.headers.X-RateLimit-Limit.description | "Effective requests-per-minute budget" | | 413.headers.X-RateLimit-Limit.schema | [413.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 413.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" | | 413.headers.X-RateLimit-Remaining.schema | [413.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 413.headers.X-RateLimit-Reset.description | "Reset as Unix seconds" | | 413.headers.X-RateLimit-Reset.schema | [413.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 422.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 422.description | "VALIDATION\_ERROR for marketing domain input refusal or IDEMPOTENCY\_KEY\_MISMATCH for divergent retries" | | 422.headers.X-Bot-Username.description | "Public active bot handle, when configured" | | 422.headers.X-Bot-Username.schema | [422.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 422.headers.X-Client-Slug.description | "Authenticated active tenant slug" | | 422.headers.X-Client-Slug.schema | [422.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 422.headers.X-RateLimit-Limit.description | "Effective requests-per-minute budget" | | 422.headers.X-RateLimit-Limit.schema | [422.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 422.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" | | 422.headers.X-RateLimit-Remaining.schema | [422.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 422.headers.X-RateLimit-Reset.description | "Reset as Unix seconds" | | 422.headers.X-RateLimit-Reset.schema | [422.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 429.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 429.description | "RATE\_LIMIT\_EXCEEDED or RATE\_LIMIT\_UNAVAILABLE" | | 429.headers.Retry-After.description | "Retry delay in seconds, when supplied by limiter" | | 429.headers.Retry-After.schema | [429.headers.Retry-After.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 429.headers.X-Bot-Username.description | "Public active bot handle, when configured" | | 429.headers.X-Bot-Username.schema | [429.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 429.headers.X-Client-Slug.description | "Authenticated active tenant slug" | | 429.headers.X-Client-Slug.schema | [429.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 429.headers.X-RateLimit-Limit.description | "Effective requests-per-minute budget" | | 429.headers.X-RateLimit-Limit.schema | [429.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 429.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" | | 429.headers.X-RateLimit-Remaining.schema | [429.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 429.headers.X-RateLimit-Reset.description | "Reset as Unix seconds" | | 429.headers.X-RateLimit-Reset.schema | [429.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 500.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 500.description | "INTERNAL\_ERROR without private implementation detail" | | 500.headers.X-Bot-Username.description | "Public active bot handle, when configured" | | 500.headers.X-Bot-Username.schema | [500.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 500.headers.X-Client-Slug.description | "Authenticated active tenant slug" | | 500.headers.X-Client-Slug.schema | [500.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 500.headers.X-RateLimit-Limit.description | "Effective requests-per-minute budget" | | 500.headers.X-RateLimit-Limit.schema | [500.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 500.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" | | 500.headers.X-RateLimit-Remaining.schema | [500.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 500.headers.X-RateLimit-Reset.description | "Reset as Unix seconds" | | 500.headers.X-RateLimit-Reset.schema | [500.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | ## Дополнительные условия | Поле | Значение | | - | - | | description | "Authenticate with X-Api-Key or Authorization: Bearer tgf\_\* (API-key transport; owner session JWT is refused). Every declared scope is required. Sequences resolve under the authenticated tenant; public QR links use an opaque UniversalLink code." | | operationId | "createMarketingLink" | | tags | \["marketing"] | | x-idempotency.mismatchStatus | 422 | | x-idempotency.required | true | | x-idempotency.ttlSeconds | 86400 | | x-pagination | null |