# Flows

HTML: https://www.app2email.com/docs/api/flows · Index: https://www.app2email.com/docs/api/llms.txt

WhatsApp Flows: forms and screens inside WhatsApp. Shared by every number of the WhatsApp Business Account.

| Method | Path | Summary | Scope | Sandbox key |
| --- | --- | --- | --- | --- |
| GET | `/v1/{number}/flows` | [List WhatsApp Flows](https://www.app2email.com/docs/api/flows/list-flows.md) | `messages:read\|bookings:manage` | reads |
| POST | `/v1/{number}/flows` | [Create a flow (draft, or published at once)](https://www.app2email.com/docs/api/flows/create-flow.md) | `templates:manage` | refused |
| GET | `/v1/{number}/flows/{id}` | [One flow: status, validation errors, health](https://www.app2email.com/docs/api/flows/get-flow.md) | `messages:read` | reads |
| PATCH | `/v1/{number}/flows/{id}` | [Change a flow's name, categories or endpoint](https://www.app2email.com/docs/api/flows/update-flow.md) | `templates:manage` | refused |
| DELETE | `/v1/{number}/flows/{id}` | [Delete a draft flow](https://www.app2email.com/docs/api/flows/delete-flow.md) | `templates:manage` | refused |
| GET | `/v1/{number}/flows/{id}/json` | [A flow's Flow JSON](https://www.app2email.com/docs/api/flows/get-flow-json.md) | `messages:read` | reads |
| PUT | `/v1/{number}/flows/{id}/json` | [Replace a flow's Flow JSON](https://www.app2email.com/docs/api/flows/update-flow-json.md) | `templates:manage` | refused |
| POST | `/v1/{number}/flows/{id}/publish` | [Publish a flow (cannot be undone)](https://www.app2email.com/docs/api/flows/publish-flow.md) | `templates:manage` | refused |
| POST | `/v1/{number}/flows/{id}/deprecate` | [Deprecate a published flow (cannot be undone)](https://www.app2email.com/docs/api/flows/deprecate-flow.md) | `templates:manage` | refused |
| GET | `/v1/{number}/flows/{id}/preview` | [A public preview link of a flow (30 days)](https://www.app2email.com/docs/api/flows/get-flow-preview.md) | `messages:read` | reads |
| POST | `/v1/{number}/flows/{id}/preview` | [A new preview link of a flow (the old one stops working)](https://www.app2email.com/docs/api/flows/renew-flow-preview.md) | `templates:manage` | refused |
| GET | `/v1/{number}/flows/encryption-key` | [The number's public key for flows with a data endpoint](https://www.app2email.com/docs/api/flows/get-flow-encryption-key.md) | `messages:read` | reads |
| PUT | `/v1/{number}/flows/encryption-key` | [Set the number's public key for flow endpoints](https://www.app2email.com/docs/api/flows/set-flow-encryption-key.md) | `templates:manage` | refused |
