POST /promoteChatMember

Use this method to promote or demote a user in a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights. Pass False for all boolean parameters to demote a user. Returns True on success.

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
can_invite_users Boolean No

Pass True, if the administrator can invite new users to the chat

can_post_messages Boolean No

Pass True, if the administrator can create channel posts, channels only

is_anonymous Boolean No

Pass True, if the administrator's presence in the chat is hidden

can_delete_messages Boolean No

Pass True, if the administrator can delete messages of other users

can_edit_messages Boolean No

Pass True, if the administrator can edit messages of other users and can pin messages, channels only

can_change_info Boolean No

Pass True, if the administrator can change chat title, photo and other settings

chat_id Yes

Unique identifier for the target chat or username of the target channel (in the format @channelusername)

can_pin_messages Boolean No

Pass True, if the administrator can pin messages, supergroups only

can_promote_members Boolean No

Pass True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that he has promoted, directly or indirectly (promoted by administrators that were appointed by him)

can_restrict_members Boolean No

Pass True, if the administrator can restrict, ban or unban chat members

user_id Integer Yes

Unique identifier of the target user

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.