Skip to main content

Authorization

Follow this guide to create a new Workday Web Services credential that will allow Nexla to authenticate to and exchange data with your Workday Web Services account.
wdayws_api_auth.png

Workday Web Services

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.

Create a Workday Web Services Credential​

  • To create a new Workday Web Services credential, 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

Credential Name & Description​

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

    Resource descriptions are recommended but are not required. They should be used provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

Basic Authentication​

Workday Web Services use Basic Authentication for all API requests. The Username and Password are used as the basic authentication credentials, along with the Workday Hostname and Tenant to construct API endpoint URLs.

  1. Enter your Workday Hostname in the Workday Hostname field. This is the hostname portion of your Workday Web Services URL. You can find the Workday Hostname from your web services URL under https://<workday-host-name>/ccx/service/<workday-tenant>/. The Workday Hostname is used to construct the API endpoint URLs.

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

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

  4. Enter your Workday password in the Enter your Workday password field. This should be the password for your Integration system user. Please enter the password for your Integration system user. The Password is sensitive information and must be kept confidential.

    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.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.