Skip to main content

Create an API key

Updated October 10, 2026

An API key lets one of your systems, or a tool such as Zapier, Make or n8n, call the InfluenceBot API for this workspace. Give each integration its own key with only the scopes it needs.

Create a key

  1. Go to Settings → API keys.
  2. Under Create an API key, enter a Name, for example "Zapier" or "Reporting script".
  3. Choose the Mode: Live (real data and actions) or Test (lower rate limits, for development). Live keys start with ib_live_, test keys with ib_test_.
  4. Under What the key can do, tick the scopes:
    • Read: read brands, personas, assets, content, posts, jobs, credit balance and webhook settings.
    • Create drafts: create brands and draft content. Nothing is published and no credits are spent.
    • Generate (paid): start paid generations within your Automation Policy limits.
    • Schedule posts: schedule posts on connected accounts, confirmed by a person unless your policy allows it.
  5. Optional: open Advanced: limit to specific resources for narrower scopes, such as brands:read. Add webhooks:manage only if a no-code app must register webhooks.
  6. Set Expires after (days). 90 is a good default. No expiry date is allowed only if your organization permits it.
  7. Click Create key.
  8. Copy the key and store it in a secrets manager. Click I’ve stored it. It is never shown again.

Rotate or revoke a key

  • Rotate gives a new key with the same name, scopes and expiry. Choose an Overlap (hours) so the old key keeps working while you update your systems.
  • Revoke stops the key immediately and for good. This can't be undone.

The list shows only each key's prefix, its status (Active, Rotating, Rotated, Revoked or Expired), who created it and when it was last used.

What it costs

Keys are free. Paid calls made with a key use credits like the same action in the app. See How credits work.

What can block you

  • Only owners and admins can create, rotate and revoke keys, and only while signed in. A key can never manage keys.
  • If its creator's role changes or they leave, the key loses that access too.

Messages you may see

  • "Copy it now: it will not be shown again"
  • "Choose at least one scope."
  • "This key is missing a scope": create a key with the right scope.

More in Developers