PartnerSessionCreateConfiguration

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/argyle/refs/heads/main/json-schema/partnersessioncreateconfiguration.json",
  "title": "PartnerSessionCreateConfiguration",
  "type": "object",
  "description": "Connection session configuration for payroll and banking verifications.",
  "properties": {
    "experience": {
      "type": "string",
      "format": "uuid",
      "description": "Banking only. Optional bank connection experience customization ID."
    },
    "single_use_url": {
      "type": "boolean",
      "description": "Banking only. If `true`, the session link expires after one successful connection."
    },
    "redirect_url": {
      "type": "string",
      "nullable": true,
      "description": "Payroll and banking. Optional redirect URL after session completion. Hosted/direct-launch flows should always set this. On desktop browsers, use a regular `https://` URL. For mobile app flows, use a custom scheme such as `your-custom-scheme://return-to-app`, or a Universal Link on iOS / App Link on Android. Universal Links and App Links are the more modern approach. You can include an application-owned state or nonce value to match the returning browser session to an internal user, session, or verification. Argyle appends `user_submission_complete` and `user_attempted_employer_selection`, which mirror the [`onClose`](/link/reference/callbacks#onclose) fields."
    },
    "flow_id": {
      "type": "string",
      "description": "Payroll only. Optional payroll embedded connection experience customization ID."
    },
    "items": {
      "type": "array",
      "description": "Payroll only. Limits Link to the provided Items. If one Item is provided, Link skips search and opens that Item's login screen. If multiple Items are provided, Link shows only those Items.",
      "items": {
        "type": "string"
      },
      "example": [
        "item_000000001",
        "item_000000002"
      ]
    },
    "language": {
      "type": "string",
      "enum": [
        "EN",
        "ES",
        "RU",
        "ZH"
      ],
      "description": "Payroll only. Supported Link [display language](/link/initialization/overview#optional-initialization-parameters)."
    },
    "mobile_app": {
      "type": "boolean",
      "description": "Payroll only. Set to `true` when the session is used in a mobile app, including Hosted Link opened in a secure browser context."
    }
  }
}