Skip to main content
The Storytime API uses API keys sent as a Bearer token. Every request to a /v1/* endpoint must include:
Authorization
string
Bearer pk_live_xxxxxxxxxxxxxxxxxxxxxxxx
Keys are prefixed pk_live_… (production). Treat a key like a password — it carries your brand’s access.

Generating a key

API keys are created from the Storytime brand dashboard:
  1. Go to your Profile → Developers → API Keys
  2. Click Create key and give it a name (e.g. Production, Zapier), and select the scopes it needs.
  3. Optionally set an expiry (30 days / 90 days / 1 year); otherwise the key never expires.
  4. Copy the key immediately — for security the full token is shown only once and cannot be retrieved again. Store it in a secrets manager.
Don’t see the Developers section? API access is enabled per brand — contact Storytime support to turn it on for your account.

Scopes

(grant the minimum a key needs)
ScopeGrants
campaigns:readRead campaigns
campaigns:writCreate & edit campaigns
analytics:readRead campaign analytics

Managing Keys

  • Rotate: create a new key, update your integration, then revoke the old one - zero downtime (you can hold multiple active keys).
  • Revoke: revoke a key from the dashboard at any time. Requests with a revoked or expired key are rejected immediately with 401
  • Rate limit: each key is limited to 600 requests/minute. Exceeding it returns 429 RATE_LIMITED