Executions & approvals

Create an approval group

Create a named approval team and select people from the organization directory.

POST/v1/approval-groups

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

How it works

Administrator user token required; Sandbox developers may manage Sandbox groups. memberIds are person IDs from GET /v1/organization/directory in the same organization/environment. Pending invitation profiles may be selected; decisions require a linked active user and active organization membership. Empty groups are allowed for preparation. Use the stable group ID in approval nodes. Requires Idempotency-Key.

Request body

namestringrequiredmin length 1 · max length 80

accessScopestringoptionalmin length 1 · max length 60 · default "general"

memberIdsarrayoptionalmax items 1000 · default []

Required fields & full validation schema → OpenAPI

Request essentials

Authorization: Bearer $FLOWG8_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.

curl -X POST "https://api.flowg8.io/v1/approval-groups" \ -H "authorization: Bearer $FLOWG8_ACCESS_TOKEN" \ -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \ -H "idempotency-key: example-link-group-001" \ -H "content-type: application/json" \ --data-raw '{ "name": "Operations", "memberIds": [ "10000000-0000-4000-8000-000000000006" ] }'

Executions & approvals

Create an approval group

Create a named approval team and select people from the organization directory.

POST/v1/approval-groups

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

How it works

Request body

namestringrequiredmin length 1 · max length 80

accessScopestringoptionalmin length 1 · max length 60 · default "general"

memberIdsarrayoptionalmax items 1000 · default []

Required fields & full validation schema → OpenAPI

Request essentials

Authorization: Bearer $FLOWG8_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 an approval group

How it works

Request body

Request essentials

Ask the docs

Create an approval group

How it works

Request body

Request essentials

Ask the docs