---
title: "Connect an API"
description: "Bring external data or services into your app safely."
---
An API lets your app request data or trigger actions in another service. Before connecting one, confirm that the provider permits your use case and offers the data you need.

### 1. Define the user action

State what the person does, what is sent, and what the app should show in return.

### 2. Share the official documentation

Give Superapp the provider’s current API documentation, required endpoints, and an example response. Do not paste a private key into the prompt.

### 3. Handle every state

Design loading, empty, offline, rate-limit, permission, and error states—not only the successful response.

### 4. Test with safe data

Use a sandbox or development account before connecting production users and records.