---
title: "Expense Report Create-and-Submit Screens Outside Workday…"
description: "How to build an expense create-and-submit screen on Workday Expense v1 and the Expense Report Event, under the worker's own sign-in."
url: https://kiweely.com/guides/expense-report-create-submit-outside-workday-menus
---

# Expense Report Create-and-Submit Screens Outside Workday Menus

Workday Expense v1 covers quick expenses, expense items, report lines, and report submit. Submit is the Expense Report Event. A screen outside Workday menus should validate first, then submit as the worker, and treat a saved draft as unfinished.

-   **Checked** against Workday on November 16
-   Applies to **Workday Extend**
-   4 min read
-   Published November 16
-   By Kiweely

Workday’s Expense v1 REST service is the documented surface for quick expenses and expense reports. The [explorer page](https://developer.workday.com/rest-api-explorer/docs/expense/v1) describes reports you can create, modify, or submit, and it secures `GET /reports` with **Self-Service: Expense Report** and `POST /reports/{ID}/submit` with the **Expense Report Event** business process. A create-and-submit screen outside Workday’s menus has to follow that split: collect lines, then submit the event as the signed-in worker.

[Kiweely Leaf](https://kiweely.com/leaf) (coming next) can host that screen in the browser, in Teams, or on the phone. It runs each call as that worker and stores the layout, not the receipts or the amounts.

## The operations this session verified

Expense v1, base `https://api.us.wcp.workday.com/expense/v1` on the explorer page:

| Operation | What Workday documents |
| --- | --- |
| `GET` and `POST /entries` | Quick expenses. Create uses a minimal field set. |
| `GET`, `PUT`, `PATCH`, `DELETE /entries/{ID}` | One quick expense. `POST /entries/{ID}/attachments` adds files to an existing entry. |
| `GET /expenseItems` and `GET /expenseItems/{ID}` | Items allowed on report lines. |
| `GET /reports` | The worker’s reports. Domain: Self-Service: Expense Report. |
| `GET /reports/{ID}` | One report. |
| `POST /reports/{ID}/lines` | Adds lines to a report. |
| `POST /reports/{ID}/submit` | Submits that report. Business process: Expense Report Event. |
| `GET /values/bespokePrompt/...` | Prompt values for currency, expense group, and expense item. |

[REST fundamentals](https://developer.workday.com/documentation/GUID-85810465-bcfb-4fdf-a26d-55eaff3968a8-enHYPHENus/WorkdayRESTAPIFundamentals) also document the tenant path `https://{tenantHostname}/api/{serviceName}/{version}/{tenant}` for integrations. Use the host your API client is registered against. This guide does not paste a sample tenant host.

The explorer listing verified here does not print a separate create-report REST method next to `GET /reports`. The [Graph API](https://developer.workday.com/documentation/GUID-c0c417b9-540c-47f0-a400-2c6ae9bbd760-enHYPHENus) documents a `createExpenseReport` mutation whose input type is `Expense_ReportPostServiceRepresentation_CreateInput`, and a `createQuickExpense` mutation that can carry attachments. Confirm the create path in REST API Explorer on your tenant before you wire a button. If the tenant only exposes Graph for create, call that, then continue with the report id Workday returns.

## Validate, then submit

[Validate-only mode](https://developer.workday.com/documentation/rni1611281077170) applies to REST `POST`, `PUT`, `PATCH`, and `DELETE` when you send `x-validate-only: 1`. Workday checks operation security, display options, field-level security, prompts, currency, and required fields, and it does not persist. A passing call returns 200. Persist by sending the same request with the header absent or set to `0`. The documented sample is a `PUT` to `/expense/v1/entries/{id}` that fails validation because `date` is missing while `amount` is present.

Graph uses the same header. The header guide shows `createExpenseReport` rejected for an invalid `creationDate` when validate-only is on. Use that pass before the worker sees a success state.

Submit is a different step from save. `POST /reports/{ID}/submit` is what starts the Expense Report Event. A screen that stops after creating lines has left a draft. Say “Saved, not submitted” until that call succeeds, then show the business process status Workday returns.

Attachments on `createQuickExpense` use the Graph multipart form and a `File` field named in the schema (`attachmentContent` in Workday’s example). The receipt bytes belong in that request. Leaf’s published design stores no employee HR data at rest, so the screen should not keep a copy of the receipt after Workday accepts it.

## A screen that matches the menu it replaces

1.  On open, `GET /reports` as the worker and list drafts separately from submitted reports.
2.  Load items from `GET /expenseItems` and currencies from the prompt resource. Do not ship a hardcoded category list.
3.  Create the quick expense or the report with the operation your tenant actually exposes. Run validate-only on the way in.
4.  Add lines with `POST /reports/{ID}/lines`.
5.  On the submit control, call `POST /reports/{ID}/submit` and leave the approval chain on the Expense Report Event. The screen does not approve itself.

Prompt values and expense items are tenant data. A warehouse and a corporate card program will not share the same item list. Read them live.

[Leaf](https://kiweely.com/leaf) (coming next) is the place to describe this screen if you want it hosted. Approval of the submitted report still follows the Expense Report Event you already configured.

## Questions

### Can the screen submit as a shared integration user so workers skip sign-in?

Workday secures `GET /reports` with a self-service domain. A shared user returns that user’s reports, or an empty set, and the Expense Report Event records the wrong initiator. Leaf calls run as the signed-in employee.

### What if validate-only passes and submit fails?

The draft can exist while the business process rejects it. Show Workday’s error and leave the report in the draft list. Do not show a confirmation that names a report id you have not submitted.

## Sources checked

-   [Expense v1 REST API](https://developer.workday.com/rest-api-explorer/docs/expense/v1)
-   [Validate-only mode for REST APIs](https://developer.workday.com/documentation/rni1611281077170)
-   [Graph API mutations](https://developer.workday.com/documentation/kbu1671067116723)
-   [Graph API headers, including validate-only](https://developer.workday.com/documentation/GUID-c0c417b9-540c-47f0-a400-2c6ae9bbd760-enHYPHENus)
-   [Graph API attachments](https://developer.workday.com/documentation/GUID-f55baa31-61f8-441e-bd0a-2482ad551254-enHYPHENus)
-   [Workday REST API fundamentals](https://developer.workday.com/documentation/GUID-85810465-bcfb-4fdf-a26d-55eaff3968a8-enHYPHENus/WorkdayRESTAPIFundamentals)

## Related guides

[All guides](https://kiweely.com/guides)

-   [### Publishing One Employee Screen to Web, Teams, and Phone Leaf publishes one screen into the browser, workplace chat, and the Leaf phone app. Workday Everywhere is Workday’s own conversational app in Teams, Slack, Copilot, and Gemini Enterprise. They answer different problems and do not replace each other.](https://kiweely.com/guides/one-screen-definition-web-teams-phone)

### More guides on Reports and calculated fields

[All 25 guides](https://kiweely.com/guides#reporting)

-   [Workday calculated field not showing in a report: why it is missing from the field picker](https://kiweely.com/guides/workday-calculated-field-not-showing-in-report)
-   [How to debug a Workday calculated field that returns the wrong value](https://kiweely.com/guides/workday-calculated-field-returns-wrong-value)
-   [Preventing Accidental Indirect-Report Visibility in Workday Intersection Security Groups](https://kiweely.com/guides/workday-security-groups-intersection-subordinate-org-visibility)
-   [How to Sum or Count Multi-Instance Rows in Workday Using Aggregate Related Instances (ARI)](https://kiweely.com/guides/workday-aggregate-related-instances-ari-sum-count)
-   [Blank vs. Empty in Workday Report Filters and Condition Rules: Why Your Filter Misses Rows](https://kiweely.com/guides/workday-blank-vs-empty-report-filter-prompts)
-   [How to Fix CellLimitExceededException: Exceeded Cell Limit in Workday Custom Reports and EIBs](https://kiweely.com/guides/workday-report-cell-limit-exceeded-exception)
-   [How to Build Multi-Condition Evaluate Expression Calculated Fields in Workday Without Hitting Nesting Limits](https://kiweely.com/guides/workday-evaluate-expression-nested-calculated-fields)
-   [How to Build a Workday Payroll Summary Report by Worker and Earning Code Over Any Date Range](https://kiweely.com/guides/workday-payroll-aggregate-earnings-deductions-report)

### From the blog on Reports and calculated fields

[All posts](https://kiweely.com/blog)

-   [Approving Workday Expense Reports and Purchase Requisitions in Teams and Slack](https://kiweely.com/blog/workday-expense-report-and-requisition-approvals-in-teams-slack)
-   [Untangling a 14-Subreport Workday Composite Report Nobody on Your Team Built](https://kiweely.com/blog/reverse-engineering-inherited-workday-composite-reports)
-   [How Consultants Catch Silent Report and Browser Regressions After a Workday Semiannual Release](https://kiweely.com/blog/regression-testing-workday-ui-and-timezone-changes)

## Let Workday check the work.

Kiweely writes WQL and builds orchestrations in your own tenant, and Workday, not Kiweely, says whether they passed.

[Start for free](https://kiweely.com/download) [See how it works](https://kiweely.com/vine/how-it-works)

## Get the next guide in your inbox.

One email a month with new guides and one Extend tip. Nothing else.
