# SendSeven

> SendSeven is a unified messaging API that lets developers send and receive messages across WhatsApp, Telegram, SMS, Email, Facebook Messenger, Instagram, and website Live Chat through one consistent REST interface, one webhook format, and one contact model. These are the official developer docs at docs.sendseven.com, covering authentication, sending and receiving messages, webhooks, contacts, campaigns, visual automation flows, AI assistants, and multi-tenant sub-account provisioning.

Key things to know when answering questions about SendSeven:

- Base URL for all REST calls: `https://api.sendseven.com/api/v1`. Every request is authenticated with `Authorization: Bearer <api token>`; tokens are created in the SendSeven Dashboard.
- One schema for every channel: the same `POST /messages` call sends to WhatsApp, Telegram, SMS, Email, Messenger, Instagram, or Live Chat; channel-specific rules (such as the WhatsApp 24-hour window and approved templates) are documented per channel.
- Inbound messages and delivery status are delivered as signed webhooks; signatures must be verified.
- Workspaces are called tenants. Platforms and agencies can provision sub-accounts programmatically and drive them from one parent token via the `X-Tenant-ID` header.
- Errors return a consistent JSON envelope (`detail` + `error_code`); rate limits are reported via `X-RateLimit-*` headers and `Retry-After` on 429. Read Error Handling and Rate Limits before writing retry logic.
- Docs are English-only. The brand name is SendSeven (SendSeven GmbH); `msgapi.io` is an internal staging domain and is not customer-facing.

## Start here

- [Introduction](https://docs.sendseven.com/index.md): SendSeven API documentation - build multi-channel messaging into your application
- [Quickstart: Send Your First Message](https://docs.sendseven.com/getting-started/quickstart.md): Get up and running with the SendSeven API in under 5 minutes
- [Authentication](https://docs.sendseven.com/getting-started/authentication.md): Learn how to authenticate with the SendSeven API using API tokens, OAuth2 apps, or Bearer tokens
- [Error Handling](https://docs.sendseven.com/getting-started/error-handling.md): Understand SendSeven API error codes and implement proper error handling
- [Rate Limits](https://docs.sendseven.com/getting-started/rate-limits.md): Understand SendSeven API rate limits and how to handle them
- [Prompt for your AI coding assistant](https://docs.sendseven.com/llm-prompt.md): A ready-to-paste prompt that teaches Claude Code, Codex, Cursor, GitHub Copilot and other AI coding assistants how to integrate the SendSeven API correctly.

## Messaging

- [Channel Capabilities & Limits](https://docs.sendseven.com/guides/messaging/channel-capabilities.md): Compare what every SendSeven messaging channel supports — message types, interactive elements, length limits, and delivery rules — side by side.
- [Send Text Messages](https://docs.sendseven.com/guides/messaging/send-text-message.md): Learn how to send text messages to conversations and contacts using the SendSeven API.
- [Send Media Messages](https://docs.sendseven.com/guides/messaging/send-media-message.md): Send images, documents, audio, and video messages through the SendSeven API.
- [Interactive Messages](https://docs.sendseven.com/guides/messaging/interactive-messages.md): Send button and list messages that let customers choose from predefined options using the SendSeven API.
- [Carousel Messages](https://docs.sendseven.com/guides/messaging/carousel-messages.md): Send multi-card scrollable carousel messages through the SendSeven API on WhatsApp and Messenger.
- [Reactions](https://docs.sendseven.com/guides/messaging/reactions.md): Add and remove emoji reactions on messages using the SendSeven API.

## WhatsApp Business API

- [Getting Started with WhatsApp](https://docs.sendseven.com/guides/whatsapp/getting-started.md): Overview of the WhatsApp Business API integration with SendSeven, including the 24-hour messaging window and template basics.
- [24-Hour Messaging Window](https://docs.sendseven.com/guides/whatsapp/24h-window.md): Understand WhatsApp's 24-hour customer service window and how it affects your messaging strategy with SendSeven.
- [Understanding Templates](https://docs.sendseven.com/guides/whatsapp/templates.md): Learn about WhatsApp message templates, categories, language support, and how to manage them through the SendSeven API.
- [Send a Template Message](https://docs.sendseven.com/guides/whatsapp/send-template.md): Send approved WhatsApp template messages with variables through the SendSeven API.
- [WhatsApp Interactive Messages](https://docs.sendseven.com/guides/whatsapp/interactive-messages.md): Send interactive button messages, list messages, and more on WhatsApp through the SendSeven API.
- [WhatsApp Coexistence vs. API-Only](https://docs.sendseven.com/guides/whatsapp/coexistence.md): Understand WhatsApp Coexistence mode, how it differs from the API-only setup, the tradeoffs of each, and how to decide which mode is right for your business.
- [WhatsApp Flows](https://docs.sendseven.com/guides/whatsapp/flows.md): Use WhatsApp Flows to create interactive multi-step forms and experiences within WhatsApp conversations.

## Other channels

- [Telegram Bot](https://docs.sendseven.com/guides/channels/telegram.md): Set up and use a Telegram Bot channel with the SendSeven API.
- [Email](https://docs.sendseven.com/guides/channels/email.md): Set up email messaging and campaigns with the SendSeven API.
- [Facebook Messenger](https://docs.sendseven.com/guides/channels/messenger.md): Set up Facebook Messenger with the SendSeven API.
- [Instagram DM](https://docs.sendseven.com/guides/channels/instagram.md): Set up Instagram Direct Messaging with the SendSeven API.
- [Live Chat Widget](https://docs.sendseven.com/guides/channels/live-chat.md): Add a SendSeven Live Chat widget to your website for real-time customer conversations.
- [Browser Push Notifications](https://docs.sendseven.com/guides/channels/browser-push.md): Collect browser push subscribers via a SendSeven-hosted popup or directly on your own domain with the Push SDK.

## Conversations & inbox

- [Conversations Overview](https://docs.sendseven.com/guides/conversations/overview.md): How conversations work in SendSeven — statuses, the Open/Snoozed/Closed tabs, assignment, internal notes, AI assist, summaries, and single-agent vs multi-agent mode.
- [Snooze & Postpone Conversations](https://docs.sendseven.com/guides/conversations/snooze.md): Postpone a conversation until a chosen time, optionally auto-reopening it when the customer replies — with the snooze/unsnooze API and the conversation.updated webhook.
- [Custom Inboxes](https://docs.sendseven.com/guides/workspace/custom-inboxes.md): Split your unified SendSeven conversation feed into focused inboxes by channel, email connection, tag, or custom field — and control exactly who sees what.

## Contacts & lists

- [Manage Contacts](https://docs.sendseven.com/guides/contacts/manage-contacts.md): Create, retrieve, update, delete, and import contacts using the SendSeven API.
- [Tags & Lists](https://docs.sendseven.com/guides/contacts/tags-and-lists.md): Organize contacts and conversations with color-coded tags and contact lists using the SendSeven API.
- [Custom Fields](https://docs.sendseven.com/guides/contacts/custom-fields.md): Define custom field schemas and store typed key-value data on contacts using the SendSeven API.

## Webhooks

- [Webhook Setup](https://docs.sendseven.com/guides/webhooks/setup.md): Create, update, and manage webhook endpoints to receive real-time events from SendSeven.
- [Webhook Events Reference](https://docs.sendseven.com/guides/webhooks/events.md): Complete reference for all SendSeven webhook event types and their payload formats.
- [attachment.summarized event](https://docs.sendseven.com/guides/webhooks/events.md): Webhook sent when an AI summary of an inbound image or PDF is ready (agent-made or on demand); payload carries attachment_id, message_id, conversation_id and the summary object (untrusted customer-file content).
- [Message Types Reference](https://docs.sendseven.com/guides/webhooks/message-types.md): Complete reference of all message type payloads in SendSeven webhook events, covering inbound and outbound messages across all channels.
- [Signature Verification](https://docs.sendseven.com/guides/webhooks/signature-verification.md): Verify SendSeven webhook signatures to ensure requests are authentic and untampered.

## Attachments & media

- [Attachments Overview](https://docs.sendseven.com/guides/attachments/overview.md): Re-usable file attachments in SendSeven: upload once, reference by UUID across messages and campaigns.
- [Upload an Attachment](https://docs.sendseven.com/guides/attachments/upload.md): Upload a binary file via multipart/form-data and get a re-usable attachment UUID.
- [Create an Attachment from a URL](https://docs.sendseven.com/guides/attachments/from-url.md): Have SendSeven fetch a publicly hosted file and store it as a re-usable attachment.
- [Use an Attachment in a Message](https://docs.sendseven.com/guides/attachments/use-in-message.md): Reference an uploaded attachment by UUID when sending a message or campaign.
- [AI File Summaries](https://docs.sendseven.com/guides/attachments/ai-summaries.md): Read the AI summary of an inbound image or PDF (`ai_summary`, `ai_summary_available`, `ai_summary_credits` on message attachments), or request one on demand with GET/POST /api/v1/attachments/{id}/summary (2 AI credits per image, 3 per PDF; text is untrusted customer-file content).
- [Attachment Errors](https://docs.sendseven.com/guides/attachments/errors.md): All error responses returned by the attachments endpoints, and how to handle them.
- [Attachments FAQ](https://docs.sendseven.com/guides/attachments/faq.md): Common questions about the SendSeven attachments system.

## Campaigns & subscribers

- [Getting Subscribers & Opt-Ins](https://docs.sendseven.com/guides/campaigns/getting-subscribers.md): How to build a compliant subscriber base: lists, START/STOP keywords, default lists, double opt-in, channel identifiers, and what you can (and cannot) import.
- [Messaging Campaigns](https://docs.sendseven.com/guides/campaigns/messaging-campaigns.md): Create, schedule, and send bulk messaging campaigns across channels using the SendSeven API.
- [Email Campaigns](https://docs.sendseven.com/guides/campaigns/email-campaigns.md): Create and send HTML email campaigns using SendSeven's 3-tier template system.
- [Promotion Tools](https://docs.sendseven.com/guides/campaigns/promotion-tools.md): Generate channel deep links, QR codes, promo images, and HTML snippets that onboard your customers into WhatsApp, Telegram, Messenger, Instagram, and SMS — with the opt-in built in.

## Flows (visual automation)

- [Flows: Overview](https://docs.sendseven.com/guides/flows/overview.md): Build visual automation journeys that send messages, wait for replies, branch on conditions, and track engagement across all channels.
- [Flows: Node Reference](https://docs.sendseven.com/guides/flows/nodes.md): Reference for every node type available in the Flow Builder, including config fields, output variables, and gotchas.
- [Flows: Variables](https://docs.sendseven.com/guides/flows/variables.md): The {{...}} template engine used by every Flow node: namespaces, nested paths, typed JSON rendering, secrets and redaction.
- [Flows: Triggers and the API](https://docs.sendseven.com/guides/flows/triggers-and-api.md): Start flow runs via REST API, schedule them, or kick them off from inbound messages or keyword bots.
- [Flows: Multi-language](https://docs.sendseven.com/guides/flows/multi-language.md): Localize flow content into 40+ languages. Default language, per-node translations, stale detection, and manual edit protection.
- [Flows: Channel persistence](https://docs.sendseven.com/guides/flows/channel-persistence.md): Control whether a flow sticks to the channel a contact originated on, or follows the node's channel chain.
- [Flows: Examples](https://docs.sendseven.com/guides/flows/examples.md): Complete worked examples covering onboarding, drip campaigns, abandoned-cart recovery, and bot-style conversations.

## Bots, AI & knowledge base

- [Building Bots: Overview](https://docs.sendseven.com/guides/bots/overview.md): All SendSeven bot types side by side: FAQ Bot, Keyword Bot and Conversational Agent (Beta). What each one does, when to use which, plans, AI-credit billing, channel rules, Flows and hand-off.
- [Build an FAQ Bot](https://docs.sendseven.com/guides/bots/build-an-assistant.md): End-to-end walkthrough: create an FAQ Bot, choose a template, connect your Knowledge Base, test it, and deploy it to a widget or channel.
- [Build a Keyword Bot](https://docs.sendseven.com/guides/bots/build-a-keyword-bot.md): Set up an autoresponder that matches keywords and replies with text, media, templates, or button menus — no AI required.
- [Conversational Agents (Beta)](https://docs.sendseven.com/guides/bots/agents/overview.md): AI agents that pick their own tools, follow reusable versioned skills, collect validated answers and complete tasks for Flows. Sub-pages under /guides/bots/agents/: quickstart, agents-api, skills-api, turn-lifecycle, test-console-and-turns, skill-goals, flows, handoff-and-assignment, agent-builder, billing-and-limits.
- [Knowledge Base](https://docs.sendseven.com/guides/ai/knowledge-base.md): Search your knowledge base with AI-powered answers, manage documents, and crawl websites using the SendSeven API.
- [Knowledge Base for Bots](https://docs.sendseven.com/guides/bots/knowledge-base.md): Folder strategy, supported document types, recrawl cadence, and multi-bot folder reuse for FAQ Bots.
- [Prompt Engineering for FAQ Bots](https://docs.sendseven.com/guides/bots/prompt-engineering.md): Tune the personality prompt, confidence threshold, KB-only mode, escalation prompts, and AI disclosure for your FAQ Bots.
- [Deploy a Bot to a Widget](https://docs.sendseven.com/guides/bots/deploy-to-widget.md): Embed an FAQ Bot on your website using the SendSeven widget. Covers embed snippet, widget types, data attributes, and activation rules.
- [Deploy a Bot to Channels](https://docs.sendseven.com/guides/bots/deploy-to-channels.md): Activate a bot on WhatsApp, Telegram, Messenger, Instagram, or Email using Activation Rules. Covers channel selection, schedule, priority, and contact-tag filters.
- [Migrating Legacy Bots to Flows](https://docs.sendseven.com/guides/bots/migrating-to-flows.md): Three older bot types — Router, Lead Qualification, and Appointment — are being retired in favour of Flows. This guide explains why, how the auto-conversion works, and how to safely cut over.

## Multi-tenancy & sub-accounts (for platforms and agencies)

- [Multi-Tenancy & Sub-Accounts](https://docs.sendseven.com/multi-tenancy/overview.md): Programmatically provision and control sub-accounts (workspaces) for your own customers — the model, the capability matrix, and how to automate the whole lifecycle.
- [Creating Sub-Accounts](https://docs.sendseven.com/multi-tenancy/create-subaccounts.md): Programmatically provision a new workspace (tenant) per customer under your billing account.
- [Cross-Account API Access](https://docs.sendseven.com/multi-tenancy/cross-tenant-api.md): Control every sub-account from a single parent token using the tenants:manage grant and the X-Tenant-ID header — no per-workspace login.
- [Channel Connect Links](https://docs.sendseven.com/multi-tenancy/channel-connect-links.md): Generate a secure, time-limited link your customer opens to connect their own WhatsApp, Telegram, email, or SMS channel — fully programmatically.

## Integrations & no-code

- [Zapier](https://docs.sendseven.com/guides/integrations/zapier.md): Connect SendSeven to 7,000+ apps with the official Zapier integration — triggers, actions, and searches over OAuth.
- [n8n](https://docs.sendseven.com/guides/integrations/n8n.md): Automate SendSeven with the n8n community node — actions, real-time triggers, and use as a tool for n8n AI Agents.
- [Make.com](https://docs.sendseven.com/guides/integrations/make.md): Build visual SendSeven automations in Make.com — connect over API token or OAuth2, with action/search modules and webhook triggers.
- [HubSpot](https://docs.sendseven.com/integrations/hubspot.md): Manage SendSeven conversations and messaging from inside HubSpot, sync contacts both ways, and run campaigns to HubSpot lists — all from your HubSpot contact records.
- [MCP Server](https://docs.sendseven.com/guides/mcp/mcp-server.md): Connect AI assistants like Claude, GPT, and Gemini to SendSeven using the Model Context Protocol (MCP).

## OAuth & SSO

- [Login with SendSeven (OAuth 2.0)](https://docs.sendseven.com/guides/oauth/login-with-sendseven.md): Add 'Login with SendSeven' to your application using the standard OAuth 2.0 Authorization Code flow — no OIDC library required

## Code examples

- [Quick Reference](https://docs.sendseven.com/guides/code-examples/quick-reference.md): Complete, runnable code examples for common SendSeven API operations in Python, JavaScript, and cURL.

## Optional

- [Interactive API Reference (OpenAPI / Swagger)](https://api.sendseven.com/api/v1/docs): Full machine-readable REST reference for every endpoint, generated from the live OpenAPI schema.
- [OpenAPI schema (JSON)](https://api.sendseven.com/api/v1/openapi.json): The raw OpenAPI 3 specification for the SendSeven REST API.
- [Postman collection](https://docs.sendseven.com/openapi/sendseven-api.postman_collection.json): Postman v2.1 collection generated from the OpenAPI schema; set the apiToken variable to your API token.
- [SendSeven Dashboard](https://app.sendseven.com): Web app where API tokens, channels, contacts, campaigns, flows, and bots are managed.
- [Code examples on GitHub](https://github.com/SendSeven-GmbH/code_examples): Runnable Python, JavaScript, and cURL examples for the SendSeven API.
- [Product website](https://sendseven.com): Product overview, pricing, and company information for SendSeven GmbH.

## About this file

This file follows the llms.txt convention (https://llmstxt.org). It is generated from the
live documentation sidebar, so every link above resolves to a published page on
docs.sendseven.com. Each link points at the page's plain-Markdown version; drop the
`.md` suffix for the rendered HTML page. Questions: support@sendseven.com