API

Unlock the power of APIs in your Bubble application

Help us improve this article

This article is part of a significant update to the Bubble manual and your feedback is critical to our efforts to continuously enhance our written documentation. We would greatly appreciate if you could take a moment to let us know your thoughts on the quality of it. Thank you for your support! Give feedback on this article

One of Bubble's most powerful features is its ability to connect to other applications on the web. By using what's called an API connection, your application can fetch data and execute commands in external software systems and vice versa.

APIs let you connect to other applications and vice versa.

Introduction to APIs

In this section we'll cover how APIs work in general. This is a fairly technical section that takes an in-depth look at the underlying structure and mechanics of a .

The information in this section is not needed for you to set up incoming and outgoing API requests in Bubble, but by knowing the basics you may find it easier to understand external API documentation and Bubble's settings.

Bubble is a highly flexible platform. This means that while we offer robust API security features, we don't enforce their utilization. It is essential to possess an understanding of the fundamental principles of API management, such as and , in order to effectively secure one's implementation of the platform.

Throughout reading this guide you may find it useful to check our API Glossary if there are terms and definitions you are unsure about.

Getting started

If you are unfamiliar with how APIs work, we recommend starting with our introductory articles. The rest of the manual and reference entries will be easier to follow with an understanding of the basic principles:

While there are an abundance of different services you can connect to via an API, most of the follow the same basic architecture called REST.

Introduction to APIsWhat is a RESTful API?API Glossary

The Bubble API manual

In this section we cover the different API tools that Bubble offers. An API is either incoming or outgoing.

An incoming request means that an external system is initiating a connection with your Bubble application to read/manipulate data or start a workflow. This is handled by the Bubble API.

An outgoing request means that your application initiates a connection with an external system to work with data or execute an action. This is handled by the API Connector.

Incoming Connections (The Data API and API Workflows)

Incoming requests are calls that are initiated by an external system, such as another app. They are split into two different tools:

• The Data API allows other applications to connect to your app's database to read, create, edit and delete data Article: The Data API

• API Workflows allow other applications to execute workflows in your application remotely Article: API Workflows

Outgoing Connections (The API Connector and plugins)

Outgoing connections mean that your Bubble application initiates a connection with an external system to work with data or execeute an action. This is handled by two different tools in Bubble:

• The API Connector allows you to establish an API Connection with any third-party app or system that adheres to the RESTful architecture. Article: The API Connector

• Plugins are extensions that can be installed in your Bubble application to serve different functions. Many plugins allow you to easily connect to different well-known APIs without having to set it up in the API Connector. Article: Plugins that connect to APIs

API technical reference

If you are already familiar with how APIs work and want to see our technical reference, go here. Section: API reference docs

Other ways to learn:

Video lessons

Tutorials

• Intro to APIs and the API Connector

• Setting up Google API keys

Webinars:

• Bubble Webinar 2 - The API Connector

• Bubble Webinar 4 - API Workflows