Home › Methods › Channels › CheckUsername
Layer 220

ChannelsCheckUsername

Check if a username is free and can be assigned to a channel/supergroup

method Users
channels.checkUsername#10e6bd2c channel:InputChannel username:string = Bool;

Parameters

Name Type Description
Channel InputChannel The channel/supergroup that will assigned the specified username
Username string The username to check

Returns

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_ID_INVALID The provided chat id is invalid.
400 MSG_ID_INVALID Invalid message ID provided.
400 PEER_ID_INVALID The provided peer id is invalid.
400 USERNAME_INVALID The provided username is not valid.
400 USERNAME_OCCUPIED The provided username is already occupied.
400 USERNAME_PURCHASE_AVAILABLE The specified username can be purchased on https://fragment. com.

Gogram Example

// ChannelsCheckUsername - positional arguments
result, err := client.ChannelsCheckUsername(&tg.InputChannel{ChannelID: int64(123456789), AccessHash: int64(0)}, "...")
if err != nil {
    // handle error
}
// result is *tg.Bool