View as Markdown
Telegram icon

Telegram ACTION

Promote a Chat Member

Use this method to promote or demote a user in a supergroup or a channel. See the docs for more information
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Telegram account once, then configure and run Promote a Chat Member from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "telegram_bot_api-promote-chat-member",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    telegram_bot_api: { authProvisionId: "apn_xxxxxxx" },
    chatId: "Chat ID",
    userId: "User ID",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Promote a Chat Member inputs
Property Type Description
chatId Chat ID string
Enter the unique identifier for the target chat (e.g. 1035597319) or username of the target public chat (in the format @channelusername or @supergroupusername). For example, if the group's public link is t.me/mygroup, the username is @mygroup.
Required
userId User ID string
Enter the unique identifier of the target user.
Optional
can_change_info Set if the Administrator Can Change Info boolean
Pass True, if the administrator can change chat title, photo and other settings.
Optional
can_post_messages Set if the Administrator Can Create Channel Posts boolean
Pass True, if the administrator can create channel posts [channels only].
Optional
can_edit_messages Set if the Administrator Can Edit Messages boolean
Pass True, if the administrator can edit messages of other users and can pin messages [channels only].
Optional
can_delete_messages Set if the Administrator Can Delete Messages boolean
Pass True, if the administrator can delete messages of other users [channels only].
Optional
can_invite_users Set if the Administrator Can Invite Users boolean
Pass True, if the administrator can invite new users to the chat.
Optional
can_restrict_members Set if the Administrator Can Restrict Members boolean
Pass True, if the administrator can restrict, ban or unban chat members.
Optional
can_pin_messages Set if the Administrator Can Pin Messages boolean
Pass True, if the administrator can pin messages [supergroups only].
Optional
can_promote_members Set if the Administrator Can Promote Members boolean
Pass True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that they have promoted, directly or indirectly (promoted by administrators that were appointed by them).
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
telegram_bot_api-promote-chat-member
Version
0.0.8
App
Telegram
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes