Create approval workflow

POST/approvals/workflows

The workflow is created in the caller's organization. approver_role, when set, must be org_owner, org_admin, org_member, org_viewer or the id of a permission set of the organization (400 otherwise).

Headers

Authorizationstring

Bearer <token>.

Body parameters

Workflow

approver_roleoptional string

approver_user_idsoptional array of string

created_atoptional string

descriptionoptional string

idoptional string

is_enabledoptional boolean

min_approvalsoptional integer

nameoptional string

organization_idoptional string

requires_approvaloptional boolean

scope_idoptional string

scope_typeoptional string

updated_atoptional string

workflow_typeoptional string

Returns

201CreatedApprovalWorkflow

approver_roleoptional string

approver_user_idsoptional array of string

created_atoptional string

descriptionoptional string

idoptional string

is_enabledoptional boolean

min_approvalsoptional integer

nameoptional string

organization_idoptional string

requires_approvaloptional boolean

scope_idoptional string

scope_typeoptional string

updated_atoptional string

workflow_typeoptional string

Errors

400Bad Request

curl --request POST \ --url 'https://api.hexelstudio.com/v1/approvals/workflows' \ --header "Authorization: Bearer $ACCESS_TOKEN" \ --header 'Content-Type: application/json' \ --data '{ "approver_role": "string", "approver_user_ids": [ "string" ], "created_at": "2026-01-01T00:00:00Z", "description": "string", "id": "string", "is_enabled": true, "min_approvals": 0, "name": "string", "organization_id": "string", "requires_approval": true, "scope_id": "string", "scope_type": "string", "updated_at": "2026-01-01T00:00:00Z", "workflow_type": "string" }'

const res = await fetch("https://api.hexelstudio.com/v1/approvals/workflows", { method: "POST", headers: { Authorization: `Bearer ${process.env.ACCESS_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ "approver_role": "string", "approver_user_ids": [ "string" ], "created_at": "2026-01-01T00:00:00Z", "description": "string", "id": "string", "is_enabled": true, "min_approvals": 0, "name": "string", "organization_id": "string", "requires_approval": true, "scope_id": "string", "scope_type": "string", "updated_at": "2026-01-01T00:00:00Z", "workflow_type": "string" }), }) const data = await res.json()

import os import requests res = requests.post( "https://api.hexelstudio.com/v1/approvals/workflows", headers={"Authorization": f"Bearer {os.environ['ACCESS_TOKEN']}"}, json={ "approver_role": "string", "approver_user_ids": [ "string", ], "created_at": "2026-01-01T00:00:00Z", "description": "string", "id": "string", "is_enabled": True, "min_approvals": 0, "name": "string", "organization_id": "string", "requires_approval": True, "scope_id": "string", "scope_type": "string", "updated_at": "2026-01-01T00:00:00Z", "workflow_type": "string", }, ) data = res.json()

{ "approver_role": "string", "approver_user_ids": [ "string" ], "created_at": "2026-01-01T00:00:00Z", "description": "string", "id": "string", "is_enabled": true, "min_approvals": 0, "name": "string", "organization_id": "string", "requires_approval": true, "scope_id": "string", "scope_type": "string", "updated_at": "2026-01-01T00:00:00Z", "workflow_type": "string" }