GuidesAPI ReferenceChangelogAPI StatusAPI PolicyGusto Security
API Reference
These docs are for v2024-03-01. Click to read the latest docs for v2026-06-15.

Create a flow

Generate a link to access a pre-built workflow in Gusto white-label UI. For security, all generated flows will expire within 1 hour of inactivity or 24 hours from creation time, whichever comes first.

scope: flows:write

You can see a list of all possible flow types in our Flow Types guide.

You can also mix and match flow_types in the same category to create custom flows suitable for your needs.

For instance, to create a custom onboarding flow that only includes add_addresses, add_employees, and sign_all_forms steps, simply stitch those flow_types together into a comma delimited string:

{
  flow_type: "add_addresses,add_employees,sign_all_forms"
}

Please be mindful of data dependencies in each step to achieve the best user experience.

For more information and in-depth guides review the Getting Started guide for flows.

Path Params
string
required

The UUID of the company

Body Params
string
required

flow type

string

UUID of the target entity applicable to the flow. This field is optional for company flows, please refer to the flow_types table above for more details.

string
enum

the type of target entity applicable to the flow. This field is optional for company flows, please refer to the flow_types table above for more details.

Allowed:
Headers
string
enum
Defaults to 2024-03-01

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Allowed:
Responses

404

Not Found

The requested resource does not exist. Make sure the provided UUID is valid.

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json