Skip to content

Authentication

Authentication

The Flow API uses API keys for authentication. Include your API key in the Authorization header of all requests.

Getting an API Key

  1. Log in to Flow
  2. Go to Settings → API Keys
  3. Click “Create API Key”
  4. Copy your key - it will only be shown once

Using Your API Key

Include your API key in the Authorization header:

Terminal window
curl https://api.flowsocial.app/v1/posts \
-H "Authorization: Bearer flow_sk_live_..." \
-H "Content-Type: application/json"

API Key Format

API keys follow this format:

  • Live keys: flow_sk_live_... - Use in production
  • Test keys: flow_sk_test_... - Use in development

Security Best Practices

  • Never expose your API key in client-side code
  • Store keys in environment variables
  • Rotate keys periodically
  • Use different keys for development and production

Rate Limits

API requests are rate limited based on your plan:

PlanRequests/minute
Stream60
River180
Ocean600

See Rate Limits for more details.