Import your subscribers from a CSV

Bring an existing subscriber base from another service into a TribeSync subscription so their access continues without paying again.

Updated: October 22, 2026

Moving from another service? Import your current subscribers and their access continues until the date in your file, with no repurchase. Import is on the Pro plan.

File format

A CSV with one row per subscriber. The first row holds the column names:

  • telegram_user_id (required): the person's numeric Telegram ID.
  • expires_at (required): when their access ends.
  • username, first_name (optional).

Example:

telegram_user_id,expires_at,username
123456789,2026-12-31,anna
987654321,15.01.2027,

Two date formats are accepted: 2026-12-31 and 31.12.2026, optionally with a time (2026-12-31 18:00). A date without a time means "until the end of that day". Slash dates (01/02/2026) are rejected because they can be read two ways.

Column names are case-insensitive. If a Telegram ID appears more than once, the first row counts.

Steps

  1. Open Import subscribers in the Mini App or the web panel.
  2. Pick the subscription to import into.
  3. Choose your CSV file. The Mini App checks it right away and shows how many people will get access, how many have already expired, and which rows have errors.
  4. Tap Import and review the result.
ℹ️ Good to know

Before importing, the bot must be connected to that subscription's channel or group. If the chat isn't bound yet, there's nowhere to import: add the bot to the chat as an admin first.

⚠️ Watch out

Use numeric Telegram IDs, not @usernames. Rows with an invalid ID or an unrecognized date are skipped and listed by row number.

After the import

  • People already in the chat stay. When their term ends, the bot removes them, just like a regular subscription.
  • The bot can only send renewal reminders to people who have started your bot at least once. Ask subscribers to tap Start in the bot.

Related: subscriber limits.

Related articles