> ## Documentation Index
> Fetch the complete documentation index at: https://docs.duvo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Workday

Workday is a cloud-based enterprise platform for human capital management, financial management, and business planning. Connecting Workday to Duvo lets your agents read customer and supplier records and look up financial details directly from your Workday tenant without manual navigation.

<Note>
  This is a credential-based connection. You will need a Workday administrator to configure an API client and integration system user before connecting.
</Note>

## Setup

<Steps>
  <Step title="Confirm prerequisites" icon="circle-check">
    <Check>A Workday tenant with SOAP Web Services enabled (enabled by default on most tenants).</Check>
    <Check>An **Integration System User (ISU)** configured in Workday. Your Workday administrator creates this under the *Create Integration System User* task.</Check>
    <Check>An **API Client** registered in Workday via the *Register API Client for Integrations* task, with the **Non-Expiring Refresh Tokens** option selected and appropriate scopes assigned.</Check>
    <Check>A **refresh token** generated for the ISU through *Manage Refresh Tokens for Integrations* on the registered API client.</Check>
  </Step>

  <Step title="Grant the required permissions" icon="key">
    The Integration System User must have domain security policies granted for the Workday services your agents will access:

    * **Revenue Management** domain — required for reading customer records and balances.
    * **Resource Management** domain — required for reading supplier records.

    Your Workday security administrator assigns these through *Integration System Security* and then activates the pending security policy changes.

    <Warning>
      The ISU's domain security policies determine exactly what the agent can access, so agents can only read what the ISU is authorized to see. Grant only the domains the agent needs, and remember to activate the pending security policy changes after assigning them.
    </Warning>
  </Step>

  <Step title="Add the connection in Duvo" icon="plug">
    On the [Connections page](https://app.duvo.ai/integrations), open Workday and fill in these fields:

    <ParamField body="Workday Host" type="string" required>
      Your Workday service hostname (for example, `wd2-impl-services1.workday.com`). Found in your browser address bar when logged into Workday.
    </ParamField>

    <ParamField body="Tenant" type="string" required>
      Your Workday tenant identifier (for example, `mycompany`). Your Workday administrator can confirm this value.
    </ParamField>

    <ParamField body="Client ID" type="string" required>
      The OAuth2 client ID shown after registering the API client in Workday.
    </ParamField>

    <ParamField body="Client Secret" type="string" required>
      The OAuth2 client secret shown after registering the API client in Workday. This value is only displayed once — copy it during registration.
    </ParamField>

    <ParamField body="Refresh Token" type="string" required>
      The OAuth2 refresh token generated for your Integration System User. Generate this through *Manage Refresh Tokens for Integrations* on your API client.
    </ParamField>
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Third-party documentation" icon="book">
    * [Workday Web Services (WWS) Directory](https://community.workday.com/sites/default/files/file-hosting/productionapi/index.html) — SOAP API reference for all Workday web services.
    * [Integration Security — Workday Community](https://community.workday.com/node/393246) — guide on configuring domain security policies for integration users.
  </Accordion>
</AccordionGroup>

## Capabilities

* **List and search customers** — retrieve paginated customer records including name, category, payment terms, currency, status, credit limit, and contact details.
* **View customer balances** — pull total balance, overdue balance, year-to-date sales, and last-twelve-month sales for any customer.
* **List and search suppliers** — retrieve paginated supplier records including name, category, group, payment terms, currency, status, and contact details.
* **Look up individual records** — get full details for a specific customer or supplier by ID, including address, phone, email, and bank information.
* **Cross-entity partner search** — search customers and suppliers simultaneously when you need to find a business partner without knowing their entity type.

## Key Benefits

* **Unified data access** — read customer records, supplier details, and financial data from a single Workday connection without switching between Workday modules.
* **Automated data retrieval** — pull customer balances, supplier details, and partner records into your workflows automatically instead of exporting reports manually.
* **Secure, scoped access** — uses your Integration System User credentials with domain-level security policies, so agents can only access what the ISU is authorized to see.
* **No manual Workday navigation** — agents query Workday data directly, eliminating the need to log in and run reports by hand.

## Works Well With

<CardGroup cols={3}>
  <Card title="Google Sheets" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/google-sheets.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=0ef8d55e05c34e7a4a618933bdf0ceb3" href="/user-guide/connections/available-connections/google-sheets" width="24" height="24" data-path="images/connections/google-sheets.svg">
    Pull Workday customer and supplier data into spreadsheets for financial analysis, vendor reviews, or stakeholder reporting.
  </Card>

  <Card title="Gmail" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/gmail.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=ad4e229283f3fe2f26c0f96a49f28e13" href="/user-guide/connections/available-connections/gmail" width="88" height="66" data-path="images/connections/gmail.svg">
    Retrieve Workday records and include them in automated notifications, approval requests, or follow-up emails.
  </Card>

  <Card title="Slack" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/slack.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=8a64bdd1af39e903923e4a273b4a4618" href="/user-guide/connections/available-connections/slack" width="512" height="512" data-path="images/connections/slack.svg">
    Post supplier updates, overdue balance alerts, or customer status changes to the relevant team channels.
  </Card>
</CardGroup>