Workday: How to use the Proxy API for ATS SOAP requests

The Apideck Proxy API lets you execute direct requests against the Workday SOAP API. This guide covers ATS operations using the Recruiting service.

If you have multiple Workday connections configured (e.g. HRIS and ATS), you must include the x-apideck-unified-api header so Apideck knows which connection to use.

curl --location 'https://unify.apideck.com/proxy' \
  --header 'Authorization: Bearer {YOUR_API_KEY}' \
  --header 'x-apideck-consumer-id: {YOUR_CONSUMER_ID}' \
  --header 'x-apideck-app-id: {YOUR_APP_ID}' \
  --header 'x-apideck-service-id: workday' \
  --header 'x-apideck-unified-api: ats' \
  --header 'x-apideck-downstream-url: https://{WSDL}/ccx/service/{tenant}/Recruiting/v44.2' \
  --header 'Content-Type: application/soap+xml' \
  --header 'Accept: application/soap+xml' \
  --data '{SOAP_BODY}'

Downstream URL format:

https://impl-services1.wd105.myworkday.com/ccx/service/{tenant}/{service}/{version}

• The WSDL (e.g. impl-services1.wd105.myworkday.com) depends on your Workday environment (implementation vs. production)

• The service for ATS operations is Recruiting

• The version (e.g. v44.2) depends on your Workday tenant configuration

Keep the placeholders such as {username}, {password}, and {tenant_id} in curly braces - Apideck handles these dynamically.

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wd="urn:com.workday/bsvc">
  <soapenv:Header>
    <wsse:Security soapenv:mustUnderstand="1"
      xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
      xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
      <wsse:UsernameToken wsu:Id="UsernameToken-">
        <wsse:Username>{username}@{tenant_id}</wsse:Username>
        <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">{password}</wsse:Password>
      </wsse:UsernameToken>
    </wsse:Security>
  </soapenv:Header>
  <soapenv:Body>
    <wd:Get_Candidates_Request></wd:Get_Candidates_Request>
  </soapenv:Body>
</soapenv:Envelope>

Update the operation in the SOAP body and adjust the downstream URL service and version accordingly.

Recruiting service:

• Get_Candidates

• Get_Job_Postings

• Get_Job_Requisitions

• Workday connector documentation

• Proxy API reference