# Tuco AI

## Docs

- [Events, Metrics & Dashboards](https://docs.tuco.ai/analytics/events-and-metrics.md): Understanding what Tuco AI makes visible about performance, usage, and outcomes. Reporting + observability for outbound iMessage campaigns on Tuco AI.
- [Export & Data Integration](https://docs.tuco.ai/analytics/export-strategies.md): How Tuco AI works with your own reporting and BI tools. Reporting + observability for outbound iMessage campaigns on Tuco AI.
- [Archive Goal Bot](https://docs.tuco.ai/api-reference/endpoint/archive-goal-bot.md): Archive a Tuco AI goal bot — soft-deletes the bot, stops new enrollments, and removes it from the active list while preserving past conversations and analytics.
- [Bulk Availability Check Endpoint](https://docs.tuco.ai/api-reference/endpoint/bulk-check-availability.md): Bulk-check iMessage availability for many leads or a single address. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON request/response, full.
- [Cancel Pending Messages](https://docs.tuco.ai/api-reference/endpoint/cancel-for-lead.md): Cancel all pending, scheduled, and queued Tuco AI messages for a lead — use when a lead replies Stop or opts out to instantly halt outbound campaigns.
- [Check iMessage Availability (Single Address)](https://docs.tuco.ai/api-reference/endpoint/check-availability.md): Check if a phone number or email is on iMessage -- no saved lead required. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON.
- [Check iMessage Availability (Round-Robin)](https://docs.tuco.ai/api-reference/endpoint/check-availability-rr.md): Check if a phone or email has iMessage, using round-robin across your lines. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON.
- [Create Goal Bot](https://docs.tuco.ai/api-reference/endpoint/create-goal-bot.md): Create a Tuco AI goal bot — define the goal, persona, knowledge base, and approval mode (manual, copilot, or autopilot) for outbound iMessage conversations.
- [Create Line Request](https://docs.tuco.ai/api-reference/endpoint/create-line-request.md): Create a new phone or email line request for the authenticated workspace. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON request/response.
- [Create Webhook](https://docs.tuco.ai/api-reference/endpoint/create-webhook.md): Register a new webhook endpoint — the signing secret is returned once. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON request/response.
- [Delete API Tool](https://docs.tuco.ai/api-reference/endpoint/delete-tool.md): Delete an API tool from your Tuco AI workspace — removes the tool from goal bots and campaigns so it can no longer be invoked by AI replies or automations.
- [Delete Webhook](https://docs.tuco.ai/api-reference/endpoint/delete-webhook.md): Permanently delete a webhook. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON request/response, full schema and code examples.
- [Enroll Lead in Goal Bot](https://docs.tuco.ai/api-reference/endpoint/enroll-lead.md): Enroll a lead in a Tuco AI goal bot — starts the AI conversation, sends the first iMessage, and begins tracking goal completion for the lead.
- [Evaluate Campaign Conditions](https://docs.tuco.ai/api-reference/endpoint/evaluate-conditions.md): Evaluate Tuco AI campaign conditions for a lead — returns matching step branches, firing stop-rules, and eligibility for the next campaign action.
- [Get Goal Bot](https://docs.tuco.ai/api-reference/endpoint/get-goal-bot.md): Fetch a Tuco AI goal bot by ID — returns goal definition, persona, knowledge base, approval mode, active enrollment count, and config metadata.
- [Get Line Request](https://docs.tuco.ai/api-reference/endpoint/get-line-request.md): Fetch the current status of a line request. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON request/response, full schema and code examples.
- [Check Replies](https://docs.tuco.ai/api-reference/endpoint/get-replies.md): Get replies for a lead or campaign — who replied, what they said, and the conversation context. REST endpoint in the Tuco AI iMessage API — bearer-token auth.
- [Get Webhook](https://docs.tuco.ai/api-reference/endpoint/get-webhook.md): Get details for a single webhook. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON request/response, full schema and code examples.
- [Check iMessage Availability (Single Lead)](https://docs.tuco.ai/api-reference/endpoint/lead-check-availability.md): Check if a specific lead is reachable via iMessage. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON request/response, full schema and code.
- [List Goal Bots](https://docs.tuco.ai/api-reference/endpoint/list-goal-bots.md): List all AI goal bots in your Tuco AI workspace — returns goal, persona, status (active or archived), approval mode, and enrollment counts for each bot.
- [List API Tools](https://docs.tuco.ai/api-reference/endpoint/list-tools.md): List all custom API tools registered in your Tuco AI workspace — tools that goal bots and campaigns can call to fetch lead data or trigger external actions.
- [List Webhooks](https://docs.tuco.ai/api-reference/endpoint/list-webhooks.md): List all webhooks registered in your workspace. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON request/response, full schema and code.
- [Manage Line Request](https://docs.tuco.ai/api-reference/endpoint/manage-line-request.md): Cancel a pending request or recover its payment link. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON request/response, full schema and.
- [Create or Update API Tool](https://docs.tuco.ai/api-reference/endpoint/save-tool.md): Create or update a custom API tool in Tuco AI — define name, HTTP method, URL, headers, and JSON schema so goal bots and AI campaigns can call your endpoint.
- [Send Message](https://docs.tuco.ai/api-reference/endpoint/send-message.md): Send an iMessage, SMS, or email to a contact — the core automation endpoint. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON.
- [Send Reaction](https://docs.tuco.ai/api-reference/endpoint/send-reaction.md): Send an iMessage tapback reaction to an existing message in your workspace. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON.
- [Send Typing Indicator](https://docs.tuco.ai/api-reference/endpoint/send-typing-indicator.md): Start a short iMessage typing signal before sending a message. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON request/response, full.
- [Send with Attachments](https://docs.tuco.ai/api-reference/endpoint/send-with-attachments.md): Send images, videos, voice notes, and files via iMessage — with or without text. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON.
- [Test API Tool](https://docs.tuco.ai/api-reference/endpoint/test-tool.md): Test a Tuco AI API tool with sample arguments before wiring it into a goal bot or campaign — returns the live response, latency, and validation errors.
- [Test Webhook](https://docs.tuco.ai/api-reference/endpoint/test-webhook.md): Fire a test webhook to verify your endpoint is reachable. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON request/response, full schema and.
- [Unenroll Lead](https://docs.tuco.ai/api-reference/endpoint/unenroll-lead.md): Unenroll a lead from a Tuco AI goal bot — stops further AI replies and cancels scheduled messages while preserving conversation history.
- [Update Goal Bot](https://docs.tuco.ai/api-reference/endpoint/update-goal-bot.md): Update a Tuco AI goal bot — change goal, persona, knowledge base, tools, or approval mode without disrupting active enrollments or history.
- [Update Webhook](https://docs.tuco.ai/api-reference/endpoint/update-webhook.md): Update a webhook's URL, events, name, or active status. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON request/response, full schema and.
- [Webhooks Overview](https://docs.tuco.ai/api-reference/endpoint/webhook.md): Register endpoints, manage subscriptions, and test delivery — all via API. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON.
- [Errors & Status Codes](https://docs.tuco.ai/api-reference/errors.md): HTTP status codes, error formats, and what to do when things go wrong. Part of the Tuco AI iMessage API reference — bearer-token auth, JSON responses, examples.
- [API Overview](https://docs.tuco.ai/api-reference/introduction.md): How the Tuco AI API behaves from your point of view. Part of the Tuco AI iMessage API reference — bearer-token auth, JSON responses, examples in curl, Node.
- [Leads API](https://docs.tuco.ai/api-reference/leads.md): How Tuco AI treats leads created, updated, and viewed through the API. Part of the Tuco AI iMessage API reference — bearer-token auth, JSON responses, examples.
- [Lines API](https://docs.tuco.ai/api-reference/lines.md): How Tuco AI exposes your sending identities through the API. Part of the Tuco AI iMessage API reference — bearer-token auth, JSON responses, examples in curl.
- [Message Webhooks](https://docs.tuco.ai/api-reference/message-webhooks.md): Real-time notifications for message sent, failure, fallback, and reply events. Part of the Tuco AI iMessage API reference — bearer-token auth, JSON responses.
- [Messages](https://docs.tuco.ai/api-reference/messages.md): The message object, lifecycle, and how Tuco processes your sends. Part of the Tuco AI iMessage API reference — bearer-token auth, JSON responses, examples in.
- [Health, Reliability & Limits](https://docs.tuco.ai/architecture/health-checks.md): What you can expect from Tuco AI when things are healthy or under strain. Design notes for builders integrating with the Tuco AI iMessage platform on dedicated.
- [Architecture Overview](https://docs.tuco.ai/architecture/overview.md): How Tuco AI is structured from a customer’s point of view. Design notes for builders integrating with the Tuco AI iMessage platform on dedicated Apple hardware.
- [How Tuco Sends Messages](https://docs.tuco.ai/architecture/workers.md): What you can expect from Tuco’s sending engine without looking under the hood. Design notes for builders integrating with the Tuco AI iMessage platform on.
- [FAQ & Troubleshooting](https://docs.tuco.ai/faq.md): Answers to common questions about Tuco AI campaigns, availability, workers, webhooks, failures, and integrations
- [Campaigns FAQ](https://docs.tuco.ai/faq/campaigns.md): Deep-dive FAQs about campaign creation, limits, timing, and edge cases. From the Tuco AI team — outbound iMessage automation for B2B and B2C teams.
- [Integrations FAQ](https://docs.tuco.ai/faq/integrations.md): FAQ for connecting Tuco AI to CRMs, backends, and other systems using only public APIs. From the Tuco AI team — outbound iMessage automation for B2B and B2C.
- [Security, Access & Billing FAQ](https://docs.tuco.ai/faq/security-billing.md): Frequently asked questions about Tuco AI API keys, workspace access, read-only mode, billing, secret-rotation, and safe usage patterns for production teams.
- [Background Processing & Reliability FAQ](https://docs.tuco.ai/faq/workers.md): What you can expect from Tuco’s behind-the-scenes processing, without needing to know the internals. From the Tuco AI team — outbound iMessage automation for.
- [AI-Powered Campaigns](https://docs.tuco.ai/features/ai-campaigns.md): Let AI personalize every message using lead data, conversation history, and your prompts. Built into Tuco AI iMessage automation — works with HubSpot.
- [Workspace API Tools](https://docs.tuco.ai/features/api-tools.md): Create reusable API integrations for campaigns, branching, and stop conditions. Built into Tuco AI iMessage automation — works with HubSpot, Salesforce.
- [Campaigns](https://docs.tuco.ai/features/campaigns.md): Multi-step outreach with AI, branching, stop conditions, and smart follow-ups. Built into Tuco AI iMessage automation — works with HubSpot, Salesforce.
- [Check iMessage Availability](https://docs.tuco.ai/features/check-availability.md): Verify if a lead's phone or email supports iMessage before sending. Built into Tuco AI iMessage automation — works with HubSpot, Salesforce, GoHighLevel, and.
- [Compliance, Consent & Opt-Outs](https://docs.tuco.ai/features/compliance-and-optouts.md): Patterns for respectful, compliant messaging with Tuco AI across iMessage, SMS, and email. Built into Tuco AI iMessage automation — works with HubSpot.
- [Do Not Contact (DNC)](https://docs.tuco.ai/features/dnc.md): Manage exclusion lists with automatic opt-out detection. Built into Tuco AI iMessage automation — works with HubSpot, Salesforce, GoHighLevel, and direct API.
- [Email Bridge](https://docs.tuco.ai/features/email-bridge.md): Send iMessages by email — no app or API needed. Built into Tuco AI iMessage automation — works with HubSpot, Salesforce, GoHighLevel, and direct API customers.
- [Failures, Fallbacks & Delivery Outcomes](https://docs.tuco.ai/features/failures-and-fallbacks.md): Understand what can happen to a message and how to react in your own systems. Built into Tuco AI iMessage automation — works with HubSpot, Salesforce.
- [Goal Bots](https://docs.tuco.ai/features/goal-bots.md): AI-driven conversational bots that guide leads through goal stages. Built into Tuco AI iMessage automation — works with HubSpot, Salesforce, GoHighLevel, and.
- [Knowledge Base](https://docs.tuco.ai/features/knowledge-base.md): AI-powered auto-replies that handle inbound conversations. Built into Tuco AI iMessage automation — works with HubSpot, Salesforce, GoHighLevel, and direct API.
- [Language Audit](https://docs.tuco.ai/features/language-audit.md): Control which words and phrases your AI uses in outbound messages. Built into Tuco AI iMessage automation — works with HubSpot, Salesforce, GoHighLevel, and.
- [MCP Server](https://docs.tuco.ai/features/mcp-server.md): Connect AI assistants like Claude, Cursor, and Windsurf to your Tuco workspace. Built into Tuco AI iMessage automation — works with HubSpot, Salesforce.
- [Message Templates & Personalization](https://docs.tuco.ai/features/message-templates.md): Designing, personalizing, and managing Tuco AI message content safely and at scale. Built into Tuco AI iMessage automation — works with HubSpot, Salesforce.
- [Rate Limits & Sending Caps](https://docs.tuco.ai/features/rate-limits.md): Per-line daily and hourly caps Tuco enforces on every send path — including Quick Send, campaigns, and HubSpot — to protect your Apple ID reputation.
- [iMessage Reactions](https://docs.tuco.ai/features/reactions.md): Send and receive iMessage reactions (tapbacks) through Tuco. Built into Tuco AI iMessage automation — works with HubSpot, Salesforce, GoHighLevel, and direct.
- [Lead Reactivation](https://docs.tuco.ai/features/reactivation.md): Re-engage cold leads with smart re-activation campaigns. Built into Tuco AI iMessage automation — works with HubSpot, Salesforce, GoHighLevel, and direct API.
- [Replies & Inbox](https://docs.tuco.ai/features/replies.md): See and use replies from your recipients in Tuco, your CRM, and your own workflows. Built into Tuco AI iMessage automation — works with HubSpot, Salesforce.
- [Retroactive Conversation Scanner](https://docs.tuco.ai/features/retroactive-scanner.md): Find and follow up with dormant leads automatically. Built into Tuco AI iMessage automation — works with HubSpot, Salesforce, GoHighLevel, and direct API.
- [Send Messages](https://docs.tuco.ai/features/send-messages.md): Send iMessage, SMS, or email to leads with immediate or scheduled delivery. Built into Tuco AI iMessage automation — works with HubSpot, Salesforce.
- [Spam Monitoring](https://docs.tuco.ai/features/spam-monitor.md): Track Tuco AI line health, failure rates, and spam risk in real time. Works with HubSpot, Salesforce, GoHighLevel, and direct iMessage flows.
- [Telegram Integration](https://docs.tuco.ai/features/telegram.md): Get real-time notifications and reply to leads directly from Telegram. Built into Tuco AI iMessage automation — works with HubSpot, Salesforce, GoHighLevel.
- [Upload Leads](https://docs.tuco.ai/features/upload-leads.md): Import leads into your workspace using CSV, Google Sheets, HubSpot, or Salesforce. Built into Tuco AI iMessage automation — works with HubSpot, Salesforce.
- [Atomic Duplicate Guard — POST /api/messages](https://docs.tuco.ai/imessage-double-send-guard.md): How Tuco prevents duplicate sends from concurrent API calls or upstream retries. Fires at /api/messages for every channel (iMessage, SMS, email).
- [Welcome to Tuco AI](https://docs.tuco.ai/index.md): Tuco AI docs: iMessage automation for B2B sales teams. Verify Apple ID availability, send personalized blasts at scale, and automate replies.
- [Email Bridge](https://docs.tuco.ai/integrations/email-bridge.md): Send iMessages by emailing +phone@send.tuco.ai — no app or API needed. Native integration for Tuco AI iMessage automation — works alongside HubSpot.
- [GoHighLevel Integration](https://docs.tuco.ai/integrations/ghl.md): Sync contacts, map owners, and use GHL data in campaigns. Native integration for Tuco AI iMessage automation — works alongside HubSpot, Salesforce.
- [HubSpot Integration](https://docs.tuco.ai/integrations/hubspot.md): Sync contacts, map owners, and log activity between Tuco and HubSpot. Native integration for Tuco AI iMessage automation — works alongside HubSpot, Salesforce.
- [MCP Server](https://docs.tuco.ai/integrations/mcp-server.md): Control Tuco from Claude Desktop, Cursor, or any MCP-compatible AI agent. Native integration for Tuco AI iMessage automation — works alongside HubSpot.
- [n8n Workflows](https://docs.tuco.ai/integrations/n8n.md): Pre-built workflow templates for CRM sync, reply routing, and outbound campaigns. Native integration for Tuco AI iMessage automation — works alongside HubSpot.
- [Telegram Bot](https://docs.tuco.ai/integrations/telegram-bot.md): Get real-time reply alerts, approve AI drafts, and send iMessages from Telegram. Native integration for Tuco AI iMessage automation — works alongside HubSpot.
- [Webhooks](https://docs.tuco.ai/integrations/webhooks.md): Receive real-time HMAC-signed events when messages are sent, replied, or fail. Native integration for Tuco AI iMessage automation — works alongside HubSpot.
- [Operations Runbook](https://docs.tuco.ai/operations/runbook.md): Step-by-step guidance for diagnosing and resolving common Tuco production issues from your side. Runbook + ops playbooks for Tuco AI iMessage automation on.
- [Quick Start](https://docs.tuco.ai/quickstart.md): Get started with Tuco AI in under 5 minutes. Tuco AI is the iMessage automation platform for B2B and B2C teams — dedicated Apple hardware, CRM-native, no A2P.

## OpenAPI Specs

- [openapi](https://docs.tuco.ai/api-reference/openapi.json)

## Optional

- [Dashboard](https://app.tuco.ai)