---
title: "Create workflow"
method: POST
path: "/v1/workflows"
tags: ["Workflows"]
---

# Create workflow

`POST /v1/workflows`

Use this endpoint to create a workflow.

## Headers

- `Authorization` string, required — The `access_token` returned in your most recent [Create access token](https://docs.fourthline.com/reference/create-access-token) response.
- `Cache-Control` string

## Request body

- object
  - `workflowName` string, required — The type of workflow. <br /><br /><img src="https://files.readme.io/5c5228a-Inline_Configurable.svg" align="left"/> **Configurable**: Configure your workflow identifiers with your Fourthline delivery manager. <br /><br />Options include:<br />• `BAV`: A Bank Account Verification flow only. <br />• `IDV`: An Identity Verification flow only. <br />• `IDVandBAV`: An Identity Verification followed by a Bank Account Verification flow. <br />• `IDVandQES`: An Identity Verification followed by a Qualified Electronic Signature flow. <br />• `IDVandQESandBAV`: An Identity Verification followed by a Qualified Electronic Signature and then a Bank Account Verification flow. <br />• `UKI`: An Identity Verification flow for UK clients. <br />•`QES`: A Qualified Electronic Signature flow only.
  - `providerClientId` string, required — Your unique identifier for the client. <br /><br />Format: No set format <br /><br /> <img src="https://files.readme.io/8eb9022-Inline_Tip.svg" align="left"/>**Tip:** This is the **same** value as your `ClientNumberProvider`.
  - `branch` string — Your configuration for this product. <br />Set the string provided by your Fourthline delivery manager.<br />If **not** set, we use your default configuration. <br /><br /><img src="https://files.readme.io/8eb9022-Inline_Tip.svg" align="left"/> **Tip:** Use this parameter for case configuration in older setups.

## Response `200`

Workflow created

- object
  - `workflowId` string — Our unique identifier for the workflow. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`
  - `clientId` string — Our unique identifier for the client, returned in your first [Create workflow](https://docs.fourthline.com/reference/create-workflow) request for this client. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

## Other responses

- `400` — Invalid request parameters
- `401` — Invalid or expired access token
- `403` — Access forbidden
- `500` — Unexpected server error

---

[API](https://skmtc.net/fourthline/apis/fourthline-apis.md) · [All operations](https://skmtc.net/fourthline/apis/fourthline-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthline/fourthline-apis/versions/7991ae7c8383/schema)