# What the Flow API can do

> SkedX Flow connects to other systems in two directions, from Settings → Developers. Into Flow: an API key lets code send approved WhatsApp templates and messages from your own number, list templates, read and update contacts and conversations, and send one-time codes (base URL https://flowserver.skode.ai/api/v1/, header Authorization: Bearer <key>); an inbound hook is a private web address that runs one action — send a template, send a message, save or tag a contact — from the JSON a tool such as Zapier or n8n already sends, with no code. Out of Flow: outbound webhooks send a signed message to your address when a customer writes in, a template is approved, a conversation is assigned, and on many other events. The full reference, with a playground, is at https://flow.skode.ai/docs/. Sending needs a connected WhatsApp number, an approved template and credit in the messaging wallet.

Product: SkedX Flow · Topic: APIs & Developers · Draft — steps not yet re-verified in the live product

Flow can talk to your other systems in both directions. Your website, your CRM or a tool like Zapier can tell Flow to send a WhatsApp template — and Flow can tell those systems when a customer replies. There are three ways in, and this page shows which one fits your job. Most teams need only one.

## Step 1: Find the Developers tab

In Flow, open **Settings** and click the **Developers** tab. It has three groups: **Another app -> Flow** — API Keys, Inbound Hooks and OTP / Verification; **Flow -> another app** — Outbound Webhooks; and **Reference** — the API Reference. You need admin rights.
Open it directly: https://flow.skode.ai/settings/

## Step 2: Send from your own code: an API key

Use an **API key** when a developer — or an AI assistant writing code for you — can make a web request. One request sends an approved WhatsApp template from your number with your values in its blanks: the key, the template’s name, its blanks in order, and Flow’s answer. The same key can [list your templates and reply within WhatsApp’s 24-hour window](https://skode.ai/help/flow/developers/send-a-whatsapp-template-over-the-api/), [read and update contacts and conversations](https://skode.ai/help/flow/developers/contacts-and-conversations-api/), and [send one-time login codes](https://skode.ai/help/flow/developers/send-and-check-one-time-codes/).

## Step 3: Send without code: an inbound hook

Use an **inbound hook** when a tool like Zapier, n8n, a form builder or your CRM can call a web address, but nobody wants to write code. Paste one example of what that tool sends, and Flow works out that `phone` is the phone number, which fields fill the template’s blanks, and what to ignore. You get a private address, and every call to it does that one thing. [Set one up](https://skode.ai/help/flow/developers/inbound-hooks-send-without-code/), then [connect Zapier](https://skode.ai/help/flow/developers/connect-flow-to-zapier/) or [n8n](https://skode.ai/help/flow/developers/connect-flow-to-n8n/) to it.

## Step 4: Hear back from Flow: outbound webhooks

Use an **outbound webhook** when another system should react to something in Flow — a customer writes in, a message is delivered or read, a template is approved, a conversation is assigned or resolved. Flow sends a signed message to your address within seconds, keeps retrying for about two and a half hours if your system is down, and logs every attempt so you can send it again. You choose what to hear about in plain words: everything, or one event at a time, each ticked on its own. [Set one up](https://skode.ai/help/flow/developers/outbound-webhooks/), and [check each delivery is genuine](https://skode.ai/help/flow/developers/check-a-webhook-came-from-flow/).

## Step 5: Which one should I use?

- **Someone will write code** — a developer, or an AI assistant for you: an [API key](https://skode.ai/help/flow/developers/create-an-api-key/). Full control, any template, one request per message.
- **A tool like Zapier, n8n, Make or a form builder can call a web address**: an [inbound hook](https://skode.ai/help/flow/developers/inbound-hooks-send-without-code/). No code; one hook does one thing.
- **Another system should react when something happens in Flow**: an [outbound webhook](https://skode.ai/help/flow/developers/outbound-webhooks/).
- **You send through Interakt today**: [move your calls across](https://skode.ai/help/flow/developers/move-your-api-calls-from-interakt/) — the same job, a flatter request.

## Step 6: Keep the reference open

Every request, field and error code is in the **API Reference** (Settings -> Developers -> API Reference): its sections, the whole reference as an OpenAPI file, and a panel for trying requests. Every address starts with `https://flowserver.skode.ai/api/v1/` — the reference shows `https://flow.skode.ai/api/v1`, which works the same.
Open it directly: https://flow.skode.ai/docs/

## Step 7: Before your first send

Three things must be in place: a WhatsApp number connected in **Settings -> Channels**, at least one template approved by Meta — the **Templates** screen shows each one’s status and how many variables it has, and filters by status — and credit in the messaging wallet; every template is charged at its category’s rate. Then [create an API key](https://skode.ai/help/flow/developers/create-an-api-key/) and [send your first template](https://skode.ai/help/flow/developers/send-your-first-template-in-5-minutes/). No developer? [Let an AI assistant write the code](https://skode.ai/help/flow/developers/build-your-flow-integration-with-ai/).
Open it directly: https://flow.skode.ai/templates/

## Common questions

### Do I need a developer?

Not always. An [inbound hook](https://skode.ai/help/flow/developers/inbound-hooks-send-without-code/) with Zapier or n8n needs no code at all. For your own website or app, an AI assistant can write the code for you — [copy our prompt](https://skode.ai/help/flow/developers/build-your-flow-integration-with-ai/).

### What does sending through the API cost?

Each message is charged to the messaging wallet exactly as if your team had sent it from the inbox — templates at their category’s rate. If the wallet is empty, the request is refused with `402` and nothing is sent.

### Where do customers’ replies go?

Into Flow’s inbox, like any conversation, so your team sees the whole thread. To also get replies in your own system, add an [outbound webhook](https://skode.ai/help/flow/developers/outbound-webhooks/) for A customer sends a message.

### Is it safe to connect other systems?

Each API key is shown once and stored only as a fingerprint, and can be limited to what one system needs. Hooks can require a secret and a daily cap. Webhooks are signed, so your system can reject fakes. Revoke a key or delete a hook or webhook and it stops at once.

### Can I send any message I like?

To start a conversation, or to write to someone who hasn’t messaged you in 24 hours, WhatsApp only allows templates Meta has approved — your request fills in their blanks. Inside the 24 hours, free text is fine.

## Useful links
- Flow API reference — every request, field and error — with a playground: https://flow.skode.ai/docs/
- OpenAPI file — the same reference as JSON, for tools and AI assistants: https://flowserver.skode.ai/api/v1/docs/
- API Keys in Flow — create and revoke keys: https://flow.skode.ai/settings/api-keys/
- Settings in Flow — Developers tab: hooks, webhooks, OTP: https://flow.skode.ai/settings/

Videos and screenshots © 2026 SkedX, with sample data only. Share and link to them freely; copying the SkedX product or its design is not allowed. Terms: https://skode.ai/terms/

## Related guides
- Create an API key: https://skode.ai/help/flow/developers/create-an-api-key/
- Send your first WhatsApp template in 5 minutes: https://skode.ai/help/flow/developers/send-your-first-template-in-5-minutes/
- Send WhatsApp templates without code, using an inbound hook: https://skode.ai/help/flow/developers/inbound-hooks-send-without-code/
- Build your Flow integration with an AI assistant: https://skode.ai/help/flow/developers/build-your-flow-integration-with-ai/

Source: https://skode.ai/help/flow/developers/what-the-flow-api-can-do/