Create Link Token

post

https://api.getpinwheel.com/v1/link_tokens

Create a token used to launch a Link modal.

Body Params

account_id

uuid

UUID of the payroll account.

allocation

object

Allocation specified for the link token.

card

object

Card details needed to attempt a card switch.

deposit_forms

string

enum

Optional parameter to facilitate pathway into deposit forms. Defaults to fallback if deposit forms are enabled for your workspace.

Allowed:

disable_direct_deposit_splitting

boolean

Defaults to false

If set to true, user will not be given the option to choose between a full or partial direct deposit switch. Only relevant with job direct_deposit_switch. Defaults to false.

document_uploads

string

enum

Optional parameter to facilitate pathway into document uploads usage. Defaults to None.

Allowed:

employer_id

uuid

UUID of an employer. Employers returned from the /search endpoint are categorized under a response_type of employer in the response body. If set, user is taken directly to Link login screen.

end_user_id

string

length between 1 and 255

User ID provided by you, to associate Pinwheel users with your user model. Required if account_id is not provided. This ID will be returned in all webhook events and all account-affiliated API responses. Leading and trailing whitespace will be stripped. Do not include PII in this identifier.

language

string

enum

Defaults to en

IETF code denoting which language to display in Link.

Allowed:

org_name

string

length between 3 and 30

Organization or app name that is displayed to the user.

platform_id

uuid

UUID of a platform. Platforms returned from the /search endpoint are categorized under a response_type of platform in the response body. If set, user is taken directly to Link login screen.

platform_type

string

enum

If included, filters results by the platform type. Platforms are either payroll or time_and_attendance. Most platforms are payroll. Payroll platforms support operations such as updating direct deposit allocation settings. Time & Attendance platforms contain data around shifts and hours worked, but do not support payroll operations. Can be used with platform_id but not with employer_id.

Allowed:

required_jobs

array of strings

An array of job types required to be performed on the user's payroll account. Employers and platforms that do not support ALL of these jobs will not be visible to the user. This property is required unless the account_id property is set.

required_jobs

skip_intro_screen

boolean

Defaults to false

If set to true, intro screen is not shown to user.

200OK