Webhook API — REST for cross-posting to Telegram, VK and Max

Programmatic cross-posting via REST. One webhook — three platforms.

Features

Simple Bearer token

No OAuth redirects or app registrations. Authorization: Bearer crossly_live_... — the standard pattern every SDK, LLM agent and no-code tool understands.

Accepts Telegram Bot API entities

Incoming webhook accepts payload with entities (offset/length/type) — Telegram format. Existing Telegram code is reusable with almost no changes. Crosslybot adapts payload for VK and Max itself. Outgoing webhook delivers ready-to-use text + text_html.

Idempotency-Key out of the box

Stripe-style standard. Pass Idempotency-Key or external_id — repeated request with the same ID returns cached result. Safe retries, no duplicate posts.

Sandbox for testing

POST /v1/sandbox/test validates payload without real publishing. Sandbox available on all plans (Free 100/day, Mini 1000/day, Standard+ unlimited). Perfect for CI/CD.

API isolation: wh.crosslybot.com

Webhook API lives on a separate subdomain — doesn't intersect with the Mini App. DDoS on webhook won't down the main API. Separate rate limits, separate docs.

crossly_live_/test_ token prefixes

Test tokens are easy to distinguish from live ones in logs. Convenient during development: one webhook for dev, another for prod, no environment confusion.

FAQ

Which plans support Webhook API?

Webhook input (receiving posts from external systems) — on Pro, Maxi and Business plans. Webhook output (sending posts out) — on Standard and above. Sandbox for testing — on all plans including Free (100 requests/day).

Why Webhook API instead of direct Telegram Bot API?

One endpoint instead of three (TG/VK/Max), no VK OAuth, no Telegram file_id complications, built-in AI processing (translation/style), ad filters, publish queue, error monitoring. Integration time: 5 minutes vs days.

Can I send from n8n / Make.com / Zapier / IFTTT?

Yes, any HTTP client works: n8n HTTP Request node, Make.com HTTP module, Zapier Webhooks Action. Detailed guide: see /webhook/n8n-integration.

Is rate limiting supported?

Yes, multi-tier. Burst (1 request per N seconds) + daily quota. By plan: Pro 1/5s + 300/hour, Maxi 1/2s + 1000/hour, Business 1/1s + 5000/hour. On repeated violations the endpoint is temporarily paused with a notification.

Security — how are endpoints protected?

1) Bearer tokens: plaintext shown only once on creation. 2) Media URL validation (https:// only, type whitelist, real mime-type check). 3) Idempotency via Idempotency-Key. 4) HMAC signing on outbound webhooks. 5) Plan-based limits and rate limiting. 6) Request history in UI.

Where's the OpenAPI documentation?

OpenAPI 3 spec is auto-generated from backend Pydantic schemas. Public Swagger UI on /docs is planned for upcoming phases. Already available: scenario guides, sandbox tester, curl/Python examples.

Webhook API is the open developer and AI-agent platform inside Crosslybot. Instead of integrating with three different social network APIs (Telegram Bot API, VK API, Max API), you make one HTTP request to a webhook URL — and the post publishes to all configured channels.

The API is designed for developer experience: Bearer token (not HMAC), Idempotency-Key (like Stripe), entities-compatible format (like Telegram), token prefixes (like GitHub), sandbox tester (like Postman). No surprising patterns — everything a developer expects in a modern REST API.

Who needs this

  • AI startups and copywriters with GPT/Claude — need to automatically publish generated content to their channels
  • No-code teams on n8n / Make.com / Zapier — assemble workflows from ready-made blocks, need an HTTP node for posting to social networks
  • Content teams with Notion calendar — Status: Ready → auto-publishing
  • News aggregators and RSS projects — collect data from many sources, publish to their channels
  • Developers of custom services — write their own backend, need a simple way to post

Webhook input is available on Pro, Maxi and Business plans.

Free plan

Ready to try?

Connect the bot in 2 minutes. Free plan — no cards, no signup.

More about the bot →