Workday Request Forwarding Guide

The Workday integration supports request forwarding when using the api_token authentication method.

To send a custom request to the Workday API using request forwarding you must provide the XML body of the request in the data body field of the request to the Finch API. The format of the XML can be found in the Workday API documentation.

The method field should always be POST.

The route field should be the path to the Workday API service you are trying to access and include the version number. For example, /Human_Resources/v41.0.

No headers or params are required.

The data field should contain the entire <soapenv:Body>...</soapenv:Body> element of the request XML. No other parts of the XML should be included.

Example request:

--header 'Authorization: Bearer {{FINCH_ACCESS_TOKEN}}' \
--header 'Content-Type: application/json' \
--header 'Finch-API-Version: 2020-09-17' \
--data '{
  "method": "POST",
  "route": "/Human_Resources/v41.0",
  "headers": null,
  "params": null,
  "data": "<soapenv:Body>..."
}'```