# iZap Developers ## Docs - [Authentication](https://devs.izap.ai/en/api-reference/authentication.md): OAuth 2.0 and JWT bearer tokens for the iZap API and MCP server. - [Log in with email and password](https://devs.izap.ai/en/api-reference/endpoints/auth/log-in-with-email-and-password.md): Authenticates with the fastapi-users `OAuth2PasswordRequestForm` convention: the account email is sent in the `username` field. Returns an access token, a first-party refresh token, and the token type. - [Refresh an access token](https://devs.izap.ai/en/api-reference/endpoints/auth/refresh-an-access-token.md): Preferred path: submit the first-party `refresh_token` issued by login (form or JSON body) to rotate it and receive a new access + refresh token pair. Legacy path: with no refresh token, a valid Bearer access token issues a new access token only. - [Create a business](https://devs.izap.ai/en/api-reference/endpoints/businesses/create-a-business.md): Creates a new business along with default settings and a default chatbot. If called with an authenticated user, that user becomes the owner. - [Get a business](https://devs.izap.ai/en/api-reference/endpoints/businesses/get-a-business.md): Fetch a single business, including hours, menus, and its active chatbot configuration. - [List chats for a business](https://devs.izap.ai/en/api-reference/endpoints/chats/list-chats-for-a-business.md): Paginated list of conversations. Requires either a Bearer JWT for a user with access to the business, or HTTP Basic credentials scoped to the business's slug, plus the `business-id` context implied by the path. - [List messages in a chat](https://devs.izap.ai/en/api-reference/endpoints/chats/list-messages-in-a-chat.md) - [Send a message into a chat](https://devs.izap.ai/en/api-reference/endpoints/chats/send-a-message-into-a-chat.md): Creates a message in an existing conversation. `sender: "human-assistant"` sends immediately to the consumer via WhatsApp; omitting `sender` (or other values) queues an AI-generated reply and returns `ai_response_pending: true`. - [Send an approved WhatsApp template into a chat](https://devs.izap.ai/en/api-reference/endpoints/chats/send-an-approved-whatsapp-template-into-a-chat.md): Sends an approved template message, used to reopen a conversation outside WhatsApp's 24-hour session window. Persists a rendered copy of the message in the conversation. - [Clear the caller's active business](https://devs.izap.ai/en/api-reference/endpoints/me/clear-the-callers-active-business.md) - [Get the caller's active business](https://devs.izap.ai/en/api-reference/endpoints/me/get-the-callers-active-business.md) - [Switch the caller's active business](https://devs.izap.ai/en/api-reference/endpoints/me/switch-the-callers-active-business.md) - [Authorize a client (OAuth 2.1 + PKCE)](https://devs.izap.ai/en/api-reference/endpoints/oauth/authorize-a-client-oauth-21-+-pkce.md): Authorization endpoint for third-party and MCP clients. Presents/consumes the resource-owner authorization decision for the requesting `client_id`, validates the PKCE `code_challenge` (S256), and redirects back to the client's `redirect_uri` with a single-use authorization `code`. High-level only —… - [Exchange or refresh an OAuth token](https://devs.izap.ai/en/api-reference/endpoints/oauth/exchange-or-refresh-an-oauth-token.md): Token endpoint supporting `grant_type=authorization_code` (PKCE `code_verifier` required, single-use `code`) and `grant_type=refresh_token`. Returns an access token and rotated refresh token. - [OAuth 2.0 Authorization Server Metadata (RFC 8414)](https://devs.izap.ai/en/api-reference/endpoints/oauth/oauth-20-authorization-server-metadata-rfc-8414.md): Discovery document advertising the authorize/token endpoints, supported grant types (`authorization_code`, `refresh_token`), PKCE (S256), and supported `token_endpoint_auth_methods` (`none`, `client_secret_post`, `client_secret_basic`). Used by OAuth and MCP clients to auto-configure. Equivalent met… - [Create a booking](https://devs.izap.ai/en/api-reference/endpoints/scheduling/create-a-booking.md): Books an appointment with the first available provider that offers the requested service in the requested time window. - [List bookings (available slots and appointments)](https://devs.izap.ai/en/api-reference/endpoints/scheduling/list-bookings-available-slots-and-appointments.md): Lists a customer's non-completed, non-cancelled bookings/appointments for an establishment via the connected scheduling provider. - [List scheduling customers](https://devs.izap.ai/en/api-reference/endpoints/scheduling/list-scheduling-customers.md): Looks up customers in the connected scheduling provider (Trinks) by phone number, mirroring/creating local records as needed. - [List services offered by an establishment](https://devs.izap.ai/en/api-reference/endpoints/scheduling/list-services-offered-by-an-establishment.md) - [Confirm and start (or schedule) a transmission](https://devs.izap.ai/en/api-reference/endpoints/transmissions/confirm-and-start-or-schedule-a-transmission.md) - [Get a transmission's status](https://devs.izap.ai/en/api-reference/endpoints/transmissions/get-a-transmissions-status.md) - [List transmissions for a business](https://devs.izap.ai/en/api-reference/endpoints/transmissions/list-transmissions-for-a-business.md) - [Preview a transmission from a CSV recipient list](https://devs.izap.ai/en/api-reference/endpoints/transmissions/preview-a-transmission-from-a-csv-recipient-list.md): Validates recipients against a template's variables, creating a DRAFT transmission. No messages are sent until the draft is confirmed. - [Create a draft WhatsApp template](https://devs.izap.ai/en/api-reference/endpoints/whatsapp-templates/create-a-draft-whatsapp-template.md) - [Get a WhatsApp template](https://devs.izap.ai/en/api-reference/endpoints/whatsapp-templates/get-a-whatsapp-template.md) - [List WhatsApp templates](https://devs.izap.ai/en/api-reference/endpoints/whatsapp-templates/list-whatsapp-templates.md) - [Sync templates from the WhatsApp provider](https://devs.izap.ai/en/api-reference/endpoints/whatsapp-templates/sync-templates-from-the-whatsapp-provider.md): Pulls approved templates from WhatsApp Cloud / Twilio and upserts them locally. - [REST API](https://devs.izap.ai/en/api-reference/introduction.md): The iZap HTTP API — resources, conventions, and error model. - [Analytics MCP](https://devs.izap.ai/en/api-reference/mcp.md): Connect an AI client or your own code to the iZap Analytics MCP server. - [Setup wizard](https://devs.izap.ai/en/api-reference/wizard.md): Scaffold a working iZap integration into your stack with @izap/wizard. - [Development](https://devs.izap.ai/en/development.md): Preview changes locally to update your docs - [Build on iZap](https://devs.izap.ai/en/index.md): The developer platform for WhatsApp-first business automation — a REST API, OAuth 2.0, and an Analytics MCP server for your agents. - [Quickstart](https://devs.izap.ai/en/quickstart.md): Authenticate and make your first call to the iZap API. ## OpenAPI Specs - [openapi](https://devs.izap.ai/api-reference/openapi.json) ## Optional - [API status](https://api.izap.ai/status) - [Trainer](https://trainer.izap.ai/trainer) - [Website](https://izap.ai)