Developer tools

Create a service account

Create an integration identity with an explicit permission ceiling.

POST/v1/service-accounts

Administrator or Sandbox developer requiredUser token only. Integration keys cannot authorize this operation.

How it works

Create the account with a user token, then issue API keys with serviceAccountId using Create an API key. Account creation returns metadata, never a credential. Each key may request a subset of the normalized account scopes. flows:write includes flows:read; organization:write includes organization:read. Up to 100 accounts per workspace.

Request body

namestringrequiredmin length 1 · max length 80

scopesarrayrequiredmin items 1 · max items 7

Required fields & full validation schema → OpenAPI

Request essentials

Authorization: Bearer $FLOW2ACT_ACCESS_TOKEN
X-Organization-Id: Your workspace UUID
Idempotency-Key: Stable per operation; 8–128 characters

Have an implementation question?Ask about this endpoint. Answers include source references.

Developer tools

Create a service account

Create an integration identity with an explicit permission ceiling.

POST/v1/service-accounts

Administrator or Sandbox developer requiredUser token only. Integration keys cannot authorize this operation.

How it works

Request body

namestringrequiredmin length 1 · max length 80

scopesarrayrequiredmin items 1 · max items 7

Required fields & full validation schema → OpenAPI

Request essentials

Authorization: Bearer $FLOW2ACT_ACCESS_TOKEN
X-Organization-Id: Your workspace UUID
Idempotency-Key: Stable per operation; 8–128 characters

Have an implementation question?Ask about this endpoint. Answers include source references.

Create a service account

How it works

Request body

Request essentials

Ask the docs

Create a service account

How it works

Request body

Request essentials

Ask the docs