Skip to main content

Workday Web Services

Workday is a leading provider of enterprise cloud applications for finance, HR, and planning, helping organizations manage their workforce, financial operations, and business processes through unified cloud-based solutions.

Workday Web Services icon

Power end-to-end data operations for your Workday Web Services API with Nexla. Our bi-directional Workday Web Services connector is purpose-built for Workday Web Services, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Workday Web Services or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Workday Web Services workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

  • Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
  • Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
  • API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
  • Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

Before creating a Workday Web Services credential, you need to obtain your Workday Hostname, Workday Tenant, Username, and Password from your Workday account. Workday Web Services are SOAP-based APIs that use Basic Authentication for all API requests.

To obtain your Workday Web Services credentials, follow these steps:

  1. Sign in to your Workday account using your administrator credentials.

  2. Navigate to your Workday Web Services URL, which typically follows the format: https://<workday-host-name>/ccx/service/<workday-tenant>/

  3. From your Workday Web Services URL, extract the following information:

    • Workday Hostname: This is the <workday-host-name> portion of your Web Services URL (e.g., wd2-impl or wd2-impl-1)
    • Workday Tenant: This is the <workday-tenant> portion of your Web Services URL (e.g., ccx or your tenant identifier)
  4. Ensure that you have an Integration System User configured in Workday with the necessary permissions to access the Web Services you need to use.

  5. Your Username should be the username for your Integration system user configured in Workday.

  6. Your Password should be the password for your Integration system user.

  7. Store all credentials securely, as you will need them to configure your Nexla credential. The Password is sensitive information and should be kept confidential.

The Workday Hostname and Tenant are used to construct the API endpoint URLs. The Username and Password are used in Basic Authentication for all API requests to the Workday Web Services API. If your credentials are compromised, you should immediately change your password in your Workday account. For detailed information about Workday Web Services, API authentication, and available endpoints, refer to the Workday Web Services API documentation.

Authenticate

Credentials required

FieldRequiredSecretDescription
Workday HostnameYesNoEnter your Workday Hostname. You can find the Workday Hostname from your web services URL under https://<workday-host-name>/ccx/service/<workday-tenant>/
Workday TenantYesNoEnter your Workday Tenant. You can find the tenant in your Workday Web Services url under https://<workday-host-name>/ccx/service/<workday-tenant>/
Enter your Workday UsernameYesNoPlease enter the username for your Integration system user
Enter your Workday passwordNoNoPlease enter the password for your Integration system user

Create a credential in Nexla

  1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – Workday Web Services

WorkdayWSCred.png
  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

  2. Enter your Workday Hostname in the Workday Hostname field. This is the hostname portion of your Workday Web Services URL, found under https://<workday-host-name>/ccx/service/<workday-tenant>/. The Workday Hostname is used, together with the Tenant, to construct the API endpoint URLs.

  3. Enter your Workday Tenant in the Workday Tenant field. This is the tenant portion of your Workday Web Services URL, found under the same https://<workday-host-name>/ccx/service/<workday-tenant>/ pattern. The Workday Tenant is used to construct the API endpoint URLs.

  4. Enter your Workday Username in the Enter your Workday Username field. This should be the username for your Integration system user configured in Workday.

  5. Enter your Workday password in the Enter your Workday password field. This should be the password for your Integration system user. Workday Web Services use Basic Authentication for all API requests, so the Username and Password are used together as the basic authentication credentials for every call.

    Your Workday Web Services credentials (Workday Hostname, Workday Tenant, Username, Password) can be found in your Workday Web Services URL and Integration System User configuration. The Workday Hostname and Tenant can be extracted from your Web Services URL under https://<workday-host-name>/ccx/service/<workday-tenant>/. The Username and Password should be for your Integration system user configured in Workday.

    If your credentials are compromised, you should immediately change your password in your Workday account. The credentials provide access to your Workday account data and should be treated as sensitive information. Keep your credentials secure and do not share them publicly.

    For detailed information about Workday Web Services, API authentication, and available endpoints, see the Workday Web Services API documentation.

  6. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

Use as a data source

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Workday Web Services connector tile, then select the credential that will be used to connect to the Workday Web Services instance, and click Next; or, create a new Workday Web Services credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Workday Web Services endpoints. Each template is designed specifically for the corresponding Workday Web Services endpoint, making data source setup easy and efficient. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

Workday Web Services are SOAP-based APIs that use XML format for requests and responses. All endpoint templates use SOAP envelopes with WS-Security authentication. The endpoints automatically handle pagination and authentication using your credential configuration.

Get Journal Sources

This endpoint template fetches all Journal Sources from your Workday account. Use this template when you need to access journal source information, journal source metadata, or journal source structures for analysis, reporting, or integration purposes.

  • This endpoint automatically fetches all Journal Sources from your Workday account. No additional configuration is required beyond selecting this endpoint template. The endpoint uses SOAP format with WS-Security authentication and handles pagination automatically.

This endpoint returns all Journal Sources from your Workday account, including journal source IDs, names, and other journal source metadata. The endpoint uses SOAP format with WS-Security authentication and handles pagination automatically to retrieve all journal sources.

For detailed information about journal sources, API response structures, and available journal source data, see the Workday Web Services API documentation.

Get Ledger Account Summaries

This endpoint template fetches all Ledger Account Summaries from your Workday account. Use this template when you need to access ledger account summary information, account balances, or financial summary data for analysis, reporting, or integration purposes.

  • This endpoint automatically fetches all Ledger Account Summaries from your Workday account. No additional configuration is required beyond selecting this endpoint template. The endpoint uses SOAP format with WS-Security authentication and handles pagination automatically.

This endpoint returns all Ledger Account Summaries from your Workday account, including account IDs, names, balances, and other financial summary metadata. The endpoint uses SOAP format with WS-Security authentication and handles pagination automatically to retrieve all ledger account summaries.

For detailed information about ledger account summaries, API response structures, and available financial data, see the Workday Web Services API documentation.

Get Customers

This endpoint template fetches all Customers from your Workday account. Use this template when you need to access customer information, customer details, or customer metadata for analysis, reporting, or integration purposes.

  • This endpoint automatically fetches all Customers from your Workday account. No additional configuration is required beyond selecting this endpoint template. The endpoint uses SOAP format with WS-Security authentication and handles pagination automatically.

This endpoint returns all Customers from your Workday account, including customer IDs, names, contact information, and other customer metadata. The endpoint uses SOAP format with WS-Security authentication and handles pagination automatically to retrieve all customers.

For detailed information about customers, API response structures, and available customer data, see the Workday Web Services API documentation.

Get Journals

This endpoint template fetches Journal Entries for the specified accounting period from your Workday account. Use this template when you need to access journal entry information, journal transactions, or accounting period data for analysis, reporting, or integration purposes.

  • Enter the Accounting From Date in the Accounting From Date field. This should be the start date of the accounting period in YYYY-MM-DD format. The From date must be less than or equal to the To date. The Accounting From Date determines the start of the accounting period for which journal entries will be retrieved.
  • Enter the Accounting To Date in the Accounting To Date field. This should be the end date of the accounting period in YYYY-MM-DD format. The From date must be less than or equal to the To date. The Accounting To Date determines the end of the accounting period for which journal entries will be retrieved.

This endpoint returns Journal Entries for the specified accounting period from your Workday account, including journal entry IDs, transaction details, amounts, and other journal entry metadata. The endpoint uses SOAP format with WS-Security authentication and handles pagination automatically to retrieve all journal entries for the specified period.

For detailed information about journals, API response structures, and available journal entry data, see the Workday Web Services API documentation.

Get Journals (By Update Datetime)

This endpoint template fetches all journals with status updates between the entered datetime from your Workday account. Use this template when you need to access journal entries that have been updated within a specific time range for analysis, reporting, or integration purposes.

  • Enter the Updated From DateTime in the Updated From DateTime field. This should be the start datetime for retrieving all journals after the entered datetime. The Updated From DateTime determines the start of the time range for which updated journal entries will be retrieved.
  • Enter the Updated To DateTime in the Updated To DateTime field. This should be the end datetime for retrieving all journals before the entered datetime. The Updated To DateTime determines the end of the time range for which updated journal entries will be retrieved.

This endpoint returns all journals with status updates between the entered datetime from your Workday account, including journal entry IDs, update timestamps, transaction details, and other journal entry metadata. The endpoint uses SOAP format with WS-Security authentication and handles pagination automatically to retrieve all updated journal entries within the specified time range.

For detailed information about journals, API response structures, and available journal entry data, see the Workday Web Services API documentation.

Get Account Sets

This endpoint template fetches all Account Sets from your Workday account. Use this template when you need to access account set information, account groupings, or account set metadata for analysis, reporting, or integration purposes.

  • This endpoint automatically fetches all Account Sets from your Workday account. No additional configuration is required beyond selecting this endpoint template. The endpoint uses SOAP format with WS-Security authentication and handles pagination automatically.

This endpoint returns all Account Sets from your Workday account, including account set IDs, names, and other account set metadata. The endpoint uses SOAP format with WS-Security authentication and handles pagination automatically to retrieve all account sets.

For detailed information about account sets, API response structures, and available account set data, see the Workday Web Services API documentation.

Get Customer Invoices (Enter Criteria)

This endpoint template fetches Customer Invoices for the specified company reference and invoice dates from your Workday account. Use this template when you need to access customer invoice information, invoice details, or billing data for a specific company for analysis, reporting, or integration purposes.

  • Enter the Company Reference in the Company Reference field. This should be the reference to an existing Company which holds the asset. The Company Reference determines which company's invoices will be retrieved.
  • Enter the Invoice Date On or After in the Invoice Date On or After field. This should be the start date for filtering invoices in YYYY-MM-DD format. Invoice Date On or After must be before Invoice Date On or Before. The Invoice Date On or After determines the start of the date range for which invoices will be retrieved.
  • Enter the Invoice Date On or Before in the Invoice Date On or Before field. This should be the end date for filtering invoices in YYYY-MM-DD format. Invoice Date On or After must be before Invoice Date On or Before. The Invoice Date On or Before determines the end of the date range for which invoices will be retrieved.

This endpoint returns Customer Invoices for the specified company reference and invoice dates from your Workday account, including invoice IDs, invoice numbers, amounts, dates, and other invoice metadata. The endpoint uses SOAP format with WS-Security authentication and handles pagination automatically to retrieve all invoices matching the specified criteria.

For detailed information about customer invoices, API response structures, and available invoice data, see the Workday Web Services API documentation.

Get Customer Payments

This endpoint template fetches Customer Payments from your Workday account. Use this template when you need to access customer payment information, payment details, or payment transaction data for analysis, reporting, or integration purposes.

  • Enter the Payment Date on Date or After in the Payment Date on Date or After field. This should be the start date for filtering payments in YYYY-MM-DD format. Payment Date on Date or After must be before Payment Date on Date or Before. The Payment Date on Date or After determines the start of the date range for which payments will be retrieved.
  • Enter the Payment Date on Date or Before in the Payment Date on Date or Before field. This should be the end date for filtering payments in YYYY-MM-DD format. Payment Date on Date or After must be before Payment Date on Date or Before. The Payment Date on Date or Before determines the end of the date range for which payments will be retrieved.

This endpoint returns Customer Payments from your Workday account, including payment IDs, payment amounts, payment dates, and other payment metadata. The endpoint uses SOAP format with WS-Security authentication and handles pagination automatically to retrieve all payments matching the specified date range.

For detailed information about customer payments, API response structures, and available payment data, see the Workday Web Services API documentation.

Get Organizations

This endpoint template fetches all organizations from your Workday account. Use this template when you need to access organization information, organization details, or organization metadata for analysis, reporting, or integration purposes.

  • This endpoint automatically fetches all organizations from your Workday account. No additional configuration is required beyond selecting this endpoint template. The endpoint uses SOAP format with WS-Security authentication and handles pagination automatically.

This endpoint returns all organizations from your Workday account, including organization IDs, names, codes, and other organization metadata. The endpoint uses SOAP format with WS-Security authentication and handles pagination automatically to retrieve all organizations.

For detailed information about organizations, API response structures, and available organization data, see the Workday Web Services API documentation.

Get Customer Invoices (All Company References)

This endpoint template fetches Customer Invoices for all company references with the specified invoice dates from your Workday account. Use this template when you need to access customer invoice information across all companies for analysis, reporting, or integration purposes.

  • Enter the Invoice Date On or After in the Invoice Date On or After field. This should be the start date for filtering invoices in YYYY-MM-DD format. Invoice Date On or After must be before Invoice Date On or Before. The Invoice Date On or After determines the start of the date range for which invoices will be retrieved.
  • Enter the Invoice Date On or Before in the Invoice Date On or Before field. This should be the end date for filtering invoices in YYYY-MM-DD format. Invoice Date On or After must be before Invoice Date On or Before. The Invoice Date On or Before determines the end of the date range for which invoices will be retrieved.

This endpoint returns Customer Invoices for all company references with the specified invoice dates from your Workday account, including invoice IDs, invoice numbers, amounts, dates, company references, and other invoice metadata. The endpoint uses a two-step process: first, it retrieves all organizations, then it fetches invoices for each organization. The endpoint uses SOAP format with WS-Security authentication and handles pagination automatically to retrieve all invoices matching the specified date range across all companies.

For detailed information about customer invoices, API response structures, and available invoice data, see the Workday Web Services API documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

Workday Web Services data sources can also be manually configured to ingest data from any valid Workday Web Services SOAP endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom SOAP body templates and request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Workday Web Services are SOAP-based APIs that use XML format for requests and responses. Manual configuration requires SOAP envelope construction with WS-Security authentication headers, which is handled automatically based on your credential configuration. The API method is typically POST, since SOAP requests are sent as XML in the request body. Endpoint URLs follow the pattern https://{hostname}.myworkday.com/ccx/service/{tenant}/{service_name}, where {hostname} is your Workday hostname, {tenant} is your Workday tenant, and {service_name} is the service name (e.g., Financial_Management or Revenue_Management).

For the Path to Data, enter the XPath that points to the relevant object/array for XML responses (e.g., /env:Envelope/env:Body/wd:Get_Journal_Sources_Response/wd:Response_Data/wd:Journal_Source), or the JSON path for JSON responses (e.g., $.data.items[*]).

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Workday Web Services data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.