Connect Beehiiv to Telegram

Create a new subscriber for a publication. Use **List Custom Fields** to discover available custom field names before passing customFields. Use **Get Publication Info** to get the publication ID. Set reactivateExisting: true to re-subscribe someone who previously unsubscribed. See the documentation

Create a new post (newsletter draft). Pass HTML content in the content parameter. The post is created as a draft by default — set status: "confirmed" to publish immediately. Use content tags to categorize the post. Use **Get Publication Info** to get the publication ID. See the documentation

Create a new subscriber. See docs

Get aggregated analytics across all posts — open rates, click rates, unsubscribes, etc. Filter by audience (free/premium), platform (web/email), or content tags. Returns metrics: recipients, delivered, opens, unique_opens, open_rate, clicks, unique_clicks, click_rate, unsubscribes, spam_reports. Use **List Posts** to see individual post details. Use **Get Publication Info** to get the publication ID. See the documentation

Get details about the current beehiiv publication, including name, URL, and subscriber stats. **Call this first** to get the publicationId needed by all other tools. If you have multiple publications, pass the publicationId — otherwise the first publication is returned. Returns the publication name, description, URL, creation date, and subscriber count. See the documentation

Get full details for a single subscriber by ID or email. Use expand to include stats (open/click rates), custom field values, or referral data. Either subscriptionId or email must be provided. Use **Search Subscribers** to find subscriber IDs. Use **Get Publication Info** to get the publication ID. See the documentation

Get a list of all your publications. See docs

Schema discovery — list all custom fields defined for subscribers in a publication. Use this before **Create Subscriber** or **Update Subscriber** to know what custom fields are available and their expected types. Use **Get Publication Info** to get the publication ID. See the documentation

List posts (newsletter issues) for a publication. Filter by status, audience, platform, or content tags. Returns post titles, dates, status, and URLs. Use **Get Publication Info** to get the publication ID. Use **Get Post Analytics** for aggregate performance metrics across posts. See the documentation

List subscriber segments for a publication. Segments are pre-defined subscriber groups (dynamic rules, static lists, or manual selections). Use this for discovery — to understand how subscribers are organized. Use **Get Publication Info** to get the publication ID. See the documentation

Search and filter subscribers for a publication. Use email for exact email lookup, or combine status and tier filters to narrow results. Use **Get Publication Info** to get the publication ID. For full details on a single subscriber (with stats, custom fields, referrals), use **Get Subscriber** instead. Use **List Custom Fields** to discover available custom field names. See the documentation

Update an existing subscriber's fields or unsubscribe them. Use **Search Subscribers** or **Get Subscriber** to find the subscription ID first. Use **List Custom Fields** to discover available custom field names. Set unsubscribe: true to unsubscribe the subscriber. Use **Get Publication Info** to get the publication ID. See the documentation

Create an additional invite link for a chat, See the docs for more information

Deletes a message. See the docs for more information

Edits photo or video messages. See the docs for more information

Edits text or game messages. See the docs for more information

Generate a new primary invite link for a chat, See the docs for more information

Forwards messages of any kind. See the docs for more information

Use this module to get the number of members in a chat. See the docs for more information

Use this method to kick a user from a group, a supergroup or channel. See the docs for more information

Use this module to get a list of administrators in a chat. See the docs for more information

List available Telegram chats. See the docs for more information

Retrieves available options for the Commands field.

Retrieves a list of updates from the Telegram server. See the docs for more information

Pins a message. See the docs for more information

Use this method to promote or demote a user in a supergroup or a channel. See the docs for more information

Use this method to restrict a user in a supergroup. See the docs for more information

Sends a document or an image to your Telegram Desktop application. See the docs for more information

Sends a photo to your Telegram Desktop application. See the docs for more information

Sends a .webp sticker to you Telegram Desktop application. See the docs for more information

Sends a text message or a reply to your Telegram Desktop application. See the docs for more information

Sends a video file to your Telegram Desktop application. See the docs for more information

As of v.4.0, Telegram clients support rounded square mp4 videos of up to 1 minute long. Use this method to send video messages. See the docs for more information

Sends a voice message. See the docs for more information

Sends a group of photos or videos as an album. See the docs for more information

Sends an audio file to your Telegram Desktop application. See the docs for more information