Guides/For developers
Is there a machine-readable spec for the API?
OpenAPI 3.1 — import into Postman, or generate your own SDK.
2 min read
Every WACO endpoint is published as OpenAPI 3.1, open without a key:
https://waco.id/openapi.json
Using it
- Postman — Import → Link → paste the URL above. Every endpoint appears with example payloads.
- Insomnia — Create → Import From → URL.
- Generate an SDK — use
openapi-generatoror similar to build a client in your language:openapi-generator-cli generate \ -i https://waco.id/openapi.json \ -g typescript-fetch -o ./waco-sdk
What it covers
- Endpoints for sending templates, free-form replies, media, media download and listing templates.
- Every error code and what it means (401, 403, 400, 404, 429, 502).
- The webhook schemas
message.received,message.statusandmessage.echounderwebhooks— so you can generate types for the payloads we send instead of guessing from examples.
This spec is generated from the same code that serves your requests, so it cannot quietly fall
out of date the way a separate documentation file does.
Want prose rather than a specification? Start with the API guide and the webhook guide.
← PreviousNeed to send verification codes (OTP) from my application?
Next →I want an AI bot to answer customers inside my own application
Still stuck after following this guide? Contact us from the
dashboard — attach a screenshot if you have one, it speeds everything up.