# Tuco AI

- [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 1:1 messages, and automate replies.
- [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.
- [Pricing & AI Credits](https://docs.tuco.ai/pricing.md): Tuco AI plans, monthly AI-credit allowances, and one-time credit packs — what each tier includes for iMessage automation at scale.
- [Use Cases](https://docs.tuco.ai/use-cases.md): What teams use Tuco AI for: speed-to-lead, abandoned-checkout recovery, appointment reminders, follow-ups, reactivation, and AI replies — to their own opted-in contacts.
- [How to Automate iMessage for Sales Outreach](https://docs.tuco.ai/guides/automate-imessage-sales-outreach.md): Automate iMessage sales outreach with Tuco AI — verify availability, send personalized blue-bubble campaigns, auto-reply, and fall back to SMS.
- [How to Send iMessage from HubSpot](https://docs.tuco.ai/guides/send-imessage-from-hubspot.md): Send automated iMessage (blue-bubble) texts from HubSpot with Tuco AI: connect via OAuth, sync contacts, and send from a campaign or a HubSpot workflow webhook.
- [How to Send iMessage from GoHighLevel (GHL)](https://docs.tuco.ai/guides/send-imessage-from-gohighlevel.md): Send iMessage from GoHighLevel with Tuco AI — trigger a blue-bubble text from any GHL workflow via webhook, or the Send via Tuco Marketplace action.
- [How to Check if a Phone Number Has iMessage](https://docs.tuco.ai/guides/check-imessage-availability.md): Check whether a phone number or email can receive iMessage before you text. Tuco AI verifies Apple iMessage availability automatically before every send.
- [Bulk iMessage: How to Message a List Without Getting Banned](https://docs.tuco.ai/guides/send-bulk-imessage.md): Can you send bulk iMessage? Tuco AI sends to a lead list as personalized 1:1 messages within per-line daily limits — not spam blasts that get lines banned.
- [iMessage vs SMS for Sales Outreach](https://docs.tuco.ai/guides/imessage-vs-sms-for-sales.md): iMessage vs SMS for sales: iMessage adds read receipts and richer media but reaches only Apple devices; SMS reaches everyone. Use both with Tuco AI.
- [Best iMessage Automation Tools for Business (2026)](https://docs.tuco.ai/guides/best-imessage-automation-tools.md): Compare the best iMessage automation tools for business in 2026 — Tuco AI, Sendblue, LoopMessage, Blooio — and which send true blue-bubble iMessage.
- [Is iMessage Marketing Legal? TCPA & Consent Rules](https://docs.tuco.ai/guides/imessage-compliance-tcpa.md): Is iMessage marketing legal? Under TCPA yes — get consent, honor opt-outs, respect quiet hours. How Tuco AI helps you run compliant iMessage outreach.
- [Reach Android Contacts Without A2P (P2P SMS)](https://docs.tuco.ai/guides/reach-android-contacts-p2p-sms.md): Turn on P2P SMS and a Tuco line texts Android contacts from its own number — green bubble, same thread, no A2P 10DLC registration. Off by default.
- [Does iMessage Need A2P 10DLC Registration?](https://docs.tuco.ai/guides/imessage-a2p-10dlc-carrier-filtering.md): No — iMessage is not carrier SMS, so A2P 10DLC and carrier filtering do not apply. Reaching Android does not require it either, as long as the line sends the SMS itself.
- [Apple Messages for Business vs an iMessage API](https://docs.tuco.ai/guides/apple-messages-for-business-vs-imessage-api.md): Two different products. Messages for Business is Apple's inbound support channel on your brand entry points. An iMessage API sends outbound from a real line.
- [iMessage Delivery: Sent vs Delivered vs Read](https://docs.tuco.ai/guides/imessage-delivery-and-read-receipts.md): What each Tuco message status actually proves, why sent is not delivered, and why read receipts are a floor rather than an exact count.
- [Upload Leads](https://docs.tuco.ai/features/upload-leads.md): Import leads into your workspace using CSV, Google Sheets, HubSpot, or Salesforce.
- [Check iMessage Availability](https://docs.tuco.ai/features/check-availability.md): Verify whether a lead's phone or email supports iMessage before you send, so each message routes through the channel that will actually deliver.
- [Send Messages](https://docs.tuco.ai/features/send-messages.md): Send iMessage, SMS, or email to leads with immediate or scheduled delivery.
- [MCP Server](https://docs.tuco.ai/features/mcp-server.md): Connect Claude, Cursor, Windsurf, and any MCP client to your Tuco workspace. Send iMessages, reply to leads, and read analytics via the authed API.
- [Email Bridge](https://docs.tuco.ai/features/email-bridge.md): Send iMessages by email — no app or API needed.
- [Telegram Integration](https://docs.tuco.ai/features/telegram.md): Get real-time notifications and reply to leads directly from Telegram.
- [Campaigns](https://docs.tuco.ai/features/campaigns.md): Multi-step outreach with AI, stop conditions, and smart follow-ups.
- [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.
- [Limits & Constraints](https://docs.tuco.ai/limits.md): The technical limits that shape how Tuco sends — line activation time, first-message rules, per-line caps, ban behavior, how to reach Android, and what Tuco can't do.
- [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.
- [Replies & Inbox](https://docs.tuco.ai/features/replies.md): See and use replies from your recipients in Tuco, your CRM, and your own workflows.
- [iMessage Reactions](https://docs.tuco.ai/features/reactions.md): Send and receive iMessage reactions (tapbacks) through Tuco.
- [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.
- [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.
- [Knowledge Base](https://docs.tuco.ai/features/knowledge-base.md): AI-powered auto-replies that handle inbound conversations.
- [Language Audit](https://docs.tuco.ai/features/language-audit.md): Control the exact words and phrases Tuco's AI can use in outbound messages — block banned terms and keep every automated reply on-brand.
- [Retroactive Conversation Scanner](https://docs.tuco.ai/features/retroactive-scanner.md): Find and follow up with dormant leads automatically.
- [AI-Powered Campaigns](https://docs.tuco.ai/features/ai-campaigns.md): Let AI personalize every message using lead data, conversation history, and your prompts.
- [Goal Bots](https://docs.tuco.ai/features/goal-bots.md): One prompt, the tools it may use, and the tags that fire it. A goal bot answers when a tagged lead replies, and can read a real calendar and book a real appointment.
- [Workspace API Tools](https://docs.tuco.ai/features/api-tools.md): Create reusable API integrations for campaigns and stop conditions.
- [Message Templates & Personalization](https://docs.tuco.ai/features/message-templates.md): Designing, personalizing, and managing Tuco AI message content safely and at scale.
- [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.
- [Anti-Spam & Messaging Rules](https://docs.tuco.ai/features/anti-spam-guidelines.md): Keep your Tuco AI iMessage line healthy: be a real person, message only opt-in leads, and avoid the spam-reports that trigger an Apple ban.
- [Do Not Contact (DNC)](https://docs.tuco.ai/features/dnc.md): Manage exclusion lists with automatic opt-out detection.
- [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.
- [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.
- [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 All Data (CSV)](https://docs.tuco.ai/features/export-data.md): Download your Unibox conversations and activity log as CSV files — sent messages, replies, reactions, voice notes, calls, and system events.
- [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.
- [Lead Reactivation](https://docs.tuco.ai/features/reactivation.md): Re-engage cold leads with smart re-activation campaigns.
- [HubSpot Integration](https://docs.tuco.ai/integrations/hubspot.md): Connect HubSpot to Tuco AI to sync contacts, map owners, and send iMessage — with live HubSpot properties driving campaign branches and stop rules.
- [GoHighLevel iMessage Integration](https://docs.tuco.ai/integrations/ghl.md): Connect GoHighLevel to Tuco AI to send iMessage from any GHL workflow, sync contacts and tags, and drive campaigns with live GHL data.
- [Close CRM Integration](https://docs.tuco.ai/integrations/close.md): Connect Close to Tuco AI: move a lead into a status and it gets texted, see every message in Close's own conversation view, and reply or call from the lead page.
- [n8n Workflows](https://docs.tuco.ai/integrations/n8n.md): Pre-built workflow templates for CRM sync, reply routing, and outbound campaigns.
- [MCP Server Setup](https://docs.tuco.ai/integrations/mcp-server.md): Control Tuco from Claude Desktop, Cursor, or any MCP-compatible AI agent.
- [Email Bridge Setup](https://docs.tuco.ai/integrations/email-bridge.md): Send iMessages by emailing +phone@send.tuco.ai — no app or API needed.
- [Telegram Bot](https://docs.tuco.ai/integrations/telegram-bot.md): Get real-time reply alerts, approve AI drafts, and send iMessages from Telegram.
- [Webhooks](https://docs.tuco.ai/integrations/webhooks.md): Receive real-time HMAC-signed events when messages are sent, replied, or fail.
- [Invite Your Team](https://docs.tuco.ai/account/team-members.md): Add teammates to your Tuco workspace: invite by email from Settings → Team, choose Admin or Member, and map CRM owners so messages come from the right rep.
- [Why Didn't My Contact Get a Message?](https://docs.tuco.ai/troubleshooting/message-not-received.md): A step-by-step checklist for when a Tuco contact wasn't messaged: missing phone, wrong CRM field, not on iMessage, opt-out, line down, daily cap, or first-message attachment.
- [Message Statuses Explained (Sent vs Delivered)](https://docs.tuco.ai/troubleshooting/message-statuses.md): What each Tuco message status means — queued, scheduled, sent, delivered, fallback, failed — and why a message can show Sent but not be received.
- [Line Health & Apple Sending Restrictions](https://docs.tuco.ai/troubleshooting/line-health-and-restrictions.md): What can restrict or ban a Tuco iMessage line, the warning signs, what Tuco does to protect you, and how to recover — plus how to avoid it.
- [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.
- [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.
- [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.
- [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.
- [Tuco API Keys](https://docs.tuco.ai/api-reference/api-keys.md): Where to find your Tuco API key and how bearer-token auth is used to authenticate every request to the Tuco iMessage API.
- [Agency API Keys](https://docs.tuco.ai/api-reference/agency-api-keys.md): The tucoagency_ key lets an agency create workspaces, move lines between them and read stats across the whole group from one credential — without signing in.
- [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.
- [Message Webhooks](https://docs.tuco.ai/api-reference/message-webhooks.md): Real-time webhooks for message sent, failure, fallback, reply, and AI-draft review events in the Tuco AI iMessage API. Bearer-token auth, JSON responses.
- [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.
- [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.
- [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.
- [Update Webhook](https://docs.tuco.ai/api-reference/endpoint/update-webhook.md): Update a Tuco webhook's URL, subscribed events, name, or active status. Bearer-token REST endpoint.
- [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.
- [Test Webhook](https://docs.tuco.ai/api-reference/endpoint/test-webhook.md): Fire a test event to verify your Tuco webhook endpoint is reachable and responding. Bearer-token REST endpoint.
- [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.
- [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.
- [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.
- [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.
- [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.
- [Drip (bulk shock-absorber)](https://docs.tuco.ai/api-reference/drip.md): POST /api/drip — same body as /api/messages, never 429s a bulk blast, fast-acks 202, and drips sends safely per line. Built for CRM enrollment fan-out.
- [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.
- [Get Message History](https://docs.tuco.ai/api-reference/endpoint/get-messages.md): Read the full conversation with a lead — inbound and outbound messages together, newest first, paginated.
- [Send Drip](https://docs.tuco.ai/api-reference/endpoint/send-drip.md): Same body as POST /api/messages, built for bulk/bursty CRM enrollment fan-out — never 429s, fast-acks 202, drips out safely per line. 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.
- [Upload Attachment](https://docs.tuco.ai/api-reference/upload-attachment.md): Upload an audio clip, image, video, or PDF and get a public URL to use as an attachmentUrl. REST endpoint in the Tuco AI iMessage API — bearer-token auth.
- [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.
- [Read Fallback SMS Config](https://docs.tuco.ai/api-reference/endpoint/fallback-config.md): Read where backup SMS is sent when iMessage fails, including whether your own Telnyx credentials are stored. Bearer-token auth, JSON response.
- [Update Fallback SMS Config](https://docs.tuco.ai/api-reference/endpoint/update-fallback-config.md): Change where backup SMS is sent when iMessage fails, including connecting your own Telnyx account. Bearer-token auth, JSON request and response.
- [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).
- [Message Status](https://docs.tuco.ai/api-reference/endpoint/message-journey.md): A step-by-step timeline of what happened to one message — every retry, fallback and failure, in plain language.
- [Place a Call Endpoint](https://docs.tuco.ai/api-reference/endpoint/place-call.md): Place an outbound click-to-call from your own system: Tuco dials your agent, dials the lead from your Tuco number, and bridges the two.
- [Get Call Recordings Endpoint](https://docs.tuco.ai/api-reference/endpoint/get-recordings.md): Fetch a lead's calls with timing details and the recording download URL, by phone number, using your API key.
- [List Recordings & Uploads Endpoint](https://docs.tuco.ai/api-reference/endpoint/list-recordings.md): List every call recording and uploaded file in your workspace, newest first, with signed playback links.
- [List Conversations](https://docs.tuco.ai/api-reference/endpoint/conversations.md): Read a workspace's inbox — every conversation with its thread, unread count, tags and status, with filters and pagination.
- [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.
- [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.
- [Get All Lines](https://docs.tuco.ai/api-reference/endpoint/get-lines.md): List all iMessage/SMS lines for the authenticated workspace. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON request/response, full schema.
- [Line Plan Limits](https://docs.tuco.ai/api-reference/endpoint/line-limits.md): Read how many phone and email lines your plan allows, how many you already have, and whether another one can be created. Pre-flight for POST /api/line-requests.
- [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.
- [Create / Upload Lead Endpoint](https://docs.tuco.ai/api-reference/endpoint/create.md): Create a single lead or upload multiple leads into a Tuco workspace.
- [Get & Search Leads](https://docs.tuco.ai/api-reference/endpoint/get.md): Retrieve, list, and search leads in a workspace — find a lead by name, email, phone, or company, fetch one by id, or page through them all. Bearer-token auth.
- [Delete Lead Endpoint](https://docs.tuco.ai/api-reference/endpoint/delete.md): Delete one or more leads from a Tuco workspace.
- [List Lead Lists](https://docs.tuco.ai/api-reference/endpoint/list-lists.md): List every lead list in your Tuco workspace with its lead count — the source of the listId used when creating leads or running a bulk availability check.
- [Create Lead List](https://docs.tuco.ai/api-reference/endpoint/create-list.md): Create a lead list in your Tuco workspace, optionally seeding it with contacts. Returns the listId used by the leads and availability endpoints.
- [Delete Lead List](https://docs.tuco.ai/api-reference/endpoint/delete-list.md): Delete a Tuco lead list, keeping or deleting the leads inside it. Bearer-token REST endpoint.
- [List Custom Field Keys](https://docs.tuco.ai/api-reference/endpoint/custom-field-keys.md): Discover the customFields keys actually in use on your Tuco leads, so you can write the right ones in PATCH /api/leads/{id} and in campaign variables.
- [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.
- [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.
- [Manage Line Request](https://docs.tuco.ai/api-reference/endpoint/manage-line-request.md): Cancel a pending Tuco line request or recover its Stripe payment link. Bearer-token REST endpoint.
- [Cancel a Line](https://docs.tuco.ai/api-reference/endpoint/cancel-line.md): Request a line cancellation. The line keeps sending until the end of the period you have paid for, then stops. Nothing is deleted.
- [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.
- [Add Lead to Campaign Endpoint](https://docs.tuco.ai/api-reference/endpoint/campaign-add-lead.md): Add a lead to a specific campaign and start that lead through the sequence.
- [Get Lead](https://docs.tuco.ai/api-reference/endpoint/get-lead.md): Read a single lead in your workspace by id.
- [Update Lead](https://docs.tuco.ai/api-reference/endpoint/update-lead.md): Update a lead's details or tags. Tags are what trigger your bots — a goal bot wakes on the tags listed in its includeTags.
- [Analytics](https://docs.tuco.ai/api-reference/analytics.md): Workspace analytics endpoint — reached, sent, replied, reply %, positive %, filterable by campaign, sender line, user, and date window.
- [Analytics Insights](https://docs.tuco.ai/api-reference/endpoint/analytics-insights.md): Conversation-shaped analytics for the Tuco AI iMessage API: channel and direction split, a cadence-step funnel with reply attribution, and per-day/hour series.
- [Analytics Day Conversations](https://docs.tuco.ai/api-reference/endpoint/analytics-conversations.md): Every conversation behind one day on the insights chart — all threads with a message that day, newest first, with per-day send and reply counts.
- [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.
- [Create Goal Bot](https://docs.tuco.ai/api-reference/endpoint/create-goal-bot.md): Create a goal bot: one prompt, the tools it may use, and the tags that fire it. No stages. Pass status paused to create it dormant.
- [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.
- [Update Goal Bot](https://docs.tuco.ai/api-reference/endpoint/update-goal-bot.md): Change a goal bot's prompt, tools, tags, tone, or status. Takes any subset of the create fields and returns the updated bot.
- [Delete Goal Bot](https://docs.tuco.ai/api-reference/endpoint/archive-goal-bot.md): Permanently remove a goal bot. To stop it without deleting it, PATCH status to paused instead.
- [Simulate Goal Bot](https://docs.tuco.ai/api-reference/endpoint/simulate-goal-bot.md): Run a goal bot against a transcript and see what it would say. Nothing is sent — no message, no draft, no notification. Shows which tools actually ran.
- [List Instruction Bots (retired)](https://docs.tuco.ai/api-reference/endpoint/list-instruction-bots.md): The stage-based engine that used to answer on /api/goal-bots. Being retired — build on goal bots instead.
- [List Task Agents](https://docs.tuco.ai/api-reference/endpoint/list-task-agents.md): List this workspace's task agents, newest first.
- [Create Task Agent](https://docs.tuco.ai/api-reference/endpoint/create-task-agent.md): Alias of POST /api/goal-bots. Task agents and goal bots are the same thing since the engines merged.
- [Update Task Agent](https://docs.tuco.ai/api-reference/endpoint/update-task-agent.md): Update a task agent's prompt, tags, connector or status.
- [Delete Task Agent](https://docs.tuco.ai/api-reference/endpoint/delete-task-agent.md): Delete a task agent. Leads it already handled are unaffected.
- [Enroll Lead (instruction bots)](https://docs.tuco.ai/api-reference/endpoint/enroll-lead.md): Enrol a lead into an instruction bot. Also answers on /api/goal-bots/{id}/enroll. Instruction bots are being retired — goal bots fire on tags instead.
- [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.
- [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.
- [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.
- [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.
- [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.
- [Agency API Keys](https://docs.tuco.ai/api-reference/agency-api-keys.md): The tucoagency_ key lets an agency create workspaces, move lines between them and read stats across the whole group from one credential — without signing in.
- [List Agency Workspaces](https://docs.tuco.ai/api-reference/endpoint/agency-list-workspaces.md): List every workspace in your Tuco agency. Agency API key required — bearer-token auth, JSON response.
- [Create Agency Workspace](https://docs.tuco.ai/api-reference/endpoint/agency-create-workspace.md): Create a new client workspace inside your Tuco agency, subscribe it to a plan, and get its workspace API key back — in one call.
- [Re-mint a Client Workspace Key](https://docs.tuco.ai/api-reference/endpoint/agency-workspace-keys.md): Mint a fresh workspace API key for any client in your agency — for a workspace created before keys were returned, or one whose key was lost or leaked.
- [List Agency Lines](https://docs.tuco.ai/api-reference/endpoint/agency-list-lines.md): List every iMessage/SMS/email line across all workspaces in your Tuco agency, with the workspace each one sits in.
- [Move a Line Between Workspaces](https://docs.tuco.ai/api-reference/endpoint/agency-move-line.md): Move an iMessage/SMS/email line from one workspace in your agency to another. Cancels anything still queued on the line.
- [Agency Overview Stats](https://docs.tuco.ai/api-reference/endpoint/agency-overview.md): Rolled-up messaging stats across every workspace in your Tuco agency, plus a per-workspace breakdown and billing health.
- [Agency Email Preferences](https://docs.tuco.ai/api-reference/endpoint/agency-email-preferences.md): Turn Tuco's notification emails off (or back on) across every workspace in your agency, in one call.
- [Agency Webhooks](https://docs.tuco.ai/api-reference/endpoint/agency-webhooks.md): Register a webhook for any client workspace in your Tuco agency — or for every client in one call — without holding each client's API key.
- [Subscribe a Client to a Plan](https://docs.tuco.ai/api-reference/endpoint/agency-subscribe.md): Put a client workspace on a Tuco plan, charged to your agency card — one call, no checkout page.
- [Monthly Statement](https://docs.tuco.ai/api-reference/endpoint/agency-statement.md): What to invoice your clients this month — setup fees and prorated line charges, per client, per line. For agencies Tuco invoices offline.
- [Workspace Email Preferences](https://docs.tuco.ai/api-reference/endpoint/email-preferences.md): Read and change which Tuco notification emails a workspace sends, using that workspace's API key.
- [Invite a Teammate](https://docs.tuco.ai/api-reference/endpoint/team-invite.md): Invite someone into a Tuco workspace by email, with a role, using that workspace's API key.
- [Force a Line Health Check](https://docs.tuco.ai/api-reference/endpoint/line-health-check.md): Trigger a fresh server ping and iMessage availability probe on one line, using that workspace's API key.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)

## Optional

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.