Create workflow

post

https://api.ext-sandbox.fourthline.com/v2/workflows

Use this endpoint to create a workflow that combines multiple Fourthline products into a single onboarding flow.

Note Note: Specify either partnerClientId or clientId. Do not provide both parameters in the same request.

Body Params

workflow

string

required

The name of the workflow configuration to run.

Format: Must be unique and contain only letters, numbers, underscores (_). Maximum length: 128 characters.

Example: UK_KYC_v2

Note Note: Once set, the workflow name cannot be changed.

partnerClientId

string

Your unique identifier for the client. Once assigned, use the same partnerClientId for that client (natural person) across all workflows.

Reusing the same identifier helps prevent duplicate client records.

Format: We recommend a uuid-style string

Tip: Provide either partnerClientId or clientId — not both.

clientId

uuid

Fourthline identifier for the client.
Use the clientId when using Authentication products, as the reference workflow is selected based on this value.

Tip: Provide either partnerClientId or clientId — not both.

Headers

Authorization

string

required

Defaults to Bearer <access_token>

The access_token returned in your most recent Create access token response.

Cache-Control

string

Defaults to no-cache

To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to no-cache.

Responses

201Workflow created

400Bad Request (request validation). Returned when the request body fails validation.

404Returned when the requested workflow definition is not configured, or when neither clientId nor partnerClientId can be resolved to an existing client.