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
- Stripe — Payment intents, subscriptions, customer management, and webhook handling for billing flows.
- SendGrid and Mailgun — Transactional email sending, template rendering, and delivery status tracking.
- Twilio — SMS notifications, phone verification, and voice call initiation from backend workflows.
- Google APIs — Maps, Calendar, Sheets, and Drive integrations for productivity and location features.
Migration Challenges
- Implicit Auth Flows — OAuth tokens managed by Bubble are invisible to developers — the migration must reconstruct the full auth flow from scratch.
- Hardcoded Endpoints — API base URLs and paths are often embedded in connector configs with no environment variable support.
- Rate Limiting — Bubble abstracts rate limit handling; migrated code must implement retry logic and backoff strategies explicitly.
- Response Shape Assumptions — Bubble 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
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.