Glossary

What is the Bubble.io API Connector?

The API Connector is Bubble.io's built-in plugin for making HTTP requests to external services — enabling integrations with payment gateways, email providers, analytics platforms, and any REST API through a visual configuration interface.

How It Works

HTTP Methods

Supports GET, POST, PUT, PATCH, and DELETE requests with full control over request bodies and query parameters.

Authentication

Handles API keys, Bearer tokens, OAuth 2.0, and custom header-based auth schemes through visual configuration.

Dynamic Parameters

Parameters can be marked as dynamic, letting workflows pass values at runtime rather than hardcoding them.

Response Mapping

JSON responses are mapped to Bubble data types, making external data available throughout the application.

Common Integrations

  • StripePayment intents, subscriptions, customer management, and webhook handling for billing flows.
  • SendGrid and MailgunTransactional email sending, template rendering, and delivery status tracking.
  • TwilioSMS notifications, phone verification, and voice call initiation from backend workflows.
  • Google APIsMaps, Calendar, Sheets, and Drive integrations for productivity and location features.

Migration Challenges

  • Implicit Auth FlowsOAuth tokens managed by Bubble are invisible to developers — the migration must reconstruct the full auth flow from scratch.
  • Hardcoded EndpointsAPI base URLs and paths are often embedded in connector configs with no environment variable support.
  • Rate LimitingBubble abstracts rate limit handling; migrated code must implement retry logic and backoff strategies explicitly.
  • Response Shape AssumptionsBubble workflows assume specific response structures that may break if the external API changes its schema.

Migration Mapping

  • axios (Node.js / React)Each API Connector call maps to an axios instance with interceptors for auth headers and error handling.
  • Faraday (Ruby)Faraday middleware stacks replicate Bubble's auth, retry, and response parsing behavior.
  • requests (Python)Session objects with mounted adapters mirror the connector's shared authentication configuration.
  • Guzzle (PHP)Guzzle's handler stack and middleware system provides equivalent request/response transformation.

Related Terms

Backend workflowsBubble migrationBubble plugin dependencyReverse engineering

How Relis Extracts API Connectors

Relis extracts every API Connector configuration from your Bubble application — endpoints, authentication schemes, headers, parameters, and response mappings — and generates an OpenAPI-compatible specification your team can use to rebuild integrations in any stack.