# Switchbord ## Docs - [Compatibility API endpoints for legacy integrations](https://docs.switchbord.ai/api-reference/compatibility.md): Contact upsert, journey trigger, and Emarsys webhook ingress endpoints — with full request schemas, response shapes, and copy-paste curl examples. - [Contacts API — read and manage contact records](https://docs.switchbord.ai/api-reference/contacts-api.md): Operator read endpoints for listing contacts, synced WhatsApp templates, campaigns, and journey definitions. Use compatibility endpoints to upsert contacts from external systems. - [Conversations API: list threads and send messages](https://docs.switchbord.ai/api-reference/conversations.md): Operator endpoints for listing conversations, retrieving message history, checking inbox summary counts, and sending outbound messages within the 24-hour service window. - [Health and readiness endpoints](https://docs.switchbord.ai/api-reference/health.md): Use GET /health and GET /ready to verify that Switchbord's API process is running, identify the deployed version, and confirm provider configuration before accepting traffic. - [Switchbord API overview and authentication](https://docs.switchbord.ai/api-reference/introduction.md): Switchbord exposes a JSON-over-HTTP API for webhook ingestion, contact sync, journey triggers, and operator reads. Learn the base URL, auth model, and endpoint groups. - [Webhook events API — inspect and replay deliveries](https://docs.switchbord.ai/api-reference/webhook-events.md): List, inspect, and replay webhook deliveries and normalized events. Covers forensics via webhook-rejections, audit log entries, and the runtime snapshot endpoint. - [Receiving WhatsApp webhooks with Switchbord](https://docs.switchbord.ai/api-reference/webhooks.md): Configure Meta webhook verification, validate HMAC signatures, and understand how Switchbord ingests, normalizes, and queues inbound WhatsApp events. - [Switchbord data model: entities and relationships](https://docs.switchbord.ai/concepts/data-model.md): A customer-facing guide to the key entities in Switchbord — workspaces, contacts, conversations, messages, templates, campaigns, journeys, and more. - [How Switchbord works: the platform overview](https://docs.switchbord.ai/concepts/platform.md): Understand how Switchbord processes WhatsApp messages end-to-end — from Meta webhook delivery through operator inbox, outbound dispatch, and automation. - [How Switchbord handles webhook ingestion and replay](https://docs.switchbord.ai/concepts/webhooks.md): How Switchbord receives webhooks from Meta, verifies signatures, stores envelopes, normalizes events, and lets you replay failed deliveries safely. - [Feature flags in Switchbord](https://docs.switchbord.ai/configuration/feature-flags.md): Understand how Switchbord uses feature flags to control which product capabilities are active in your workspace, and what to do when a feature is unavailable. - [Integrating external systems with Switchbord](https://docs.switchbord.ai/configuration/integrations.md): Connect your CRM, marketing platform, and automation tools to Switchbord using compatibility endpoints, webhook ingress, and outbound event delivery. - [Managing provider credentials and secrets in Switchbord](https://docs.switchbord.ai/configuration/secrets.md): Store and rotate your Meta access token, webhook signing secret, and verify token securely through the Switchbord UI — no redeployment required. - [Self-hosting configuration: environment variables reference](https://docs.switchbord.ai/environment.md): Environment variables for self-hosted Switchbord — covers Supabase connection, Meta bootstrap credentials, workspace access control, and data mode. - [Running WhatsApp broadcast campaigns in Switchbord](https://docs.switchbord.ai/guides/campaigns.md): Campaigns let you send a templated message to a targeted group of contacts at a scheduled time. Learn how to build an audience, select a template, schedule, and track delivery. - [Connect your WhatsApp number to Switchbord](https://docs.switchbord.ai/guides/connect-whatsapp.md): Link your Meta WhatsApp Business Account and phone number to Switchbord by configuring provider credentials and verifying your webhook endpoint. - [Syncing and managing contacts in Switchbord](https://docs.switchbord.ai/guides/contacts.md): View, tag, and segment your WhatsApp contacts in Switchbord — and sync contact records from external systems using the API. - [Managing conversations in the Switchbord inbox](https://docs.switchbord.ai/guides/inbox.md): Use the Switchbord inbox to view, assign, and reply to WhatsApp conversations — with service-window gating, tags, notes, and shared replies. - [Building automated messaging journeys in Switchbord](https://docs.switchbord.ai/guides/journeys.md): Journeys are automated flows that trigger based on contact events and run sequences of waits, conditions, template sends, and contact mutations. Learn how to build and publish one. - [Creating and managing WhatsApp message templates](https://docs.switchbord.ai/guides/templates.md): Learn how to create WhatsApp message templates in Meta, sync them to Switchbord, and use them in the inbox, campaigns, and journeys. - [Switchbord: open-source WhatsApp control plane](https://docs.switchbord.ai/introduction.md): Switchbord gives you a self-hosted WhatsApp inbox, automation engine, and API — replacing vendor lock-in with full control over your messaging operations. - [Quickstart: Send your first WhatsApp message](https://docs.switchbord.ai/quickstart.md): Go from a fresh Switchbord workspace to a verified WhatsApp connection and your first outbound test message in a few focused steps. - [Workspace setup: connect WhatsApp and validate credentials](https://docs.switchbord.ai/setup.md): Walk through the Switchbord Setup wizard to attach your WhatsApp channel, store your provider secrets, and confirm the connection before going live. ## OpenAPI Specs - [openapi](https://docs.switchbord.ai/api-reference/openapi.json)