Connect OpenAI (ChatGPT) to Beehiiv

The Chat API, using the gpt-3.5-turbo or gpt-4 model. See the documentation

Chat using the web search tool. See the documentation

Chat with your models and allow them to invoke functions. Optionally, you can build and invoke workflows as functions. See the documentation

Chat with your files knowledge base (vector stores). See the documentation

Summarizes text using the Chat API. See the documentation

Classify items into specific categories using the Chat API. See the documentation

Translate text from one language to another using the Chat API. See the documentation

Transcribes audio into the input language. See the documentation

Creates an image given a prompt returning a URL to the image. See the documentation

Get a vector representation of a given input that can be easily consumed by machine learning models and algorithms. See the documentation

OpenAI recommends using the **Chat** action for the latest gpt-3.5-turbo API, since it's faster and 10x cheaper. This action creates a completion for the provided prompt and parameters using the older /completions API. See the documentation

Send a message or question about an image and receive a response. See the documentation

Cancels a run that is in progress. See the documentation

Sends a message and generates a response, storing the message history for a continuous conversation. See the documentation

Send a chat via the Responses API, mixing built-in tools and MCP server tools. See the documentation.

Generates audio from the input text. See the documentation

Creates an assistant with a model and instructions. See the documentation

Creates and executes a batch from an uploaded file of requests. See the documentation

Creates a job that fine-tunes a specified model from a given dataset. See the documentation

Classifies if text is potentially harmful. See the documentation

Creates a thread with optional messages and metadata, and optionally runs the thread using the specified assistant. See the documentation

Create a vector store. See the documentation

Create a vector store file. See the documentation

Deletes a specified file from OpenAI. See the documentation

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