TIL: Workday API Client Choices


There are two things about "OAuth for Integrations" in Workday that's always made me a bit uncomfortable. (1) I didn't know how OAuth worked as well as basic auth and (2) Workday provides two different API Client options and doesn't do a great job describing the differences. I tried searching around Community again and found the information I always wanted tucked away in a presentation recording from 20131. Decide on API Client Configurations for Use with the Workday REST API

When to use which OAuth API Client with Workday API's:

  1. Using a Custom Object?? -> API Client for Integrations
  2. Anything else?? -> API Client

Directly from the video: the "specialized API client for integration":

The only use case that's really supported suported... is the custom object organization. This type of client can be used for other resources in the Workday REST API, but it's only being promoted for custom object integrations. - Seth Taylor

Decision Tree


  1. That's over 10 years ago... Hopefully it still applies.