channels.updateUsername

Change the username of a supergroup/channel

Example

Javascript

const {Api, TelegramClient} = require('telegram');
const {StringSession} = require('telegram/sessions');

const session = new StringSession('');
const client = new TelegramClient(session, apiId, apiHash, {});

(async function run() {
    const result = await client.invoke(new Api.channels.updateUsername({
        channel: new Api.InputChannel({...}),
        username: 'random string here',
        }));
    console.log(result); // prints the result
})();

TypeScript

import {Api, TelegramClient} from 'telegram';
import {StringSession} from 'telegram/sessions';

const session = new StringSession('');
const client = new TelegramClient(session, apiId, apiHash, {});

(async function run() {
    const result: Api.Bool = await client.invoke(new Api.channels.updateUsername({
        channel: new Api.InputChannel({...}),
        username: 'random string here',
        }));
    console.log(result); // prints the result
})();

TL schema

boolFalse#bc799737 = Bool;
boolTrue#997275b5 = Bool;
---functions---
channels.updateUsername#3514b3de channel:InputChannel username:string = Bool;

Parameters

Name	Type	Description
channel	InputChannel	Channel
username	string	New username

Result

Bool

Possible errors

Code	Type	Description
400	CHANNELS_ADMIN_PUBLIC_TOO_MUCH	You're admin of too many public channels, make some channels private to change the username of this channel
400	CHANNEL_INVALID	The provided channel is invalid
400	CHANNEL_PRIVATE	You haven't joined this channel/supergroup
400	CHAT_ADMIN_REQUIRED	You must be an admin in this chat to do this
400	CHAT_NOT_MODIFIED	The pinned message wasn't modified
403	CHAT_WRITE_FORBIDDEN	You can't write in this chat
400	USERNAME_INVALID	The provided username is not valid
400	USERNAME_NOT_MODIFIED	The username was not modified
400	USERNAME_OCCUPIED	The provided username is already occupied

Can bots use this methd ?

yes

Related pages