Zolt AI
API Documentation← Back to site

API Documentation

Zolt AI exposes a REST API, a board/element CRUD API, inbound and outbound webhooks, and an MCP server so external tools and automations can create content, read board data, and react to activity on your account.

What you can build

  • An automated content pipeline. Generate a post in the business's brand voice, render its image, then schedule it, all from a tool like Pabbly or Zapier.
  • A quality check in your own workflow. Score a draft against the brand before it goes anywhere, or revise it with an instruction.
  • A knowledge feed into Zolt. Push text or a link (a webpage, a YouTube or TikTok video) onto a board from another system with an inbound webhook, so every piece of content that follows can use them.
  • An AI agent that works with your boards. Connect Claude, ChatGPT or another MCP client to list, read and add to your boards.

API keys and webhooks are included on Studio and Enterprise. Compare plans.

Base URL

All endpoints below are relative to:

https://app.getzolt.ai

Authentication

Every endpoint on this site is authenticated with an API key, sent as a plain header on every request:

X-API-Key: ci_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Create a key from inside the app: open Settings → API Keys from the account menu, choose the business, and click "+ New key". The full key is shown to you exactly once at creation time — copy it somewhere safe. Only a hash of the key is ever stored, so if you lose it, revoke it and create a new one.

A key can be scoped to one specific board or to every board in the business (the default). A board-scoped key gets a 403 if used against any other board.

Rate limits

Each API key is limited to 30 requests per rolling 60-second window. The limit is tracked per key, not per IP, and is enforced across every endpoint on this site. Exceeding it returns:

429 Too Many Requests{ "error": "Rate limit exceeded. Try again shortly." }

Errors

Every error response is a JSON object with a single, human-readable error string:

{ "error": "Description of what went wrong." }

Status codes you'll see across these APIs:

400 Bad RequestMissing or invalid fields in the request body.
401 Unauthorized{ "error": "Missing or invalid X-API-Key." }
403 ForbiddenThe key isn't authorized for the business/board/resource requested.
404 Not FoundThe business, board, zone, tile, or generation doesn't exist.
429 Too Many RequestsRate limit exceeded.
502 Bad GatewayAn upstream provider (model, render, publish) call failed.

What's covered

  • REST API — generate/revise/idea/score content, render images and videos, publish to X, and schedule posts. This is the automation-friendly surface built for tools like Pabbly and Zapier.
  • Board API — list, create, update, and delete boards, zones, and tiles directly, plus a one-shot “ask this board” endpoint.
  • Webhooks — push content into a board from an external trigger, and receive signed events when a tile finishes processing or a generation completes.
  • MCP server — connect an AI agent (Claude, ChatGPT, etc.) directly to your boards over the Model Context Protocol.

Questions developers ask

Does Zolt AI have an API?
Yes. There is a REST API for generating, revising, scoring, rendering, scheduling and publishing content; a board API for reading and writing boards, zones and tiles; inbound and outbound webhooks; and an MCP server that lets an AI agent work with your boards directly.
Which Zolt plans include API access?
API keys and webhooks are included on Studio and Enterprise.
How is API usage billed?
API calls draw Zolt Credits from the same balance as the app. There is no separate API meter, and each key is limited to 30 requests per rolling 60-second window.
Can I connect Zolt to Zapier, Pabbly or an AI agent?
Yes. The REST API is the automation-friendly surface built for tools like Pabbly and Zapier, and the MCP server connects Claude, ChatGPT or any other MCP-compatible client to your boards.

Questions, or found something undocumented? Contact support.