# WhatsApp Flows API

**Canonical:** https://apis.io/apis/whatsapp/flows-api/  
**Provider:** WhatsApp — https://apis.io/providers/whatsapp/  
**Base URL:** https://graph.facebook.com/v21.0  
**Documentation:** https://developers.facebook.com/docs/whatsapp/flows

WhatsApp Flows API is one of 17 APIs that [WhatsApp](https://apis.io/providers/whatsapp/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Flows, Forms, Interactive, and Messaging. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, an API reference, a changelog, a GitHub repository, a getting-started guide, and 1 JSON Schema.

API for creating structured, interactive forms and multi-step flows within WhatsApp conversations, enabling appointment booking, surveys, lead capture, and other guided experiences using a JSON-based screen definition format.

## Machine-readable artifacts (25)

- **Documentation** — https://developers.facebook.com/docs/whatsapp/flows
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/openapi/whatsapp-flows-api-openapi.yml
- **Reference** — https://developers.facebook.com/docs/whatsapp/flows/reference/components
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/json-schema/whatsapp-flow-json-schema.json
- **ChangeLog** — https://developers.facebook.com/docs/whatsapp/flows/changelogs
- **ErrorCodes** — https://developers.facebook.com/docs/whatsapp/flows/reference/error-codes
- **PostmanCollection** — https://www.postman.com/meta/whatsapp-business-platform/collection/y5swede/whatsapp-flows-api
- **GitHubRepository** — https://github.com/WhatsApp/WhatsApp-Flows-Tools
- **GettingStarted** — https://developers.facebook.com/docs/whatsapp/flows/gettingstarted
- **Authentication** — https://developers.facebook.com/docs/whatsapp/business-management-api/get-started
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/apis.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/arazzo/whatsapp-create-qr-code-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/arazzo/whatsapp-create-template-then-send-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/arazzo/whatsapp-publish-flow-and-send-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/arazzo/whatsapp-register-phone-number-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/arazzo/whatsapp-send-and-react-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/arazzo/whatsapp-send-interactive-buttons-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/arazzo/whatsapp-send-location-message-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/arazzo/whatsapp-send-template-message-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/arazzo/whatsapp-send-text-and-mark-read-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/arazzo/whatsapp-subscribe-webhooks-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/arazzo/whatsapp-update-business-profile-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/arazzo/whatsapp-update-template-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/arazzo/whatsapp-upload-media-send-document-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/arazzo/whatsapp-upload-media-send-image-workflow.yml

## Other WhatsApp APIs (12)

- [WhatsApp On-Premises API](https://apis.io/apis/whatsapp/on-premises-api/)
- [WhatsApp Analytics API](https://apis.io/apis/whatsapp/whatsapp-analytics-api/)
- [WhatsApp Assets API](https://apis.io/apis/whatsapp/whatsapp-assets-api/)
- [WhatsApp Assigned Users API](https://apis.io/apis/whatsapp/whatsapp-assigned-users-api/)
- [WhatsApp Business Accounts API](https://apis.io/apis/whatsapp/whatsapp-business-accounts-api/)
- [WhatsApp Business Profile API](https://apis.io/apis/whatsapp/whatsapp-business-profile-api/)
- [WhatsApp Lifecycle API](https://apis.io/apis/whatsapp/whatsapp-lifecycle-api/)
- [WhatsApp Media API](https://apis.io/apis/whatsapp/whatsapp-media-api/)
- [WhatsApp Message Templates API](https://apis.io/apis/whatsapp/whatsapp-message-templates-api/)
- [WhatsApp Messages API](https://apis.io/apis/whatsapp/whatsapp-messages-api/)
- [WhatsApp Phone Numbers API](https://apis.io/apis/whatsapp/whatsapp-phone-numbers-api/)
- [WhatsApp Product Catalogs API](https://apis.io/apis/whatsapp/whatsapp-product-catalogs-api/)

## Tags

Flows, Forms, Interactive, Messaging

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/whatsapp/flows-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/whatsapp/.