--- title: Using Meta APIs (Workday) slug: using-meta-apis-workday docTags: createdAt: 2026-05-25T18:31:31.887Z --- Bindbee’s Meta APIs retrieve the metadata required for write-back operations, such as creating payroll runs and time-off entries. In Workday integrations, certain metadata used by the Meta APIs is sourced through custom reports. To expose this metadata in Bindbee’s Meta API responses, you must create the required custom reports in Workday and transfer ownership of those reports to the authorized Integration System User (ISU). This guide explains how to configure the necessary Workday custom reports for the Meta APIs you intend to use. ::Iframely{originalUrl="https://watchclueso.com/embed/jq1o1wrqeq6s0uk2" embedUrl="https://watchclueso.com/embed/jq1o1wrqeq6s0uk2" title="Workday Meta APIs Report info" html="
"} *** ## Required Custom Reports The custom reports you need to create depend on the Workday action you want to perform through Bindbee. You do not need to create all the reports listed below. Create only the reports required for the Meta API you plan to use. ***Employee Payroll Run Metadata*** To create employee payroll runs, set up the following reports. :::BlockQuote Report Name: **earning-codes** (Data Source: **All Earnings for Payroll**) ::: | **Field** | **Column Heading Override** | | ---------------- | --------------------------- | | Workday ID | wid | | Calculation Name | code | :::BlockQuote Report Name: **deduction-codes** (Data Source: **All Deductions for Payroll**) ::: | **Field** | **Column Heading Override** | | ---------------- | --------------------------- | | Workday ID | wid | | Calculation Name | code | ***Time Off Metadata*** To create time off entries, set up the following reports. :::BlockQuote Report Name: **accrual-codes** (Data Source: **All Absence Accruals**) ::: | **Field** | **Column Heading Override** | | ----------------------------------- | --------------------------- | | Workday ID | wid | | Code | code | | Time Off Plan for Absence Component | plan | :::BlockQuote Report Name: **timeoff-codes** (Data Source: **All Time Offs**) ::: | **Field** | **Column Heading Override** | | ----------------------------------- | --------------------------- | | Workday ID | wid | | Code | code | | Time Off Plan for Absence Component | plan | *** ## Create the Custom Reports in Workday Follow these steps for each report listed above. **Step 1:** Search for **Create Custom Report** in Workday. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/21ac5954-b2f7-4ae9-9c8b-e719487ffee3/adff4429-2d84-42e1-a5b1-22daff5a65f7/images/be030400-07d2-47c2-9941-972ed7252900.png) **Step 2:** Enter the report name from the Required Custom Reports section above. **Step 3:** Set the **Report Type** to **Advanced**. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/21ac5954-b2f7-4ae9-9c8b-e719487ffee3/adff4429-2d84-42e1-a5b1-22daff5a65f7/images/32f2d831-743e-4989-b5ed-c3ada61d132c.png) **Step 4:** Select **Enable As Web Service**. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/21ac5954-b2f7-4ae9-9c8b-e719487ffee3/adff4429-2d84-42e1-a5b1-22daff5a65f7/images/ce923d41-1660-4abe-907d-bedc7d7ebd6c.png) **Step 5:** Clear the **Optimized for Performance **checkbox. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/21ac5954-b2f7-4ae9-9c8b-e719487ffee3/adff4429-2d84-42e1-a5b1-22daff5a65f7/images/630f88c2-e344-496a-8000-3627ec06c37f.png) **Step 6:** Select the data source listed for that report. **Step 7:** Click **OK** to continue. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/21ac5954-b2f7-4ae9-9c8b-e719487ffee3/adff4429-2d84-42e1-a5b1-22daff5a65f7/images/3ea44f67-a065-4a2e-96fa-8ea7f26f1018.png) **Step 8:** Add the required fields and update the column heading overrides for the specific report you are setting up. The screenshot below is only for reference. Refer to the **Required Custom Reports** section above to confirm which fields and column heading overrides are required for each report. ![](https://api.archbee.com/api/optimize/LD5Xn2bifyanaRVQ-BE9T/hOlk5I70Naycae2BWnzvG_.blob) **Step 9:** Open the **Share** tab. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/21ac5954-b2f7-4ae9-9c8b-e719487ffee3/adff4429-2d84-42e1-a5b1-22daff5a65f7/images/0c4cd867-621f-4237-80d2-613125873705.png) **Step 10:** Select **Share** with specific authorized groups and users. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/21ac5954-b2f7-4ae9-9c8b-e719487ffee3/adff4429-2d84-42e1-a5b1-22daff5a65f7/images/492f87af-d9d6-4a03-90c8-bbcb43a4cde6.png) **Step 11:** Enter the authorized Integration System User. ![](https://api.archbee.com/api/optimize/LD5Xn2bifyanaRVQ-BE9T/JvSkGHcjEHCrKEjSG2PQm_.blob) **Step 12:** Click **OK** to save the report. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/21ac5954-b2f7-4ae9-9c8b-e719487ffee3/adff4429-2d84-42e1-a5b1-22daff5a65f7/images/73011c91-5f31-4dbf-9023-bfef4a75e76d.png) *** ## Transfer Ownership of the Custom Report Once the report has been created, transfer ownership to the authorized Integration System User (ISU). :::hint{type="info"} The ISU must have the following Domain Security Policy enabled: [View and Modify - Custom Report Creation](https://help.bindbee.dev/how-to-authenticate#maintain-permissions-for-security-group) If this permission is not enabled, update the Domain Security Policy for the ISU's security group and activate the pending security policy changes in Workday. ::: **Step 1:** Click the three dots next to your report, select **Custom Report**, then choose **Transfer Ownership**. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/21ac5954-b2f7-4ae9-9c8b-e719487ffee3/adff4429-2d84-42e1-a5b1-22daff5a65f7/images/1566c4f9-42ff-43d8-8673-67853d75c3ae.png) **Step 2:** Assign the Integration System User (ISU) as the new owner. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/21ac5954-b2f7-4ae9-9c8b-e719487ffee3/adff4429-2d84-42e1-a5b1-22daff5a65f7/images/c34f35ce-5083-4840-962a-64adf69e3e1a.png) **Step 3:** Click **OK** and then **Done**. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/21ac5954-b2f7-4ae9-9c8b-e719487ffee3/adff4429-2d84-42e1-a5b1-22daff5a65f7/images/72d55283-3574-48a5-98b8-d1d6557a8d57.png)