Skip to main content

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

  1. Go to Settings → API docs.
  2. Read Getting started: the Base URL, the version and an example request.
  3. Use Search the reference or filter by Section to find an operation. Each one shows its scope, parameters, request body and responses.
  4. 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.

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.

More in Developers