POST accounts

Configure a Flow Music account

June 3, 2026

Request Headers
Request Body
Responses
Model
Examples
Try It

Configure a Flow Music account for API access using its refresh token. See Setup Flow Music for how to obtain the token.

You can configure up to 50 Flow Music accounts per single useapi.net account.

https://api.useapi.net/v1/flowmusic/accounts

Request Headers

Authorization: Bearer {API token}
Content-Type: application/json
# Alternatively you can use multipart/form-data
# Content-Type: multipart/form-data

API token is required, see Setup useapi.net for details.

Request Body

{
  "refresh_token": "bdykxtrr5eaf...",
  "maxJobs": 12
}

refresh_token is required, the flowmusic.app refresh token (≥10 chars). See Setup Flow Music.
maxJobs is optional, the max concurrent jobs for this account, 1–16.

Responses

200 OK — existing account updated.

{
  "email": "[email protected]",
  "tier": "plus",
  "subscription_plan": "plus-monthly",
  "provider": "g1_entitlement",
  "user_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "maxJobs": 12,
  "added": "2026-06-01T12:00:00.000Z",
  "refreshed_at": "2026-06-01T12:00:00.000Z",
  "refreshed_count": 0,
  "access_token": "eyJ…redacted…zmQ",
  "access_token_expires_at": "2026-06-01T13:00:00.000Z",
  "refresh_token": "l6e…redacted…z4v",
  "session_id": "f0e1d2c3-b4a5-4768-9a0b-1c2d3e4f5a6b"
}

Credit balances are not included here — fetch them live from GET /accounts/email.

201 Created — new account configured. Same body as 200.

400 — missing/invalid refresh_token, or the token failed to refresh.

{ "error": "Parameter refresh_token is required", "code": 400 }

401 Unauthorized — invalid API token.

Model

200 (updated) and 201 (created) return the same account record.

{
  email: string
  tier: 'free' | 'starter' | 'plus' | 'member' | 'unknown'
  subscription_plan?: string         // paid tiers only
  provider?: string                  // paid tiers only
  user_id: string                    // the account's user UUID
  maxJobs: number
  added: string                      // ISO 8601 timestamp
  refreshed_at: string               // ISO 8601 timestamp
  refreshed_count: number
  access_token: string               // redacted
  access_token_expires_at: string    // ISO 8601 timestamp
  refresh_token: string              // redacted
  session_id: string
  error?: string                     // present only when the account needs re-authentication
}

Examples

Curl
Python

curl -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_TOKEN" \
     -X POST "https://api.useapi.net/v1/flowmusic/accounts" \
     -d '{ "refresh_token": "bdykxtrr5eaf...", "maxJobs": 12 }'

import requests
response = requests.post(
    'https://api.useapi.net/v1/flowmusic/accounts',
    headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
    json={'refresh_token': 'bdykxtrr5eaf...', 'maxJobs': 12}
)
print(response.status_code, response.json())