{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/en/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["cards","card","native-mcp-clients","mcp-clients"]},"type":"markdown"},"seo":{"title":"Insyder Public API"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"insyder-public-api","__idx":0},"children":["Insyder Public API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the Insyder Public API to read workspace data, analytics, and normalized connection results, and to manage the business data your team owns. The API is RESTful, returns JSON, and is versioned at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.insyder.io/v1"]},"."]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":3,"cardMinWidth":240},"children":[{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Quickstart","icon":"rocket","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/en/guides/quickstart"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make your first request, paginate a collection, and update a lead."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Authentication","icon":"key","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/en/guides/authentication"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a personal API key and choose its workspaces and scopes."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"API reference","icon":"code","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/en/api/openapi"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Explore every endpoint, parameter, schema, and error response."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-essentials","__idx":1},"children":["API essentials"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Base URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.insyder.io/v1"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-Key: insyder_live_..."]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Format"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JSON fields in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["snake_case"]},"; timestamps in UTC ISO 8601"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rate limit"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["20 accepted requests per UTC second, per user across all keys"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pagination"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cursor-based; 50 records by default and 200 maximum"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Errors"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/problem+json"]}," with stable error codes"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["API keys only expose workspaces selected when the key is created, and access is always checked against the owner's current workspace membership. Removing a member or changing their role takes effect immediately."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-can-access","__idx":2},"children":["What you can access"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Read accounts, leads, content, interactions, historical data, analytics, competitors, and sanitized connection results."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Update user-managed lead fields: status, email, phone, and notes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create and manage products, create append-only purchases, and prepare expiring exports when the key has the required scope."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Read normalized iClosed call data and Meta story responses without exposing credentials, raw provider payloads, connection settings, or synchronization controls."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Imported leads, content, interactions, snapshots, scores, runs, and other system-derived facts are read-only. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/en/api/openapi"},"children":["API reference"]}," for the exact permissions on each operation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connect-your-iclosed-appointments-and-sales","__idx":3},"children":["Connect your iClosed appointments and sales"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See your iClosed appointments and sales on your Instagram lead profiles. The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/en/guides/iclosed"},"children":["iClosed integration guide"]}," walks you through adding the essential Instagram question to your booking forms, connecting your workspace, and following statuses, products, and sales in Insyder."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connect-your-whop-payments","__idx":4},"children":["Connect your Whop payments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See what your Whop business actually received and find each payment on the profile of the lead who made it. The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/en/guides/whop"},"children":["Whop integration guide"]}," explains the connection, email matching, the Whop received tile, and matching transactions without a lead by hand."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connect-your-ai-assistant","__idx":5},"children":["Connect your AI assistant"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Insyder has two separate MCP servers. Choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Native MCP"]}," to work with your workspace data, or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Documentation MCP"]}," to learn about the API."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Native MCP — your data"},"children":["Native MCP — your data"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Documentation MCP — these docs"},"children":["Documentation MCP — these docs"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Purpose"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read data and perform the same actions as the public API"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search guides and inspect the API contract"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Server"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.insyder.io/mcp"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://docs.insyder.io/mcp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OAuth sign-in or API key; approved workspaces, scopes, and role apply"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None; public documentation without workspace access"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"native-mcp","__idx":6},"children":["Native MCP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Connect Claude Desktop, ChatGPT, or another MCP client to your leads, products, purchases, analytics, and exports. The native MCP provides all 51 public API operations."]},{"$$mdtype":"Tag","name":"NativeMCPClients","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/en/guides/native-mcp"},"children":["native MCP guide"]}," covers direct OAuth setup, optional API keys, permissions, every tool, and troubleshooting."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"documentation-mcp","__idx":7},"children":["Documentation MCP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Connect an MCP-compatible assistant to search this documentation and inspect the OpenAPI contract. The published MCP tools are read-only: they do not include an API key, access an Insyder workspace, or execute public API requests."]},{"$$mdtype":"Tag","name":"MCPClients","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These buttons connect the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["documentation server only"]},". It cannot read or change your Insyder data."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/en/guides/mcp"},"children":["Learn about the documentation MCP server"]},"."]}]},"headings":[{"value":"Insyder Public API","id":"insyder-public-api","depth":1},{"value":"API essentials","id":"api-essentials","depth":2},{"value":"What you can access","id":"what-you-can-access","depth":2},{"value":"Connect your iClosed appointments and sales","id":"connect-your-iclosed-appointments-and-sales","depth":2},{"value":"Connect your Whop payments","id":"connect-your-whop-payments","depth":2},{"value":"Connect your AI assistant","id":"connect-your-ai-assistant","depth":2},{"value":"Native MCP","id":"native-mcp","depth":3},{"value":"Documentation MCP","id":"documentation-mcp","depth":3}],"frontmatter":{"title":"Introduction","description":"Build secure integrations with the Insyder Public API.","seo":{"title":"Insyder Public API"}},"lastModified":"2026-09-17T12:06:39.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/en","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}