Workday Tools

Workday is a cloud HR and finance platform; these tools read worker data from its Staffing REST API. Use them in a workflow to list workers or fetch a single worker by ID when you need HR/employee context for downstream blocks.

Overview

Operations

Configuration

workday_get_workers

Calls GET {tenantUrl}/workers?limit=...&offset=... with header Authorization: Bearer {accessToken} and Accept: application/json.

workday_get_worker

Calls GET {tenantUrl}/workers/{workerId} with header Authorization: Bearer {accessToken} and Accept: application/json.

Outputs

workday_get_workers

• data (json) — Array of Workday worker objects.
• metadata (json) — List metadata, with properties:
  • count (number) — Number of workers returned.
  • total (number) — Total number of matching workers.

workday_get_worker

• data (json) — The requested Workday worker object.
• metadata (json) — Worker identifiers, with properties:
  • id (string) — Worker ID.

YAML Example

workday_1:
  type: workday
  name: "Workday"
  inputs:
    operation: "workday_get_workers"
    tenantUrl: "https://wd5-impl-services1.workday.com/ccx/api/staffing/v6/your_tenant"
    limit: 20
    offset: 0
    accessToken: "{{WORKDAY_ACCESS_TOKEN}}"
  connections:
    outgoing:
      - target: next-block-id

To fetch a single worker, switch the operation and provide a workerId:

workday_get_worker_1:
  type: workday
  name: "Workday"
  inputs:
    operation: "workday_get_worker"
    tenantUrl: "https://wd5-impl-services1.workday.com/ccx/api/staffing/v6/your_tenant"
    workerId: "3aa5550b7fe348b98d7b5741afc65534"
    accessToken: "{{WORKDAY_ACCESS_TOKEN}}"
  connections:
    outgoing:
      - target: next-block-id

Tips

• Auth is a raw OAuth bearer token, not an API key exchange. Obtain an access token from your Workday OAuth client (the tools do not refresh it) and store it as a secret like {{WORKDAY_ACCESS_TOKEN}} — it is sent verbatim as Authorization: Bearer <token>.
• The tenantUrl must already include the full Staffing API path and your tenant, e.g. .../ccx/api/staffing/v6/your_tenant. The tools append /workers (and /{workerId}), so do not add /workers yourself; a trailing slash is trimmed for you.
• For pagination over large worker sets, page with limit and offset; read {{workday_1.metadata.total}} to know how many records match and {{workday_1.metadata.count}} for the size of the current page.