--- title: Beehiiv API Integration on Truto slug: beehiiv category: Marketing Automation canonical: "https://truto.one/integrations/detail/beehiiv/" --- # Beehiiv API Integration on Truto **Category:** Marketing Automation **Status:** Generally available ## Unified APIs ### Unified Marketing Automation API - **Contacts** — The contact represent a contact in the remote system. - **Segments** — Represents a segment of contacts in the remote system. - **Workspaces** — The workspace represent a workspace in the remote system. ## How it works 1. **Link your customer's Beehiiv account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Beehiiv.** The Proxy API is a 1-to-1 mapping of the Beehiiv API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync event registrants directly into Beehiiv newsletters** — Webinar and event platforms can automatically push attendee data into their customers' Beehiiv accounts as contacts, passing custom fields and UTM parameters for attribution. This eliminates manual CSV exports and turns one-time attendees into long-term newsletter subscribers. - **Gate premium newsletter access based on community membership** — Community and membership platforms can sync subscription tiers between their product and Beehiiv, granting or revoking premium newsletter access as users upgrade or churn. This lets community builders bundle a premium Beehiiv newsletter as a perk without any manual subscriber management. - **Capture leads from form builders into Beehiiv with full attribution** — Form and landing page SaaS products can offer native Beehiiv integration, mapping form submissions to Beehiiv contacts with custom fields and UTM data intact. Growth marketers get accurate attribution without stitching together multiple tools. - **Centralize newsletter referral data alongside affiliate tracking** — Partner and affiliate management platforms can pull Beehiiv referral program data into a unified dashboard, giving marketers a single view of organic newsletter growth next to traditional affiliate performance metrics. - **Bi-directional CRM sync for newsletter engagement scoring** — CRM and RevOps platforms can sync contacts and segments between their system and Beehiiv, enabling sales teams to prioritize outreach based on newsletter engagement signals like opens and clicks. ## What you can build - **One-click subscriber push with UTM attribution** — Let your users send leads captured anywhere in your product directly into Beehiiv as contacts, with utm_source, utm_medium, and utm_campaign automatically populated for full funnel attribution. - **Premium tier management via contact updates** — Build a feature that automatically upgrades or downgrades a subscriber's premium tier in Beehiiv based on purchase or membership events in your platform. - **Segment-aware audience routing** — Allow your users to map lists or cohorts in your product to specific Beehiiv segments, ensuring subscribers land in the right audience bucket without manual intervention. - **Multi-publication workspace switcher** — Support enterprise customers and agencies managing multiple Beehiiv publications by letting them select and route data to the correct workspace from within your product. - **Custom field mapping UI** — Ship a field mapper that lets your users connect arbitrary data from your platform to Beehiiv's custom_fields array, so subscriber records stay enriched and actionable. - **Welcome email trigger on contact creation** — Give your users the option to fire Beehiiv's native welcome email automation the moment a new contact is created through your integration, keeping the subscriber experience seamless. ## FAQs ### What authentication method does Beehiiv use? Beehiiv's API v2 uses API key-based authentication. Your end users generate an API key from their Beehiiv account settings, and Truto handles storing and injecting that key into every request securely. ### How does Truto handle Beehiiv's pagination? Beehiiv v2 uses cursor-based pagination, which aligns directly with Truto's standardized cursor-based pagination model. You get a consistent interface regardless of the underlying provider. ### Which Unified API resources map to Beehiiv's data model? Truto's Unified Marketing Automation API maps Beehiiv Subscriptions to Contacts, Beehiiv Segments to Segments, and Beehiiv Publications to Workspaces. These cover the primary read and write operations most integrations require. ### Can I pass custom fields and UTM parameters when creating contacts? Yes. Beehiiv's subscription creation endpoint accepts a custom_fields array and UTM parameters (source, medium, campaign). Truto preserves these in the contact creation payload so attribution and enrichment data flow through correctly. ### Are Beehiiv-specific tools available in Truto today? Beehiiv tools are built on request. Once you signal demand, Truto builds and ships the integration — including auth, pagination handling, and unified model mapping — so you don't have to maintain the connector yourself. ### Does the integration support bulk operations? Beehiiv's API supports bulk subscriber updates. Truto can expose these as batch operations, letting your product sync large contact lists efficiently rather than making individual API calls per subscriber.