Telegram Group Inviter

Pricing

$0.05 / actor start

Telegram Group Inviter

Authenticated Telegram group invite automation. Sign in with QR or a reusable session, select a group you administer, and invite up to 10 users by username or numeric ID with per-target statuses such as success, already_member, privacy_restricted, and peer_flood.

Pricing

$0.05 / actor start

Rating

0.0

(0)

Developer

👁 AgentX

AgentX

Maintained by Community

Actor stats

Bookmarked

Total users

Monthly active users

13 days ago

Last modified

Telegram Group Inviter - Telegram Group Invitation Automation API

Telegram Group Inviter is a Telegram group invitation automation API that performs structured member invitations by username or user ID, returning per-target invite status, failure reason, and reusable session management in a single target-list-driven run. Telegram Group Inviter returns structured records per invitation operation, including target username or ID, resolved Telegram user ID, resolved username, first name, last name, invite status (success / already_member / privacy_restricted / flood_wait / failed and 8 additional codes), error message, processor, and processed timestamp. Coverage spans Telegram groups and supergroups where the operating account has invite permissions, with QR-login session reuse and 2FA password support. Built for community administration, group migration workflows, audited member onboarding, CRM-driven invite pipelines, regulated-community compliance, automated cohort enrollment, and rate-limit-aware invite operations. Pay-per-result pricing with no monthly minimum.

👁 Telegram
👁 Group Automation
👁 Member Operations

Why Choose This API

Structured Telegram Invitation Operations for B2B Community Pipelines

📊 Per-Target Invite Status Tracking The status field returns a granular result code per invitation — success, already_member, admin_required, permission_denied, privacy_restricted, flood_wait, peer_flood, resolve_failed, unavailable, bot_blocked, user_limit_reached, blocked, or failed — enabling precise operation audit logs, retry queue construction, and success rate analysis.

🔐 Reusable Session Management The session field accepts a saved Telegram session string — enabling QR-login-once, session reuse across multiple runs, and automated headless invitation operations without repeated authentication.

👤 Username & User ID Support The usernames array accepts both @username handles and numeric Telegram user IDs — enabling integration with member lists extracted via Telegram Member Scraper or Subreddit Member Scraper.

🛡️ Error Attribution The error field captures the exact Telegram error message per failed invite — enabling error categorization, root cause analysis, and targeted remediation without manual log inspection.

Quick Start Guide

How to Invite Members to a Telegram Group in 3 Steps

Step 1: Prepare Your Member List

Compile up to 10 Telegram usernames (@handle) or numeric user IDs. You must be an admin of the target group.

Step 2: Configure Session and Group

Open Actor Input

On first run, leave session empty — scan the QR code in the run log to authenticate. Save the printed session string for future runs.

Enter a substring matching your group name, @username, or numeric group ID in group_match.

Step 3: Review Invitation Status Logs

Each target returns a structured status record — download as JSON for audit logging or pipeline integration.

Input Parameters

Configuration Fields

Parameter	Type	Required	Description	Example Values
`session`	string (secret)	❌	Saved Telegram session string (QR login on first run)	`"1BQAAUM4..."`
`password`	string (secret)	❌	Telegram 2FA password (if enabled)	`"mypassword"`
`group_match`	string	✅	Substring to match target group (title, @username, or ID)	`"my_group"`, `"@mygroup"`
`usernames`	array	✅	List of @username handles or numeric user IDs to invite (1–10)	`["@user1", "123456789"]`

Example Input Configuration

{
"group_match":"my_community_group",
"usernames":["@alice","@bob","987654321"]
}

Output Data Schema

Complete Invitation Result Record Structure

Each processed invitation target returns the following fields:

Open Actor Output

Core Invitation Fields

Field	Type	Description
`processor`	string	Apify actor URL that processed this record
`processed_at`	string	ISO 8601 timestamp (UTC) when processed
`target`	string	Input username or user ID as provided
`user_id`	integer	Resolved Telegram user ID
`username`	string	Resolved Telegram @username
`first_name`	string	User's first name
`last_name`	string	User's last name
`status`	string	Invitation result code
`error`	string	Error detail if invite failed

Invite Status Codes

Status	Meaning
`success`	User successfully invited
`already_member`	User is already in the group
`admin_required`	Operator account lacks admin permissions
`permission_denied`	Group restricts invitations
`privacy_restricted`	User's privacy settings block invitations
`flood_wait`	Telegram rate limit triggered
`peer_flood`	Peer-level flood protection triggered
`resolve_failed`	Username/ID could not be resolved
`unavailable`	User account unavailable
`bot_blocked`	Bot blocked by user
`user_limit_reached`	Group member limit reached
`blocked`	User blocked
`failed`	Generic failure

Example JSON Output

{
"processor":"https://apify.com/agentx/telegram-group-inviter?fpr=aiagentapi",
"processed_at":"2026-05-01T10:30:00.000Z",
"target":"@alice",
"user_id":123456789,
"username":"alice",
"first_name":"Alice",
"last_name":"Smith",
"status":"success",
"error":null
}

Export Formats

JSON - Complete audit log with per-target status records
CSV - Spreadsheet-compatible for operation tracking
API Access - Programmatic access via Apify Client SDK
Cloud Storage - Automatic upload to Apify Dataset

Integration Examples

Actor ID for Platform Integration

XI6EIILM3IjhI2X0W

Ⓜ️ Make.com Setup:

Login to Make.com (Get 1000 Free Credits)
Add module "Run an Actor"
Turn 'Map' on - right side of the 'Actor*'
Paste Actor ID - from above
Click the '⟳ Refresh' - left side of Map
Input JSON* - Modify the parameters as needed
Set "Run synchronously" to YES
Add module "Get Dataset Items" - receive the result
In Dataset ID* select defaultDatasetId

🎱 N8N.io Setup:

Add 'Run an Actor and get dataset' - from the apify node
Actor → By ID → Paste Actor ID - from above
Input JSON - Modify the parameters as needed

Python Integration Example

from apify_client import ApifyClient
client = ApifyClient('YOUR_API_TOKEN')
run_input ={
"group_match":"my_community_group",
"usernames":["@alice","@bob","987654321"]
}
run = client.actor("XI6EIILM3IjhI2X0W").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)

JavaScript/Node.js Integration

import{ ApifyClient }from"apify-client";
const client =newApifyClient({token:"YOUR_API_TOKEN"});
const input ={
group_match:"my_group",
usernames:["@member1","@member2"],
};
const run =await client.actor("XI6EIILM3IjhI2X0W").call(input);
const{ items }=await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item)=> console.log(item));

JSON-LD Metadata

{
"@context":"https://schema.org",
"@graph":[
{
"@type":"SoftwareApplication",
"@id":"https://apify.com/agentx/telegram-group-inviter?fpr=aiagentapi#software",
"name":"Telegram Group Inviter",
"description":"Telegram Group Inviter is a Telegram group invitation automation API with per-target status tracking, reusable session management, and structured status records for community administration and audited member onboarding pipelines.",
"applicationCategory":"BusinessApplication",
"applicationSubCategory":"Automation API",
"operatingSystem":"Web, Cloud",
"url":"https://apify.com/agentx/telegram-group-inviter?fpr=aiagentapi",
"softwareVersion":"1.0.0",
"datePublished":"2024-08-01",
"dateModified":"2026-05-01",
"featureList":[
"Invite by username or user ID",
"13 granular per-target status codes",
"Flood_wait detection with per-target status reporting",
"Reusable QR-login session string",
"Encrypted Telegram 2FA password field",
"Structured per-target status records",
"Pay-per-use pricing with no monthly minimum",
"Native integrations with Make.com, n8n, LangChain, and CrewAI"
],
"offers":{
"@type":"Offer",
"priceCurrency":"USD",
"availability":"https://schema.org/InStock"
},
"author":{"@id":"https://apify.com/agentx?fpr=aiagentapi#person"},
"publisher":{"@id":"https://apify.com#organization"}
},
{
"@type":"Person",
"@id":"https://apify.com/agentx?fpr=aiagentapi#person",
"name":"AgentX",
"url":"https://apify.com/agentx?fpr=aiagentapi",
"sameAs":[
"https://apify.com/agentx?fpr=aiagentapi",
"https://t.me/AiAgentApi",
"https://t.me/Apify_Actor"
],
"knowsAbout":[
"automation",
"Telegram",
"group invitation",
"member operations",
"community management"
]
},
{
"@type":"FAQPage",
"mainEntity":[
{
"@type":"Question",
"name":"Do I need to be an admin to use this actor?",
"acceptedAnswer":{
"@type":"Answer",
"text":"Yes — you must be an admin of the target group. The actor returns admin_required status if the authenticated account lacks admin permissions."
}
},
{
"@type":"Question",
"name":"How do I authenticate without a saved session?",
"acceptedAnswer":{
"@type":"Answer",
"text":"Leave the session field empty on your first run. The actor will print a QR code in the run log — scan it with Telegram to authenticate. Copy the printed session string and save it for future runs."
}
},
{
"@type":"Question",
"name":"What is the maximum number of invitations per run?",
"acceptedAnswer":{
"@type":"Answer",
"text":"The usernames array accepts up to 10 targets per run. For larger batches, run the actor multiple times or schedule sequential runs."
}
},
{
"@type":"Question",
"name":"Why did I get flood_wait or peer_flood?",
"acceptedAnswer":{
"@type":"Answer",
"text":"Telegram applies rate limits on invitation operations. Wait the specified duration before retrying. Avoid sending too many invitations in a short window."
}
}
]
},
{
"@type":"HowTo",
"name":"How to invite members to a Telegram group with Telegram Group Inviter",
"step":[
{
"@type":"HowToStep",
"position":1,
"name":"Prepare Your Member List",
"text":"Compile up to 10 Telegram usernames (@handle) or numeric user IDs. Ensure you are an admin of the target group."
},
{
"@type":"HowToStep",
"position":2,
"name":"Configure Session and Group",
"text":"Open the Actor input page. On first run, leave session empty and scan the QR code in the run log to authenticate. Save the session string for future runs. Enter a substring matching your group name, @username, or numeric group ID in group_match."
},
{
"@type":"HowToStep",
"position":3,
"name":"Review Invitation Status Logs",
"text":"Each target returns a structured status record with one of 13 result codes. Download results as JSON for audit logging or pipeline integration."
}
]
},
{
"@type":"BreadcrumbList",
"itemListElement":[
{
"@type":"ListItem",
"position":1,
"name":"Apify",
"item":"https://apify.com?fpr=aiagentapi"
},
{
"@type":"ListItem",
"position":2,
"name":"AgentX",
"item":"https://apify.com/agentx?fpr=aiagentapi"
},
{
"@type":"ListItem",
"position":3,
"name":"Telegram Group Inviter",
"item":"https://apify.com/agentx/telegram-group-inviter?fpr=aiagentapi"
}
]
}
]
}

Pricing & Cost Calculator

Transparent Pay-Per-Use Model

Event Type	Price	Description
Actor Start	$0.05	One-time charge per Actor run

Cost Examples

Single Operation (1 invite target):

Actor Start: $0.05
Total: ~$0.05

Standard Run (5 invite targets):

Actor Start: $0.05
Total: ~$0.05

Full Run (10 invite targets, maximum per run):

Actor Start: $0.05
Total: ~$0.05

Competitive Pricing Comparison

Feature	Telegram Group Inviter	Manual Operations	Generic Automation	Custom Development
Run Pricing	$0.05/run ⭐	Free	Variable	Dev hours
Status Tracking	13 codes ⭐	None	Basic	Custom
Session Management	Reusable QR ⭐	Manual	Manual	Custom
Rate Limit Status	Detected ⭐	Manual	Basic	Custom
API Integration	Enterprise ⭐	None	Webhook only	Custom
Time to Deploy	Minutes ⭐	Immediate	Hours	Days / Weeks

Use Cases & Applications

Community Administration & Migration

Group Member Onboarding Automate invitations for approved member lists — building structured onboarding pipelines for community launches, group migrations, and controlled member additions with per-target audit trails.

Migration from Another Platform Collect member usernames from competitor communities via Telegram Member Scraper, then batch-invite identified users — enabling structured community migration workflows.

Invitation Audit Logging The structured status and error fields per target enable complete invitation audit logs — tracking success rates, failure patterns, and privacy-restricted user ratios for community operations reporting.

Integration with Member Intelligence

Pipeline Integration with Member Scrapers Combine with Telegram Member Scraper or Subreddit Member Scraper — extract member lists upstream, then pass usernames into this actor for automated invitation operations.

FAQ

Do I need to be an admin to use this actor?

Yes — you must be an admin of the target group. The actor returns admin_required status if the authenticated account lacks admin permissions.

How do I authenticate without a saved session?

Leave the session field empty on your first run. The actor will print a QR code in the run log — scan it with Telegram to authenticate. Copy the printed session string and save it for future runs.

What is the maximum number of invitations per run?

The usernames array accepts up to 10 targets per run. For larger batches, run the actor multiple times or schedule sequential runs.

Why did I get `flood_wait` or `peer_flood`?

Telegram applies rate limits on invitation operations. Wait the specified duration before retrying. Avoid sending too many invitations in a short window.

SEO Keywords & Search Terms

Primary Keywords

Telegram group inviter API, Telegram invitation automation, Telegram member invite API, Telegram group member automation, Telegram group admin API, Telegram bulk invite API, Telegram invitation pipeline, Telegram group onboarding API, Telegram member management API, Telegram community administration API

Long-Tail Keywords

how to automate Telegram group invitations programmatically, Telegram group invite status tracking API, Telegram member onboarding automation, Telegram group migration tool API, Telegram invitation audit log, Telegram group admin automation API, Telegram invite rate limit handling, Telegram session management API, Telegram bulk member invitation, Telegram group member management pipeline

Industry Terms

Telegram invitation automation API, community administration pipeline, group migration workflow, member onboarding automation, invitation audit logging, session reuse management, rate-limited invitation control, community operations API, structured invite status tracking, Telegram member operations

Trust & Certifications

✅ Production-Grade Infrastructure — runs on the Apify cloud platform with structured per-target invite records
✅ Privacy-Aligned Operations — invitations only target user-supplied usernames or IDs; session credentials encrypted in Apify secret store and never persisted beyond the run
✅ Transparent Run Pricing — clear pay-per-use pricing with no monthly minimum or seat fees
✅ Continuously Maintained — schema and selector updates released as Telegram evolves

Legal & Compliance

Data Rights & Usage

This actor performs invitation operations using authenticated Telegram sessions. Users are responsible for ensuring all invitation activities comply with Telegram's terms of service and applicable regulations. Only invite users who have consented to being added to groups.

Privacy Compliance

GDPR: Compliant with EU GDPR for data processing workflows.
CCPA: Compliant with California Consumer Privacy Act requirements.

Platform Terms of Service

Users must review and comply with Telegram's terms of service. Misuse of invitation features may result in account restrictions.

Enterprise Support

For enterprise licensing, custom integrations, or compliance inquiries:

Telegram: @AiAgentApi

Related Tools

Jobs & Hiring

All Jobs Scraper - Multi-Platform Job Listings Intelligence API
Glassdoor Hiring Scraper - Glassdoor Job Listings Intelligence API
Glints Employer Data Extractor - Glints Employer Intelligence API
Glints Jobs Data Extractor - Glints Job Listings Intelligence API
Indeed Hiring Scraper - Indeed Job Listings Intelligence API
JobStreet Employer Data Extractor - JobStreet Employer Intelligence API
JobStreet Jobs Data Extractor - JobStreet Job Listings Intelligence API
LinkedIn Hiring Scraper - LinkedIn Job Listings Intelligence API
StepStone Employer Data Extractor - StepStone Employer Intelligence API
StepStone Jobs Data Extractor - StepStone Job Listings Intelligence API

Social Media

Instagram Creator Scraper - Instagram Creator Intelligence API
Instagram Post Reel Scraper - Instagram Post & Reel Intelligence API
Instagram Trending Scraper - Instagram Trending Content Intelligence API
LinkedIn Company Scraper - LinkedIn Company Intelligence API
LinkedIn Profile Scraper - LinkedIn Profile Intelligence API
Medium Author Data Extractor - Medium Author Intelligence API
Medium Content Data Extractor - Medium Content Intelligence API
Reddit Author Scraper - Reddit Author Intelligence API
Reddit Viral Scraper - Reddit Viral Content Intelligence API
SubReddit Info Scraper - Subreddit Intelligence API
Subreddit Member Scraper - Subreddit Member Intelligence API
SubReddit Post Scraper - Subreddit Post Intelligence API
Telegram Chat Scraper - Telegram Chat Intelligence API
Telegram Group Inviter - Telegram Group Invitation API
Telegram Info Scraper - Telegram Channel Intelligence API
Telegram Member Scraper - Telegram Member Intelligence API
Telegram Private Group Scraper - Telegram Private Group Intelligence API
TikTok Creator Scraper - TikTok Creator Intelligence API
Twitter Community Scraper - Twitter Community Intelligence API
Twitter Info Scraper - Twitter Account Intelligence API
YouTube Market Intelligence - YouTube Channel Intelligence API

Video & Transcript

All Video Scraper - Multi-Platform Video Intelligence API
Live Stream Transcript - Live Stream Transcript Intelligence API
TikTok Live Downloader - TikTok Live Stream Download API
TikTok Transcript - TikTok Video Transcript Intelligence API
Video Caption Scraper - Multi-Platform Video Caption Extraction API
Video to Social Post - Video to Social Post Generation API
Video Transcript - Multi-Platform Video Transcript Intelligence API
YouTube Transcript - YouTube Video Transcript Intelligence API

E-Commerce & Retail

Amazon Product Data Extractor - Amazon Product Intelligence API
Amazon Storefront Data Extractor - Amazon Storefront Intelligence API
Argos Retail Data Extractor - Argos Product Intelligence API
ASOS Product Catalog Extractor - ASOS Product Catalog Intelligence API
eBay Marketplace Data Extractor - eBay Marketplace Intelligence API
eBay Seller Leads API - eBay Seller Lead Intelligence API
Flipkart Product Data Extractor - Flipkart Product Intelligence API
John Lewis Retail Data Extractor - John Lewis Product Intelligence API
Lidl Offers Data Extractor - Lidl Offers Intelligence API
Magalu Product Data Extractor - Magalu Product Intelligence API
MediaMarkt Product Data Extractor - MediaMarkt Product Intelligence API
Mercado Livre Marketplace Data Extractor - Mercado Livre Marketplace Intelligence API
Nykaa Product Data Extractor - Nykaa Product Intelligence API
OTTO Product Data Extractor - OTTO Product Intelligence API
Target Product Data Extractor - Target Product Intelligence API
Walmart Product Data Extractor - Walmart Product Intelligence API

Classifieds & Automotive

AutoTrader Dealer Leads API - AutoTrader Dealer Lead Intelligence API
AutoTrader Vehicle Listings API - AutoTrader Vehicle Listings Intelligence API
Cars.com Dealer Leads API - Cars.com Dealer Lead Intelligence API
Cars.com Vehicle Listings API - Cars.com Vehicle Listings Intelligence API
Kleinanzeigen Classifieds Data Extractor - Kleinanzeigen Classifieds Intelligence API
Kleinanzeigen Seller Leads API - Kleinanzeigen Seller Lead Intelligence API
OLX Classifieds Data Extractor - OLX Classifieds Intelligence API
OLX Seller Leads API - OLX Seller Lead Intelligence API
Webmotors Vehicle Listings API - Webmotors Vehicle Listings Intelligence API

Real Estate

MagicBricks Builder Leads API - MagicBricks Builder Lead Intelligence API
MagicBricks Property Data Extractor - MagicBricks Real Estate Data API
Realtor Property Scraper - Realtor.com Property Listings Intelligence API
Zillow For Sale Scraper - Zillow Property Listings Intelligence API

Business Intelligence & Reviews

BBB Business Data Extractor - BBB Business Intelligence API
BBB Reputation Data Extractor - BBB Reputation Intelligence API
Google Maps Store Scraper - Google Maps Business Intelligence API
Reclame Aqui Company Data Extractor - Reclame Aqui Company Intelligence API
TradeIndia Product Data Extractor - TradeIndia Product Intelligence API
TradeIndia Supplier Leads API - TradeIndia Supplier Lead Intelligence API
Zomato Menu Data Extractor - Zomato Restaurant Menu Intelligence API
Zomato Restaurant Data Extractor - Zomato Restaurant Search Intelligence API

Other

Global Weather Scraper - Global Weather Intelligence API

Support & Community

👥 Community: @Apify_Actor
👤 Contact Team: @AiAgentApi

Last Updated: May 01, 2026

👁 Telegram Channel-Group Member Adder avatar

Telegram Channel-Group Member Adder

clothefobia/telegram-channel-group-member-adder

Telegram channel and Group Message Scraper- Scrap all messsage from Telegram Channel and Group with user information.

👁 User avatar

clothe fobia

100

👁 Telegram channel and Group Message Scraper avatar

Telegram channel and Group Message Scraper

clothefobia/telegram-channel-and-group-message-scraper

Telegram channel and Group Message Scraper- Scrap all messsage from Telegram Channel and Group with user information.

👁 User avatar

clothe fobia

275

👁 Telegram Group Member avatar

Telegram Group Member

truefetch/telegram-group-member

Extract Telegram group members — full name, username, public phone number, bio, profile photo URL, and 18 fields. Collect thousands per run. Telegram API credentials included.

👁 User avatar

TrueFetch

622

5.0

👁 Telegram Group or Channel Adder Using Telegram UserName avatar

Telegram Group or Channel Adder Using Telegram UserName

bhansalisoft/telegram-group-or-channel-adder-using-telegram-username

Telegram Group or Channel Adder Using Member Json Data- Add member into telegram group or channel by input json file as per scrap from Telegram Groups/Channel Member Scraper Actor

👁 User avatar

bhansalisoft

390

👁 Telegram Group and Channel Member Extractor avatar

Telegram Group and Channel Member Extractor

clothefobia/telegram-group-and-channel-member-extractor

Telegram Group and Channel Member Extractor -Extract member From any telegram group/channel

👁 User avatar

clothe fobia

1.1K

3.0

👁 Telegram group and channel links Scraper avatar

Telegram group and channel links Scraper

danny.hub/telegram-url

Extract Telegram group and channel URLs from all social media, our search machine will extract Telegram group and channel URLs from Facebook/LinkedIn/Instagram/Tik Tok/YouTube/Twitter/Reddit/Pinterest. Join your target Telegram groups and get all members telegram usernames. Endless Leads!!

👁 User avatar

Dannyswift.hub

325

5.0

👁 Telegram Private Group Scraper avatar

Telegram Private Group Scraper

agentx/telegram-private-group-scraper

Authenticated private-group member extractor — log in once with QR (and optional 2FA), then pull up to 100,000 members from any private Telegram group or supergroup you already belong to. Optional Deep Search reveals hidden and historical members alongside username, names, and activity signals.

👁 User avatar

AgentX

5.0

👁 Facebook Search Groups Results Scraper avatar

Facebook Search Groups Results Scraper

memo23/facebook-search-groups-scraper

Scrape facebook groups from search results and get important details such as group name, description, is group public or private, group members count, activity and group URL.

👁 User avatar

Muhamed Didovic

227

1.0

👁 Facebook group member scraper avatar

Facebook group member scraper

curious_coder/facebook-group-member-scraper

Scrape facebook group members of any group with all available information

👁 User avatar

Curious Coder

2.1K

2.5

👁 Telegram scraper avatar

Telegram scraper

curious_coder/telegram-scraper

Scrape group members from any telegram group. (⚠️ Warning: Auto adding feature is no longer available!)

👁 User avatar

Curious Coder

7.1K

2.0

URL: https://apify.com/agentx/telegram-group-inviter?fpr=aiagentapi