Organization

Save business details

Save progress with revision protection; partial drafts are supported.

PUT/v1/organization/business-profile

Administrator role required · Live onlyUser token only. Integration keys cannot authorize this operation.

How it works

Use revision 0 for the first save, then the revision returned by the API. VAT ID and commercial-register references are optional. Required: legalName, addressLine1, postalCode, city, country (ISO 3166-1 alpha-2), contactName, contactEmail and businessUseConfirmed. Activated organizations must keep required data complete. Requires Idempotency-Key.

Request body

revisionintegerrequiredmin 0 · max 9007199254740991

detailsobjectrequired

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 PUT "https://api.flowg8.io/v1/organization/business-profile" \ -H "authorization: Bearer $FLOWG8_ACCESS_TOKEN" \ -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \ -H "idempotency-key: example-save-business-profile-001" \ -H "content-type: application/json" \ --data-raw '{ "revision": 0, "details": { "legalName": "Example GmbH", "addressLine1": "Teststraße 1", "addressLine2": "", "postalCode": "10115", "city": "Berlin", "country": "DE", "contactName": "Alex Example", "contactEmail": "operations@example.test", "vatId": "", "registerNumber": "", "businessUseConfirmed": true } }'

Organization

Save business details

Save progress with revision protection; partial drafts are supported.

PUT/v1/organization/business-profile

Administrator role required · Live onlyUser token only. Integration keys cannot authorize this operation.

How it works

Request body

revisionintegerrequiredmin 0 · max 9007199254740991

detailsobjectrequired

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.

Save business details

How it works

Request body

Request essentials

Ask the docs

Save business details

How it works

Request body

Request essentials

Ask the docs