Getting Started
Base URLs and how to make your first request.
Base URL
Use https://api.walido.it as the base URL.
Append the base path of the API you are calling:
| API | Base path | Example |
|---|---|---|
| MCP Connector | /mcp | https://api.walido.it/mcp |
| Public API | /api/v1 | https://api.walido.it/api/v1/ping |
Choosing the right integration
Walido exposes one AI connector and one REST API.
MCP Connector
For connecting an AI client directly to your Walido organization. The client discovers the available tools and can authenticate interactively with OAuth or with an organization API key.
Public API
For Walido customers automating their own organization: manage assistants and their configuration (prompts, knowledge, glossary, pronunciation, forwardings, calendars, tools), contacts, calls and recordings, website chats, and usage statistics. Keys are self-service - create them in the dashboard.
If an AI client should operate Walido for you, use MCP. If your own application needs direct HTTP integration, use the Public API.
The Public API authenticates with a bearer token. MCP accepts either Public API organization keys or OAuth. See Authentication for how each credential type works.
Making your first request
Get a Public API key from the dashboard under Settings → API Keys → New key, picking a role that matches the scope you need. Then call GET /ping - it confirms the API is reachable and your key is valid:
curl https://api.walido.it/api/v1/ping \
-H "Authorization: Bearer <your_api_key>"Success looks like:
{ "data": { "ok": true, "now": "2026-04-23T00:00:00.000Z" } }A 401 with { "error": { "code": "unauthorized", ... } } means the key is
missing or invalid - check the header.
Responses carry X-RateLimit-* headers; see Errors & Rate Limits.
From here, continue with the Public API overview or jump straight to the Public API quickstart.
