Appbricx
Docs
FeaturesPricingStart free

Get started

OverviewWhat Appbricx isQuickstart with a coding agentQuickstart with the builderCore concepts

Guides

Data and tablesAccess and rolesBusiness rulesSign-inCustom screensRealtime and topicsWorkflows, schedules and webhooksServer functionsAI in your appPaymentsFilesMessagesIntegrationsVerifyPublishing, domains and rollbackOperating your appExport and self-hostSelf-host install

Tutorials

Build a booking app with Claude CodeMulti-user todo listClient portalSlack on new sign-upTemplates

Reference

Reference homeFrontend SDKHTTP APIMCP toolsCLIIntegrations catalogContract formatAI key resolutionRun Appbricx locally

beehiiv

Create subscribers, list publications, and manage your newsletter on beehiiv.

MarketingAPI key6 actionsAll integrations

On this page
  1. Connect
  2. Call it from a workflow
  3. Actions (6)
  4. create_subscription
  5. list_automations
  6. add_subscription_to_automation
  7. custom_api_call
  8. list_posts
  9. update_subscription
  10. Details

Connect

Auth type: API key (secret_text). Paste the API key (or token) from the provider's settings into the connect dialog. It is encrypted at rest and only decrypted on the server when an action runs.

  • In the editor: Backend panel, Integrations tab, then Connect. This connects it for the project.
  • For every project in a workspace: Workspace settings, Integrations.
  • Owners and admins choose which integrations members may connect in the admin panel (Integrations tab), and can attach their own OAuth app there.

Call it from a workflow

Pass the action name and its input. The call resolves with { success, output, error? }; a missing connection resolves with success false and the reason. See ctx.integrations.invoke and ctx.integrations.call.

Native workflow
// .workflow.js (native ctx)
export async function run(ctx) {
  const res = await ctx.integrations.invoke("beehiiv", "create_subscription", {
    "publicationId": "<publicationId>",
    "email": "<email>"
  });
  if (!res.success) throw new Error(res.error);
  ctx.log.info("beehiiv answered", { output: res.output });
}
defineWorkflow module
// defineWorkflow module (@app/sdk ctx)
import { defineWorkflow } from "@app/sdk";

export default defineWorkflow({
  id: "beehiiv-create-subscription",
  name: "beehiiv: Create Subscription",
  description: "Calls beehiiv when a row is created.",
  trigger: { type: "entity_event", entity: "tickets", event: "created" },
  async run(ctx, event) {
    const res = await ctx.integrations.call("beehiiv", {
      "action": "create_subscription",
      "publicationId": "<publicationId>",
      "email": "<email>"
    }) as { success: boolean; error?: string };
    if (!res.success) throw new Error(res.error);
  },
});
From an app (connector proxy)
curl -X POST "$APP_ORIGIN/__appbricx/connector-proxy/beehiiv/create_subscription" \
  -H "Authorization: Bearer $APP_KEY" \
  -H "content-type: application/json" \
  -d '{"props":{"publicationId":"<publicationId>","email":"<email>"}}'

Actions

create_subscriptionin catalog

Create Subscription. Creates a new subscription.

InputTypeDescription
publicationIdrequiredid (picked from your account)Publication
emailrequiredtextThe email address of the new subscription.
reactivate_existingoptionalbooleanWhether to reactivate the subscription if they have already unsubscribed. Use only if the subscription is knowingly resubscribing.
send_welcome_emailoptionalbooleanWhether to send the default welcome email to the subscription.
utm_sourceoptionaltextThe source of the subscription.
utm_mediumoptionaltextThe medium of the subscription.
utm_campaignoptionaltextThe acquisition campaign of the subscription.
referring_siteoptionaltextThe website that the subscription was referred from.
referral_codeoptionaltextA subscription's referral_code to give them credit for the new subscription.
tieroptionalone of "free" | "premium"The tier for this subscription.
custom_fieldsoptionalobject (depends on other props)Custom Fields
stripe_customer_idoptionaltextThe Stripe customer ID for this subscription.
double_opt_overrideoptionaltextOverride publication double-opt settings for this subscription.
premium_tier_idsoptionalarrayThe IDs of the premium tiers this subscription is associated with.
automation_idsoptionalid (picked from your account)Enroll the subscription into automations after their subscription has been created.

list_automationsin catalog

List Automations. Retrieves a list of automations for a publication.

InputTypeDescription
publicationIdrequiredid (picked from your account)Publication
limitoptionalnumberA limit on the number of automations to be returned (1-100, default 10).
pageoptionalnumberThe page number for pagination (default 1).

add_subscription_to_automation

Add Subscription to Automation. Adds an existing subscription to a specific automation flow.

InputTypeDescription
publicationIdrequiredid (picked from your account)Publication
automationIdrequiredid (picked from your account)Automation ID
emailoptionaltextThe email address of the subscription. Provide either Email or Subscription ID.
subscription_idoptionalid (picked from your account)Subscription ID
double_opt_overrideoptionaltextOverride publication double-opt settings for this subscription (e.g., "on").

custom_api_call

Custom API Call. Make a custom API call to a specific endpoint

InputTypeDescription
urlrequiredobject (depends on other props)url
methodrequiredone of "GET" | "POST" | "PATCH" | "PUT" | "DELETE" | "HEAD"Method
headersrequiredobjectAuthorization headers are injected automatically from your connection.
queryParamsrequiredobjectQuery Parameters
body_typeoptionalone of "none" | "json" | "form_data" | "raw"Body Type
bodyoptionalobject (depends on other props)Body
response_is_binaryoptionalbooleanEnable for files like PDFs, images, etc.
failsafeoptionalbooleanNo Error on Failure
timeoutoptionalnumberTimeout (in seconds)
followRedirectsoptionalbooleanFollow redirects

list_posts

List Posts. Retrieves all posts belonging to a specific publication.

InputTypeDescription
publicationIdrequiredid (picked from your account)Publication
expandoptionallist ofOptionally expand the results by adding additional information.
audiencerequiredone of "all" | "free" | "premium"Audience
platformrequiredone of "all" | "web" | "email" | "both"Platform
statusrequiredone of "all" | "draft" | "confirmed" | "archived"Status
content_tagsoptionalarrayFilter posts by content tags. Returns posts with ANY of the specified tags.
limitoptionalnumberNumber of posts to return (1-100, default 10).
pageoptionalnumberPage number for pagination (default 1).

update_subscription

Update Subscription. Update an existing subscription.

InputTypeDescription
publicationIdrequiredid (picked from your account)Publication
subscriptionIdrequiredid (picked from your account)Subscription ID
tieroptionalone of "free" | "premium"Set the tier for this subscription.
stripe_customer_idoptionaltextThe Stripe Customer ID of the subscription.
unsubscribeoptionalbooleanWhether to unsubscribe this subscription from the publication.
custom_fieldsoptionalobject (depends on other props)Custom Fields

Details

Id
beehiiv
Category
Marketing
Tags
email, newsletter, publishing, creators
Package
@activepieces/piece-beehiiv@0.2.4
Tier
Community

On this page

  1. Connect
  2. Call it from a workflow
  3. Actions (6)
  4. create_subscription
  5. list_automations
  6. add_subscription_to_automation
  7. custom_api_call
  8. list_posts
  9. update_subscription
  10. Details
Appbricx

The backend, runtime and hosting for apps your coding agent builds. On our cloud, in yours, or on your own servers.

Features

Coding agents and MCPVerify testingBuilder consolePostgres databaseData APIRealtimeRow-level securitySign-in and authPaymentsWorkflows and jobsAI in your appIntegrationsBackups and rollbackHosting and domainsSelf-host and exportAll features

Product

ShowcasePricingFor coding agentsTemplatesPrivate cloudBring your own AI keyFAQ

Compare

Appbricx vs SupabaseLovable alternativeBolt alternativeFor freelancersFor agencies

Resources

DocumentationReferenceBlogSupportContact

© 2026 Appbricx. All rights reserved.

TermsPrivacyCookiesAcceptable Use