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.

---

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:

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

🎱 N8N.io Setup:

1. Add 'Run an Actor and get dataset' - from the apify node
2. Actor → By ID → Paste Actor ID - from above
3. 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 = new ApifyClient({ 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