# Macha > Macha is an AI copilot platform that connects to the tools your team already uses (Zendesk, Freshdesk, Gorgias, Front, Shopify, Slack, Stripe, Notion, and more) and gives you AI agents that read data, draft replies, and take action with your approval. Macha is built for support, ops, and CX teams. Agents are configured with instructions, a model, a set of tools (from connectors or custom HTTP endpoints), optional sub-agents, and optional triggers that fire them on external events. ## Documentation ### Overview - [What is Macha](https://www.getmacha.com/docs/macha): Macha is an AI copilot that connects to the tools your team already uses — Zendesk, Freshdesk, Gorgias, Front, Shopify, Slack, and more — and gives you AI agents that read data, draft replies, and take action with your approval. - [Sidekick](https://www.getmacha.com/docs/sidekick): Sidekick is the AI helper built into the Macha dashboard. Ask it to build an agent from a description, wire up a custom API tool, list which connectors broke this week, or answer any question about how Macha works — without leaving the page. ### Getting Started - [Getting Started](https://www.getmacha.com/docs/getting-started): Create your account, walk through onboarding, connect your first integration, and set up your workspace in minutes. ### Core Features - [Agents](https://www.getmacha.com/docs/agents): Create AI agents manually or with the AI builder. Configure instructions, choose models, assign tools, and connect knowledge sources. - [Agent Templates](https://www.getmacha.com/docs/agent-templates): Browse pre-built agent configurations for common workflows like ticket triage, customer replies, and escalation handling. - [Sub-Agents](https://www.getmacha.com/docs/sub-agents): Let agents delegate tasks to specialist agents. Build multi-agent workflows with automatic routing and hierarchical delegation. - [Connectors](https://www.getmacha.com/docs/connectors): Connect your tools — Zendesk, Freshdesk, Shopify, Stripe, Slack, Google Workspace, Notion, and more. Each connector gives your agents read and write access to external services. - [Data Sources](https://www.getmacha.com/docs/data-sources): Give your agents knowledge by uploading documents, crawling websites, or connecting live data from Google Docs, Notion, and Confluence. - [Triggers](https://www.getmacha.com/docs/triggers): Run agents automatically in response to events — new tickets, Slack messages, custom webhooks, or recurring schedules. - [Custom Tools](https://www.getmacha.com/docs/custom-tools): Connect any HTTP API as a tool for your agents. Build tools manually or let the AI Tool Builder configure them from a conversation. - [Studies - AI Analysis](https://www.getmacha.com/docs/studies): Run an AI analysis across thousands of records — Zendesk tickets, support history, and more. Define the columns you want, get a structured results grid, export to CSV, or push back as a knowledge source. - [Agent Evaluation](https://www.getmacha.com/docs/agent-evaluation): Evaluate how your agents actually performed on past conversations. An AI judge runs a checklist over every chat, trigger run, and sub-agent handoff and gives you a percentage-followed score, per-conversation verdicts, and a one-line reason for each call. - [Chat](https://www.getmacha.com/docs/chat): Chat with your AI agents, attach files, view tool calls in real time, confirm write operations, and manage conversations. - [Zendesk Setup & Best Practices](https://www.getmacha.com/docs/zendesk-best-practices): Pick the right trigger for your Zendesk workflow, set up custom Zendesk webhooks, avoid infinite loops on tickets, and understand the Zendesk tools that need explaining. ### Account - [Team](https://www.getmacha.com/docs/team): Invite team members, assign admin or member roles, and collaborate across your organization. - [Billing](https://www.getmacha.com/docs/billing): Manage your subscription, monitor credit usage, configure alerts, and handle payments. - [Settings](https://www.getmacha.com/docs/settings): Configure your profile, organization details, privacy preferences, and data management options. ### Developers - [API Keys](https://www.getmacha.com/docs/api-keys): Generate, scope, and rotate API keys for the Macha REST API. Covers scopes, rate limits, the Authorization header, and security hygiene for production use. - [API Reference](https://www.getmacha.com/docs/api): Full REST API reference — endpoints, request bodies, query parameters, response shapes, and cURL examples for every resource. ## API Reference Macha exposes a versioned REST API (v1). Bearer token auth, cursor pagination, idempotency keys for safe retries. ### Introduction - [Getting Started](https://www.getmacha.com/docs/api/getting-started): Make your first authenticated request against the Macha REST API in under five minutes. - [Authentication](https://www.getmacha.com/docs/api/authentication): Generate API keys, choose the right scopes, and authenticate requests with Bearer tokens. - [Errors](https://www.getmacha.com/docs/api/errors): Every Macha API error returns a stable code your code can switch on. Reference for every code we emit. - [Pagination](https://www.getmacha.com/docs/api/pagination): List endpoints page through results using opaque cursors. Reliable across inserts, no offset drift. - [Idempotency](https://www.getmacha.com/docs/api/idempotency): Send write requests safely. An Idempotency-Key header makes POST and PATCH retryable without duplicates. - [Rate Limits](https://www.getmacha.com/docs/api/rate-limits): Every API key gets 1,000 requests per minute and 10,000 per hour. Headers expose what's left. - [Versioning](https://www.getmacha.com/docs/api/versioning): The Macha API is versioned at /v1. What changes additively, what requires a new version, and how we deprecate. ### Resources #### Agents - [The agent object](https://www.getmacha.com/docs/api/agents/the-agent-object): Shape of the Agent resource as returned by the Macha API. - **GET** [List agents](https://www.getmacha.com/docs/api/agents/list-agents): Returns a paginated list of agents in the organization. - **GET** [Retrieve an agent](https://www.getmacha.com/docs/api/agents/retrieve-an-agent): Fetch a single agent by ID. - **POST** [Create an agent](https://www.getmacha.com/docs/api/agents/create-an-agent): Create a new AI agent. Supports the Idempotency-Key header for safe retries. - **PATCH** [Update an agent](https://www.getmacha.com/docs/api/agents/update-an-agent): Partial update of an existing agent. Send only the fields you want to change. - **DELETE** [Delete an agent](https://www.getmacha.com/docs/api/agents/delete-an-agent): Soft-delete an agent. Restorable from the dashboard trash for 30 days. #### Conversations - [The conversation object](https://www.getmacha.com/docs/api/conversations/the-conversation-object): Shape of the Conversation resource, what's saved when a user (or trigger) chats with an agent. - **GET** [List conversations](https://www.getmacha.com/docs/api/conversations/list-conversations): Search and filter your org's conversation history by agent, date, ticket ID, model, or title keyword. - **GET** [Retrieve a conversation](https://www.getmacha.com/docs/api/conversations/retrieve-a-conversation): Fetch a conversation by ID, including the full message thread. - **GET** [List conversation messages](https://www.getmacha.com/docs/api/conversations/list-conversation-messages): Paginate messages of one conversation. Useful when the message thread is large. #### Connectors - [The connector object](https://www.getmacha.com/docs/api/connectors/the-connector-object): Shape of the Connector resource, a third-party integration like Zendesk, Slack, or Shopify. - **GET** [List connectors](https://www.getmacha.com/docs/api/connectors/list-connectors): Returns every connector instance configured in your organization. - **GET** [Retrieve a connector](https://www.getmacha.com/docs/api/connectors/retrieve-a-connector): Fetch a connector with its full tool surface so you can plan which tools to assign to an agent. #### Custom tools - [The custom tool object](https://www.getmacha.com/docs/api/custom-tools/the-custom-tool-object): Shape of a Custom Tool, a user-defined HTTP endpoint that agents can call as if it were a built-in tool. - **GET** [List custom tools](https://www.getmacha.com/docs/api/custom-tools/list-custom-tools): Returns every custom HTTP tool defined for your organization. - **GET** [Retrieve a custom tool](https://www.getmacha.com/docs/api/custom-tools/retrieve-a-custom-tool): Fetch a single custom tool by ID. - **POST** [Create a custom tool](https://www.getmacha.com/docs/api/custom-tools/create-a-custom-tool): Wire up any HTTP endpoint as a tool agents can call. - **PATCH** [Update a custom tool](https://www.getmacha.com/docs/api/custom-tools/update-a-custom-tool): Change parameters, headers, body template, or rotate auth credentials. - **DELETE** [Delete a custom tool](https://www.getmacha.com/docs/api/custom-tools/delete-a-custom-tool): Hard-delete a custom tool. Removed from every agent that referenced it. #### Data sources - [The source object](https://www.getmacha.com/docs/api/sources/the-source-object): Shape of a Data Source, uploaded files, scraped websites, or connector-backed knowledge bases. - **GET** [List data sources](https://www.getmacha.com/docs/api/sources/list-sources): Returns every source configured for your organization. - **GET** [Retrieve a data source](https://www.getmacha.com/docs/api/sources/retrieve-a-source): Fetch a single source by ID. - **POST** [Create a data source](https://www.getmacha.com/docs/api/sources/create-a-source): Add a website or webpage as a knowledge source. Upload sources are dashboard-only; connector sources auto-create with the integration. - **DELETE** [Delete a data source](https://www.getmacha.com/docs/api/sources/delete-a-source): Hard-delete a source. Cascades to documents and agent references. #### Chatbots - [The chatbot object](https://www.getmacha.com/docs/api/chatbots/the-chatbot-object): Shape of an embeddable chatbot, the widget config that customers embed on their site to expose a Macha agent. - **GET** [List chatbots](https://www.getmacha.com/docs/api/chatbots/list-chatbots): Returns every chatbot defined in the organization. - **GET** [Retrieve a chatbot](https://www.getmacha.com/docs/api/chatbots/retrieve-a-chatbot): Fetch a single chatbot by ID. #### Triggers - [The trigger object](https://www.getmacha.com/docs/api/triggers/the-trigger-object): Shape of a Trigger, webhook or schedule that fires an agent autonomously. - **GET** [List triggers](https://www.getmacha.com/docs/api/triggers/list-triggers): Returns every trigger configured in the organization. - **GET** [Retrieve a trigger](https://www.getmacha.com/docs/api/triggers/retrieve-a-trigger): Fetch a single trigger by ID. #### Team - [The member object](https://www.getmacha.com/docs/api/team/the-member-object): Shape of a team Member, a user with access to the organization. - **GET** [List members](https://www.getmacha.com/docs/api/team/list-members): Returns every member of the organization. #### Analytics - **GET** [Get agent analytics](https://www.getmacha.com/docs/api/analytics/get-agent-analytics): Per-agent usage stats, conversation counts, tool calls, and credit consumption over a time window. #### Organization - [The organization object](https://www.getmacha.com/docs/api/organization/the-organization-object): Shape of the Organization resource, plan, credit balance, resource limits. - **GET** [Retrieve the organization](https://www.getmacha.com/docs/api/organization/retrieve-organization): Fetch the org tied to the current API key. ## Optional - [OpenAPI 3.1 spec](https://dashboard.getmacha.com/api/v1/openapi.json): Machine-readable contract for the REST API. Point an SDK generator or MCP server at this URL. - [Documentation home](https://www.getmacha.com/docs): Browseable docs UI. - [API Reference home](https://www.getmacha.com/docs/api): Browseable API reference UI. - [llms-full.txt](https://www.getmacha.com/llms-full.txt): Full prose content of every doc page concatenated, for LLM ingestion.