Get your Telegram API ID and hash

Swarmed Client connects to Telegram with your own API credentials: a number called api_id and a key called api_hash. Telegram gives them out for free on my.telegram.org. It takes about five minutes and there is no review.

1. Open my.telegram.org

   Go to my.telegram.org on a computer or phone browser and enter your phone number in international format, for example +44 7700 900123.

2. Enter the code

   The confirmation code arrives as a message from Telegram inside the Telegram app, not by SMS. Type it on the site.

3. Open API development tools

   Click API development tools. If you have created an app before, your credentials are already shown there: skip to step 5.

4. Fill in the form

   App title	Any name, for example My Swarmed Client. Avoid the word “Telegram”.
   Short name	5 to 32 letters or digits, no spaces, for example myswarmedclient.
   URL	Optional. Leave it empty or enter https://client.swarmed.tools.
   Platform	Desktop
   Description	One sentence, for example Personal client for my work chats. Do not leave it empty.

   Then click Create application.

5. Copy your credentials

   Copy App api_id (a number) and App api_hash (32 letters and digits) and paste them into Swarmed Client when it asks for them.

If the site only says “ERROR”

• Make sure the description field is filled in.
• Turn off VPNs and proxies, or try from your phone on mobile data.
• Use a private browser window with ad blockers turned off.
• Change the short name: use only lowercase letters, and try another one if it may be taken.
• Wait a few hours, log out of my.telegram.org, log in again and submit once. Repeated attempts are rate limited.

Good to know

• Each phone number can have one app. If you already have one, use its credentials.
• Creating the app does not change anything about your Telegram account or your chats.
• The app title you choose is what Telegram shows next to Swarmed Client in Settings → Devices.