Setting up your API credentials

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

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.