PPlatformAppStores

Botpress Hub

Developer Tools

Botpress · Developer tools & code hosting

Best for: Developers and service publishers who want to connect external tools, channels, or services to Botpress AI agents and distribute integrations to Botpress users.

Overview

Botpress Hub is Botpress’s public marketplace for integrations that connect Botpress AI agents with external tools, channels, and services. It offers ready-to-use components for automating intelligent workflows and provides Integration, Channel, and LLM browsing categories. Publishers can make an integration public from the Botpress Dashboard, accept Hub terms, prepare public display information and an example bot, and submit it for verification and approval. Integration packages use an integration.definition.ts file with an icon and README, while implementation logic can validate configuration and surface errors in Botpress Studio. OAuth and manual credential configuration are supported integration patterns.

How to build & ship

  1. 1Install and use the Botpress Integrations SDK to create the integration package.
  2. 2Define the integration title, description, icon, README, configurations, and identifiers in integration.definition.ts.
  3. 3Implement the integration logic, validate required parameters in register, and expose clear configuration errors.
  4. 4Implement OAuth with the external application, Botpress webhook redirect, link-template VRL script, OAuth handling, token state, and configureIntegration when needed; otherwise use manual credential configuration.
  5. 5In the Dashboard select Make Public, accept Hub terms, update publisher and integration information, prepare an example bot, and submit it to Botpress for verification and approval.

Key APIs & SDKs

Botpress Integrations SDK
integration.definition.ts integration-definition surface
Botpress global OAuth webhook endpoint: https://webhook.botpress.cloud/oauth
configureIntegration Runtime API operation
Botpress Studio integration-configuration surface

Integration types

Embedded app
Connector
Workflow action

Authentication & security

  • Primary auth: OAuth
  • Also supports: Manual configuration
  • Security review: Required
  • Botpress requires a publisher profile, public integration metadata, configuration handling, an example bot, and submission to Botpress for verification and approval; the reviewed documentation does not specify a separate security-audit or certification standard.
  • Make the integration public in the Dashboard, accept Hub terms, update the workspace profile and integration display information, ensure configuration parameters are requested, prepare an example bot, submit it to Botpress, and await verification and approval.
  • Not publicly specified
Auth docs Store policies

Monetization

Onboarding
Not publicly specified
Commission
Not publicly specified
Merchant of Record
Not publicly specified

Pros & cons for builders

Pros

  • Provides a public discovery surface for integrations.
  • Supports both manual configuration and optional OAuth through the SDK.
  • Defines publisher requirements for package metadata, configuration behavior, and approval workflow.

Cons

  • Publication is subject to Botpress verification and approval.
  • Public documentation does not state marketplace fees, commissions, revenue share, rate limits, or merchant-of-record arrangements.
  • Publishers must maintain a profile, metadata, README, icon, configuration handling, and an example bot.

Frequently asked questions

How do I get my app approved on Botpress Hub?

Make the integration public in the Dashboard, accept Hub terms, update the workspace profile and integration display information, ensure configuration parameters are requested, prepare an example bot, submit it to Botpress, and await verification and approval.

What authentication does Botpress Hub use?

Botpress Hub apps primarily authenticate with OAuth, also supporting Manual configuration.

How is Botpress Hub monetized?

Botpress Hub supports not publicly specified monetization. Typical commission: Not publicly specified. Onboarding fee: Not publicly specified.

Is a security review required to list on Botpress Hub?

Yes, Botpress Hub requires a formal security or listing review before apps go live. Botpress requires a publisher profile, public integration metadata, configuration handling, an example bot, and submission to Botpress for verification and approval; the reviewed documentation does not specify a separate security-audit or certification standard.