Use the public API
Updated October 10, 2026
The InfluenceBot public API lets your systems read workspace data, create drafts, start paid generations and schedule posts. This page is a short guide for the person who will set it up. The full reference is in the app.
Open the reference
- Go to Settings → API docs.
- Read Getting started: the Base URL, the version and an example request.
- Use Search the reference or filter by Section to find an operation. Each one shows its scope, parameters, request body and responses.
- Webhook events lists every event and its payload.
The basics
- Authentication: send your API key as a Bearer token. A key acts as its creator and is limited to its scopes.
- Versioning: everything is under /api/v1. New fields can appear at any time, so ignore fields you don't know.
- Idempotency: send an Idempotency-Key header on POST. It is required on paid and publish calls, so a retry never charges twice.
- Pagination: lists use a cursor and answer with a nextCursor until the last page.
- Rate limits: depend on your plan. Over the limit you get 429 with Retry-After.
- Errors: every error has a code, a message, a request id and whether it can be retried.
Paid and publish calls
When your Automation Policy needs a person, the API answers 202 with status confirmation_required. The person who created the key confirms it in the app, under Automation → Overview → Approvals & confirmations. Then poll the confirmation or subscribe to the confirmation.resolved webhook. A machine never confirms its own call.
What it costs
Calls that read or draft are free. Paid generation uses credits: the estimate is reserved and only the actual cost is charged. See How credits work.
What can block you
- The API must be enabled for your workspace.
- A few operations listed in the reference may not be served to API keys yet; they answer that they are not implemented.
- When the reference shows MOCK, it is generated in your browser and nothing is called.
Messages you may see
- "This key is missing a scope"
- "May need confirmation" on paid and publish operations in the reference.
