Skip to main content
Documentation
Documentation
Peakon
Last Updated: 2023-06-23
Steps: Build Custom Apps with REST API

Steps: Build Custom Apps with REST API

Administrator access in Workday Peakon Employee Voice (WPEV).
You can use a WPEV-provided, external REST API to build custom applications and integrations for employee provisioning and access resources otherwise only exposed with the WPEV dashboard.
  1. Confirm that you expose all resources needed by your application through the API.
  2. Navigate to
    Administration
    Integrations
    Custom Apps
    .
  3. Name your application and create permissions.
    WPEV recommends that you grant minimum permissions for your applications.
  4. Copy the
    Access Token
     generated.
    The token is the only credential used by your application to access remote resources in WPEV and displays only once. WPEV recommends that you keep it safe, and don't share with other applications.
  5. To authenticate your application, navigate to
    Peakon API
    Authentication
    .
    Authentication completes by sending an HTTP POST request to the /v1/auth/application endpoint. In response to a successful authentication request, a Json Web Token returns and all subsequent API requests contain an Authorization header bearing the encoded token. The separation of authentication and authorization tokens enables a deployment where only an application developer or a company admin has access to the authentication token. Authorization tokens assign and share with application users.
  6. To send a request to the API, navigate to
    Peakon API
     and select your new application.
  7. (Optional) Send a request with additional parameters. Example: Filter out data or specify a time interval.