Telegramate
Back to Help Center
Getting Started•
6 min read
•
7,654 views

Setting up your API credentials

Last updated: January 2025

What Are Telegram API Credentials?

Telegram API credentials (API ID and API Hash) are required to connect your Telegram account to our platform. These credentials allow our service to send messages and extract members on your behalf.

How to Get Your API Credentials

Step 1: Visit Telegram's Developer Portal

Go to https://my.telegram.org and log in with your phone number.

Step 2: Navigate to API Development Tools

Click on 'API development tools' in the menu.

Step 3: Create a New Application

Fill in the application form:

  • **App title**: Choose any name (e.g., 'My Marketing App')
  • **Short name**: A short identifier (e.g., 'myapp')
  • **Platform**: Select 'Other'
  • **Description**: Brief description of your use case

    • Step 4: Get Your Credentials

    After submitting, you'll receive:

  • **API ID**: A numeric identifier (e.g., 12345678)
  • **API Hash**: A long alphanumeric string

    • Important: Keep these credentials secret! Never share them publicly.

    Adding Credentials to Telegramate

    Step 1: Go to Dashboard

    Log in to your Telegramate account and navigate to the dashboard.

    Step 2: Click 'Connect Telegram Account'

    You'll see a yellow alert prompting you to connect your account.

    Step 3: Enter Your Credentials

    Paste your API ID and API Hash into the form.

    Step 4: Verify Your Phone Number

    Enter your phone number and the verification code sent by Telegram.

    Step 5: Complete 2FA (If Enabled)

    If you have two-factor authentication enabled, enter your password.

    Security Best Practices

  • **Never share your API credentials** with anyone
  • **Use a dedicated phone number** for marketing if possible
  • **Enable 2FA** on your Telegram account for extra security
  • **Regularly rotate credentials** if you suspect they've been compromised
  • **Monitor account activity** for any suspicious behavior

    • Troubleshooting

    Issue: 'Invalid API credentials' error

    Solution: Double-check that you copied the API ID and Hash correctly. Make sure there are no extra spaces.

    Issue: 'Phone number already in use'

    Solution: You can only connect one Telegram account per API credential set. Create new credentials for additional accounts.

    Issue: 'Authorization failed'

    Solution: Make sure you're entering the correct verification code. Request a new code if the old one expired.

    Was this article helpful?