Skip to main content
Send your API key as a bearer token on every request:
Authorization: Bearer po_live_xxxxx_xxxxx

How keys work

  • API keys are created from the PostOnce dashboard.
  • Keys are profile-scoped.
  • Keys are shown in full only once at creation time.
  • Keys can be revoked at any time.

Create an API key

  1. Sign in to the PostOnce dashboard.
  2. Open Preferences.
  3. Scroll to the API Keys section.
  4. Enter a key name.
  5. Choose the scopes the key should have.
  6. Click Create API key.
  7. Copy the token immediately and store it somewhere safe.
If you lose the token, create a new key and revoke the old one.

Plans with API access

Public API access is currently available on:
  • Creator
  • Pro

Scopes

Current supported scopes:
  • accounts:read
  • accounts:write
  • media:read
  • media:write
  • posts:read
  • posts:write
  • workflows:read
  • workflows:write
If a key is missing a required scope, the API returns a 403 error with code missing_scope.

Example

curl -s \
  -H "Authorization: Bearer po_live_xxxxx_xxxxx" \
  https://postonce.to/api/public/v1/accounts