Partner API
For bot factories: registering client bots and managing them.
The Partner API is for bot factories and services that create bots for clients. It lets you connect bots to MGRAM and manage them from your server — without manual steps in @mgram_robot.
How to get access
- Your Partner ID is your Telegram ID.
- Send it to Support in @mgram_robot and describe what you need access for.
- You'll get a Partner API key. It's shown once — store it safely.
Requests go to https://api.mgram.biz with the header Authorization: Bearer YOUR_PARTNER_API_KEY.
Capabilities
| Method | What it does |
|---|---|
POST /register/bot | Registers a bot by token. You become the owner by default, or you can specify a client account |
GET /register/bots | The list of your bots with moderation statuses, including bots on client accounts |
POST /register/bots/settings | Turns broadcasts and Reply Ads on or off for a group of bots — up to 500 per request |
POST /register/bot/reply-ads | Turns Reply Ads on or off for one bot |
POST /register/webhook/test | Sends a test event to your HTTPS address |
When a bot is registered, the response contains its Bot API key — also shown once. Use it for the bot's statistics and tasks, see Bot statistics and management API and Tasks API.
How connection works
- You register the bot via
POST /register/bot. - The bot goes through regular MGRAM moderation.
- The status and, if rejected, the reason are shown in
GET /register/bots— or you receive the moderation decision via webhook.
Rules
- Bots are registered under the same rules as manual ones: a live audience, an honest category, no fake activity.
- Bulk operations are atomic: if at least one bot isn't yours, none are changed.
- The Partner API key gives access to all your bots — keep it only on your server.
The full description of methods, errors, and webhooks is at api.mgram.biz.