Telegram Member Adder

Telegram Member Adder is a telegram group inviter that lets an administrator attempt 1 to 10 consented invitations through their own authenticated Telegram session and records an 11-field receipt for every reached target. It supports accessible basic groups and supergroups, while Telegram remains in control of permissions, privacy, and anti-spam enforcement.

• Caller-controlled account. Authenticate with your own Telegram user session rather than a publisher-owned service account.
• Bounded action list. Process no more than 10 normalized, deduplicated usernames or user IDs in one run.
• Explicit group selection. Resolve one accessible basic group or supergroup and reject ambiguous or broadcast-channel matches.
• Auditable outcomes. Persist success, privacy, permission, resolution, session, account, bot, and rate-limit receipts target by target.

Pricing is a $0.01 Actor Start plus $0.01000 per attempted invitation. Targets a stopped run never reached are written as not_attempted receipts and are not billed.

Why Choose Telegram Member Adder

The action is narrow and visible. This Actor does not discover strangers, scrape member lists, create groups, join arbitrary communities, or bypass Telegram controls. You supply one group selector and a short list of people who expect the invitation. The run resolves the group your authenticated account can already access, identifies each requested person, sends the applicable Telegram invite request, and records what Telegram returned.

Every reached target gets a receipt. A successful invitation is not the only useful outcome. Existing membership, an already pending invite, privacy restrictions, invalid usernames, non-person entities, deleted accounts, bot rules, group limits, missing admin rights, session loss, and rate limits map to stable statuses and plain-language reasons. Consumers do not need to parse raw library exception names.

Completed work is persisted immediately. After each target, the Actor writes its receipt before sleeping or moving to the next item. If a run-stopping permission, session, or rate-limit outcome occurs, remaining targets receive not_attempted receipts so a smaller Dataset cannot be mistaken for a complete batch.

The caller retains responsibility. A Telegram StringSession is an exported authorization credential. Anyone holding it may act as the account. The Actor marks session and password inputs as secret, but operators must also restrict run access, secure Saved Messages, revoke leaked sessions, and avoid pasting credentials into tickets or public logs.

Quick Start Guide

There is deliberately no public runnable prefill: a valid example would change real group membership. Prepare a disposable or controlled group that you administer and one person who has explicitly agreed to the test.

1. Open the input form and leave session empty on the first run.
2. Enter the exact group @username, positive numeric ID, or an unambiguous title.
3. Enter one consented username or user ID.
4. Start the run, then scan the QR code from Telegram Settings → Devices → Link Desktop Device.
5. If two-step verification is enabled, supply password through its secret input.
6. Confirm the resolved group title and ID in the run status before the invite occurs.
7. Review status and reason in the default Dataset.
8. Save the returned session from your own Saved Messages in a secret manager for later authorized runs.

An API payload has this shape; replace every uppercase token before use:

{
  "session": "YOUR_SECRET_STRING_SESSION",
  "password": "YOUR_OPTIONAL_2FA_PASSWORD",
  "group_match": "YOUR_ADMINISTERED_GROUP",
  "usernames": [
    "CONSENTED_USERNAME"
  ]
}

Never test against a real person or community without authorization. A first QR login and a successful invite are external account actions, not harmless sample reads.

Input Parameters

Four inputs define authentication, destination, and the bounded action list. Secrets have no public prefill, and the two action inputs also remain empty to prevent an automated example from inviting someone.

Input	Type	Required	Purpose
session	secret string	No	Reusable Telethon StringSession; omit for QR sign-in
password	secret string	No	Telegram two-step-verification password for QR sign-in
group_match	string	Yes	Exact username/ID, exact title, or unique title fragment
usernames	array of strings	Yes	1–10 consented usernames or positive user IDs

Usernames are case-normalized, a leading @ is removed, positive numeric IDs stay numeric identifiers, and equivalent duplicates keep the first target. Invalid URLs, blank strings, non-string values, negative IDs, and malformed usernames are rejected before authentication or mutation.

Exact group username or numeric ID wins. An exact title or partial title is accepted only when it identifies one group. Multiple matches stop the run and ask for a more specific selector. Broadcast channels are rejected because direct member addition uses a group or supergroup path.

Output Data Schema

One row is one action receipt. The sparse 11-field contract is:

Field	Meaning
target	Canonical requested username or numeric ID
status	Stable invite outcome
reason	Plain-language non-success explanation
id	Resolved Telegram user ID
username	Resolved public username
first_name, last_name	Resolved public name parts
group_id, group_title	Resolved destination group
processor, processed_at	Actor provenance and UTC production time

Example receipt shape:

{
  "target": "consented_user",
  "status": "privacy_restricted",
  "reason": "Their privacy settings only allow invites from contacts.",
  "id": 123456789,
  "username": "consented_user",
  "first_name": "Example",
  "group_id": 2290332145,
  "group_title": "Administered Community",
  "processor": "https://apify.com/username/actor_name",
  "processed_at": "2026-08-12T13:00:00+00:00"
}

Documented statuses include invited, already_member, already_invited, privacy_restricted, not_a_person, not_found, account_gone, bot_not_allowed, bot_limit_reached, their_limit_reached, blocked, admin_required, permission_denied, session_unavailable, rate_limited, failed, and not_attempted.

Integration Examples

Actor ID XI6EIILM3IjhI2X0W can be started asynchronously after you replace the placeholders and store secrets safely:

curl -X POST "https://api.apify.com/v2/acts/XI6EIILM3IjhI2X0W/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"session":"YOUR_SECRET_SESSION","group_match":"YOUR_ADMINISTERED_GROUP","usernames":["CONSENTED_USERNAME"]}'

Asynchronous execution is preferable because QR sign-in and Telegram source timing can outlast an HTTP client. Poll the run, fetch the default Dataset, and reconcile every requested target before scheduling another batch.

An MCP caller uses the same shape:

{
  "actor": "agentx/telegram-member-adder",
  "input": {
    "session": "YOUR_SECRET_SESSION",
    "group_match": "YOUR_ADMINISTERED_GROUP",
    "usernames": ["CONSENTED_USERNAME"]
  }
}

Do not place Telegram or Apify credentials in source code, shared workflow logs, prompt history, or public automation templates.

Pricing

The local release registers two events:

Event	Billing unit	FREE	BRONZE	SILVER	GOLD / PLATINUM / DIAMOND
Result	One attempted invitation	$0.01000	$0.00900	$0.00800	$0.00750
Actor Start	Once per run	$0.01000	$0.01000	$0.01000	$0.01000

A receipt is billed when the Actor reached the target and Telegram answered — including refusals such as privacy_restricted, which are the answer you paid to obtain. Targets a stopped run never reached carry the not_attempted status and are not billed. No actor_usage event is registered.

• One consented target: $0.01000 + $0.01000 = $0.02000
• Ten attempted targets: $0.01000 + 10 x $0.01000 = $0.11000

A run that stops at validation or authentication still starts the Actor and can incur the fixed start.

This simple price is not an invitation-volume recommendation. Telegram, not price, controls safe and permitted activity. The production input cap remains 10 targets and the Actor deliberately paces sequential attempts.

Use Cases

Administered community onboarding: invite a short consented list after an event, application, paid membership, or internal approval where direct invitation is appropriate.

Migration reconciliation: attempt a small authorized set and retain structured receipts for members already present, pending, restricted, unresolved, or successfully invited.

Support-assisted access: process users who explicitly asked an administrator for help joining a group and need a traceable outcome.

Controlled QA: test invitation permissions and status handling with disposable accounts and a private test group owned by your organization.

The Actor is not a growth-hacking tool. It is unsuitable for cold outreach, scraped lists, unsolicited adds, bypassing privacy, account farming, or repeated attempts after Telegram applies a restriction.

Alternatives

Use a normal Telegram invite link when the person can join themselves; it usually provides clearer consent and avoids handling a reusable account session. Use Telegram's native client for occasional manual administration.

Use Telegram Member Scraper only when the task is a permitted read of visible participant data. Use Telegram Info Scraper for entity metadata without changing membership. Use Telegram Private Group Scraper for authorized content access, not adding people.

A Bot API token cannot generally reproduce this user-account invite flow. Changing the product to send messages or links would be a different operation and consent model.

Limits and Troubleshooting

• Group not found: use its exact @username, positive numeric ID, or full title and confirm the authenticated account is already a member.
• Ambiguous group: replace a broad title fragment with the exact username or ID.
• Broadcast channel: select its discussion group; direct addition is not performed on the broadcast channel path.
• privacy_restricted: do not retry repeatedly. Ask the person to join with an invite link or add the account as a contact when appropriate.
• admin_required or permission_denied: fix group permissions before another run.
• rate_limited or blocked: stop. Repeated attempts can deepen Telegram's restriction on your account.
• QR expired: start again and scan promptly, or use a securely stored existing session.
• Session unavailable: revoke questionable sessions in Telegram Devices and create a new controlled authorization.

The Actor processes targets sequentially with a randomized 4–9 second pause. This is protection for the caller's account, not a throughput promise.

Trust and Reliability

The public Store surface recorded 121 total runs and 57 runs in the latest 30-day snapshot on August 12, 2026: 56 succeeded and one was aborted. These are Actor run statuses, not proof that every requested invitation succeeded.

The design path was verified without credentials or external mutations. An inert client captured both exact production request types, 29 documented exception classes were classified, 18 runner/resource assertions passed, and an 80-cell source/content/input matrix closed with zero uncovered cells. A separate forced-stop test retained completed receipts without OOM.

Real success remains authorization-gated because it changes membership. Static and simulated verification cannot prove that a specific account has admin rights, that a person consents, or that Telegram will accept a future request.

Legal and Compliance

Invite only people who expect the invitation and only into groups you are authorized to administer. Follow Telegram's terms, anti-spam rules, applicable privacy and communications law, organizational policy, and any contractual consent requirements.

Treat session strings and two-step passwords as credentials. Restrict Actor run access, minimize retention, revoke exposed authorizations in Telegram Devices, and rotate any password that appeared in code or logs. Never upload someone else's session.

Do not use the Actor for unsolicited additions, harassment, surveillance, political or sensitive targeting, evasion of platform restrictions, deceptive groups, or repeated retries against a user's privacy choice.

Frequently Asked Questions

How do I add members to telegram group automatically?

Use an administered group, your own secured session, and a consented list of no more than 10 targets. The Actor attempts them sequentially and returns a receipt for each reached target. Automation does not remove consent or permission requirements.

Does this telegram group inviter bypass privacy settings?

No. Telegram can reject an invite because of privacy, relationship, permission, account, bot, group-limit, or anti-spam rules. The Actor reports the outcome and does not bypass it.

How can I invite telegram users to group safely?

Use only an administered group and people who explicitly expect the invitation, keep the list at 10 or fewer, and stop when Telegram reports a privacy, permission, block, or rate-limit outcome. There is no runnable public prefill because a valid input would authenticate an account and may change real membership.

Is a session string safe to share with support?

No. Treat it like a password. Revoke it immediately if exposed and never include it in a support message.

Are Dataset rows charged separately?

Yes. Each attempted invitation bills one Result event at $0.01000 on the FREE tier, on top of the fixed $0.01000 Actor Start. Receipts with the not_attempted status are never billed.

Can it invite more than 10 people?

Not in one run. The cap and pacing protect the caller's account and keep outcomes auditable. Do not evade the cap by launching bursts of parallel runs.

Related AgentX Actors

AgentX has a broad Actor catalog. Start with the three closest Telegram tools below, then browse the generated catalog by category.

Closest to this Actor:

• Telegram Member Scraper reads visible participant data without adding anyone.
• Telegram Info Scraper resolves users, bots, channels, and groups without changing membership.
• Telegram Private Group Scraper handles a separate authorized private-content workflow.

Business and Market Intelligence

• Google Keyword Trends — Google Trends keyword interest, compared five at a time
• Google Trends Scraper — Google Trends trending searches
• Google Maps Store Scraper — Google Maps business listings
• LinkedIn Company Lookup — LinkedIn company records
• LinkedIn Profile Lookup — LinkedIn profile records
• Weather Forecast API — forecast and historical weather data

Jobs and Hiring

• All Jobs Scraper — multi-platform job listings
• Bayt Jobs Scraper — Bayt job listings
• Glassdoor Jobs Scraper — Glassdoor job listings
• Indeed Jobs Scraper — Indeed job listings
• JobStreet Company Profile — JobStreet employer records
• Jooble Jobs Scraper — Jooble job listings
• LinkedIn Jobs Scraper — LinkedIn job listings
• Naukri Jobs Scraper — Naukri job listings
• Talent Jobs Scraper — Talent.com job listings
• ZipRecruiter Jobs Scraper — ZipRecruiter job listings

Social Media

• Instagram Creator Scraper — Instagram creator profiles
• Instagram Reels Scraper — Instagram Reels metadata
• Instagram Trending Scraper — Instagram trending content
• Medium Scraper — Medium articles
• Medium Profile Scraper — Medium author profiles
• Reddit Profile Scraper — Reddit user profiles
• Reddit Viral Scraper — Reddit viral posts
• SubReddit Info Scraper — subreddit metadata
• Subreddit Members Scraper — subreddit member lists
• Subreddit Posts Scraper — subreddit post feeds
• Telegram Chat Scraper — Telegram chat messages
• Telegram Info Scraper — Telegram channel metadata
• Telegram Member Scraper — Telegram group members
• Telegram Private Group Scraper — private Telegram group data
• TikTok Creator API — TikTok creator profiles
• TikTok User Lookup — TikTok account records
• X Twitter Community API — X community data
• X Twitter Profile Lookup — X profile records
• YouTube Creator Email Scraper — YouTube creator contact data

Video, Transcripts and Downloads

• All Video Scraper — multi-platform video metadata
• Video Transcript — multi-platform transcripts
• Video Captions Downloader — caption files
• Video to Social Post — video repurposed into social copy
• YouTube Transcript — YouTube transcripts
• TikTok Transcript — TikTok transcripts
• X Twitter Transcript — X video transcripts
• Facebook Transcript — Facebook video transcripts
• Bilibili Transcript — Bilibili transcripts
• Dailymotion Transcript — Dailymotion transcripts
• Rutube Transcript — Rutube transcripts
• Loom Transcript — Loom transcripts
• Wistia Transcript — Wistia transcripts
• Instagram Reels Downloader — Reels downloads
• Kick Clip Downloader — Kick clip downloads
• Linkedin Video Downloader — LinkedIn video downloads
• Pinterest Video Downloader — Pinterest video downloads
• Reddit Video Downloader — Reddit video downloads
• Snapchat Video Downloader — Snapchat video downloads
• TED Talk Downloader — TED talk downloads
• TikTok Live Downloader — TikTok live downloads
• Twitch VOD Downloader — Twitch VOD downloads
• Zoom Recording Downloader — Zoom recording downloads

E-Commerce and Retail

• All Shopping Scraper — multi-platform product data
• AliExpress Product Scraper — AliExpress products
• Amazon Storefront Scraper — Amazon Brand Store pages
• Bol Product Scraper — Bol.com products
• eBay Seller Leads API — eBay seller records
• Hepsiburada Product Scraper — Hepsiburada products
• Kakaku Product Scraper — Kakaku.com products
• Rakuten Product Scraper — Rakuten products

Classifieds and Automotive

• All Vehicle Scraper — multi-platform vehicle listings
• AutoTrader Vehicle Search — AutoTrader US listings
• AutoTrader UK Vehicle Search — AutoTrader UK listings

Real Estate

• All Property Scraper — multi-platform property listings
• Homes Property Scraper — Homes.com listings
• MagicBricks Property Scraper — MagicBricks listings
• NoBroker Property Scraper — NoBroker listings
• Property24 Property Scraper — Property24 listings
• Realtor Property Scraper — Realtor.com listings
• Zillow Property Scraper — Zillow listings

Support and Community

Ask the AgentX team in the Telegram community with the Actor name, run ID, sanitized group selector, target count, and receipt statuses. Never post session strings, passwords, invite tokens, phone numbers, or API tokens.

AgentX is an Arcyton brand — arcyton.com.

Last Updated: August 12, 2026