---
title: "Build Your First Workday Extend App with Developer Agent"
description: "Build a first Workday Extend app with Developer Agent: prompt pages, review the diff, validate, deploy to a development tenant, and secure the data."
url: https://kiweely.com/guides/first-workday-extend-app-developer-agent
---

# Build Your First Workday Extend App with Developer Agent

Developer Agent proposes Extend components in App Builder. You still create or accept the business object and security domain, apply the diff, validate, deploy to a development tenant, and activate the domain security policy yourself.

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

A first Workday Extend app built with Developer Agent is still an App Builder app. The agent turns a plain-language prompt into page definitions, app metadata, scripts, and related artifacts. It does not create the page inside the tenant from the prompt. You review what it proposed, apply the changes you accept, validate, save to App Hub, and deploy to a development tenant.

Workday’s published fast path is an employee nomination app: a home page, a security domain, a Nomination business object, a create page, and a manage page. In that tutorial you add the security domain and the business object yourself, then prompt the pages. The [Developer Agent overview](https://developer.workday.com/documentation/GUID-f1ddebc6-077a-4441-a023-3c857db88053-enHYPHENus/DeveloperAgentOverview) also says a single prompt can scaffold a whole app, including business objects and security domains. Either way, Developer Agent does not configure security. After you deploy, you create and activate the domain security policy in the tenant.

## What you need before the first prompt

The tutorial requires a Workday Build account and a development tenant. Workday describes creating that account as free.

1.  Create the account with a personal email address and sign in to the Workday Build platform.
2.  Open the hamburger menu, and under Console select Tenants.
3.  Select Create Tenant. Workday says creation takes 1 to 2 minutes.
4.  Use the email Workday sends to set the tenant sign-in. The tutorial then signs you in as Logan McNeil, username `lmcneil`. That persona is a sample vice president of human resources, one of several accounts in the development tenant.

On the Developer Site home page, select Build an Extend App, then Start from Scratch. Name the app. The reference ID fills in from the name. Select Create and Edit to open App Builder, then Connect to Tenant and sign in. A green dot on Manage Tenant Connections means the tenant is connected. Connect before you ask for pages that read or write tenant data. Workday’s prompt guide says to be connected before you generate pages that create, list, update, or delete a business object.

## What the agent writes, and what you still own

| Piece | Who creates it on the nomination path | Where it lives |
| --- | --- | --- |
| Home page, create page, manage page | Developer Agent, after you apply the diff | Page files, plus a task route in app metadata |
| Security domain `NominationData` | You, with Page Security enabled | A security domain component |
| Business object `Nomination` | You, secured by `NominationData` | A business object with four fields |
| Domain security policy | You, in the tenant after deploy | App Manager, then Activate Pending Security Policy Changes |
| Mock data files | Often the agent | Testing section, for preview without live tenant data |

The overview says the agent can also generate business objects, page scripts, Workday Query Language, and Graph queries, and that it can validate its own work and fix its own errors. Treat that as a proposal. Green components in the left-hand panel were added. Yellow components were updated. New code is highlighted. Read the “What was built” list in the chat before you select Apply Changes.

Adding a model component queues promotions to Implementation, Sandbox, and Production until the Friday maintenance window. A business object and a security domain are model components. Your development-tenant deploy can still proceed. The weekly wait starts when you promote past Development. See the model-component guide linked below if this app is only a prototype you might throw away.

## Work the nomination app in order

Workday’s tutorial is specific about names because later prompts refer to them.

**Security domain.** Create a component of type Security Domain named `NominationData`. Enable Page Security. Save to App Hub. Page security lets members of security groups that have permission open the pages. You attach the groups in the tenant, not in the prompt.

**Business object.** Add a business object named `Nomination`. Set the default security domain to `NominationData`. Add four fields:

| Name | Label | Type | Extra |
| --- | --- | --- | --- |
| `date` | Date | DATE | Precision Day |
| `employeeName` | Employee Name | SINGLE\_INSTANCE | Target the delivered Worker object, and enable security by target |
| `reason` | Reason | TEXT |  |
| `organizationValue` | Organization Value | TEXT |  |

Save to App Hub. A business object must be secured by a security domain.

**Home page.** Paste a prompt that states the goal and the constraints. The tutorial’s home-page prompt asks for the title “Employee Nomination App”, a welcome heading, a short description of manager nominations, and a Get Started button. In App Builder, use the box labeled “What do you want to build?” Check the app metadata `tasks` array. A task should route the new page at `routingPattern` `/` so it is the landing page. The task id, the page id, and the page name must match, even if the agent picked a different name than you expected. Open App Preview. If the page is right, Apply Changes and Confirm.

**Deploy and secure.** Select Save and Deploy, choose the tenant, and deploy. In the success window, open Manage in Tenant. That is the App Manager report. Configure the app, find Security Domains, and select Create. Confirm. On Report/Task Permissions, add the HR Administrator security group and check Modify. Workday says View and Modify on that page affect REST API security for the model business object and the pages in the app. Select Activate Pending Security Policy Changes, enter a comment, and confirm.

**Create page.** Open Chat with Developer Agent and use a prompt that names the object and the fields. The tutorial asks for an edit page that creates Nomination records, exposes date, employeeName, reason, and organizationValue as required inputs, and on save posts them to create the record. Confirm the new task’s `routingPattern` (the tutorial expects `createNomination`). Preview in a new tab. You should see the four required fields, a calendar on the date, a worker search (the tutorial tries “Brown”), empty text boxes, and Cancel and OK. If the preview is wrong, Reject Changes and submit the prompt again. If it is right, Apply Changes, Confirm, and Save to App Hub.

**Prove a row landed.** Stay connected to the tenant. In App Preview, fill the form and select OK. The tutorial routes you back to the home page, which does not yet list nominations. Open App Manager, Configure, and the Extend Business Object Instance Count tab. The table shows how many instances exist.

**Manage page.** Prompt for a grid of Date, Employee Name, Reason, and Organization Value, sorting by date, filtering by employee name, a row link to edit, a button to create, and required date and employee name before save. Preview should show the nomination you just submitted. Save to App Hub.

## Failure modes on a first app

-   **The landing page is blank or is the wrong page.** The home task’s `routingPattern` is not `/`, or the task id and the page id disagree.
-   **Worker search is empty in preview.** The tenant is not connected, or you are not signed in as a persona that can see workers.
-   **The form submits and the instance count stays zero.** The outbound endpoint is not aimed at the Nomination object, or you rejected the endpoint half of the diff.
-   **HR Administrator cannot open the data.** The domain exists in the app, but the tenant policy was not created or not activated.
-   **Validate reports an error the tutorial did not show.** Workday’s agent-building activity says the result is non-deterministic and an error is possible. Read it, correct it, or ask Developer Agent. Do not deploy over a red validate.
-   **You added a business object you do not want to keep.** You cannot remove a model component that has already deployed in a previous version. Delete or avoid promoting that version. Do not “fix” it by prompting a second object with a near-duplicate name.

## What a prompt costs

Each query or command you submit is an invocation. The same meter applies in the Developer Site chat and in a desktop tool connected to Developer Agent. Developer Copilot for Orchestrate does not count toward this entitlement.

A personal Build account has a lifetime invocation entitlement. When it is used up, Developer Agent stops responding. Workday’s entitlements page does not publish that personal number. Enterprise customers have an annual entitlement. The [Flex Credits rate card](https://www.workday.com/content/dam/web/en-us/documents/legal/current-flex-credits-rate-card.pdf), last updated November 5, 2026, says Flex Credits start only after 50,000 Developer Agent invocations in the entitlement year, at 2 credits per invocation after that. Unused entitlement expires at the subscription anniversary and does not roll over. The rate card says those rates are informational, not an offer. Partners and producers are different again: when their calendar-year entitlement is gone, the agent stops until the next calendar year. It does not switch them to Flex Credits.

Check the three-bar icon in the Developer Agent header before a long generate-and-reject loop.

## Watch Kiweely Vine build, secure and test an Extend app

![Kiweely Vine's Training Approval Extend app: the manager opens the employee's training request from his Workday tasks](https://kiweely.com/guides/first-workday-extend-app-developer-agent/media/vine-extend-app-training-approval-8f3cf9bc75d9.webp)

From the film: the manager opens the employee’s request in his Workday tasks.

From two short messages, Kiweely Vine builds a training approval app in a Workday Development tenant. It sets up the app’s access (Employee As Self and Manager) and the approval’s business process security policy, activates the pending security changes, adds the Manager step to the routing, then tests it as the employees and managers through Start Proxy, privacy checks included. 1 h 51 min from sign-up to the checked result.

[Watch the film (15 min)](https://www.youtube.com/watch?v=hoJV5tq90Ug) · [Start for free](https://kiweely.com/sign-in?intent=signup)

## Frequently asked questions

### Does Developer Agent deploy the app when I press Enter?

No. The nomination tutorial says the agent generates page definitions and related artifacts in App Builder. You apply them, save to App Hub, and choose Save and Deploy to a development tenant.

### Can the first prompt include the business object?

The overview says yes: one prompt can build an app including business objects and security domains. The nomination tutorial still has you create `NominationData` and `Nomination` yourself so the later page prompts have a stable name. If you let the agent create the object, read the security domain on it before you apply.

### Do I have to be on Extend Professional?

Workday’s marketing page says Developer Agent is generally available starting 2026R2+, through Workday Extend Professional, with Flex Credits pricing. The build tutorials separately say a Workday Build account and development tenant are free to create. Those pages do not spell out one combined price. Read the entitlements page for the account type you actually have.

### Where do I see the record I just created?

App Manager, Configure, Extend Business Object Instance Count. A later manage page can list the same rows once you have generated and applied it.

## Sources checked

-   [Build an Extend App Fast with Developer Agent](https://developer.workday.com/documentation/GUID-73f17cca-3686-4921-84bf-44b819d9671e-enHYPHENus/BuildanExtendAppFastwithDeveloperAgent)
-   [Developer Agent Overview](https://developer.workday.com/documentation/GUID-f1ddebc6-077a-4441-a023-3c857db88053-enHYPHENus/DeveloperAgentOverview)
-   [Getting Started with Extend Apps](https://developer.workday.com/documentation/GUID-04def314-83a7-4edf-b84c-c0a5f005b23c-enHYPHENus)
-   [Entitlements and Flex Credits for Developer Agent Invocations](https://developer.workday.com/documentation/GUID-5b348dc5-d602-4367-8d3c-dcbd6d92c5b6-enHYPHENus/EntitlementsandFlexCreditsforDeveloperAgentInvocations)
-   [Workday Flex Credits Rate Card](https://www.workday.com/content/dam/web/en-us/documents/legal/current-flex-credits-rate-card.pdf)

## Related guides

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

-   [### The Validate and Deploy Proof Ladder for Workday Extend Preview and validate before a tenant sees anything. Save to App Hub writes a build. Deploy reaches a development tenant only. Promote one level at a time. Model components still wait for the weekly update. Orchestrations validate in Orchestration Builder.](https://kiweely.com/guides/workday-extend-validate-deploy-proof-ladder)
-   [### AMD vs PMD in Workday Extend, for Beginners In Workday Extend, the AMD declares data providers, task routes, flows, and app properties. A PMD draws one page and calls those providers. Business objects, security domains, and other model files are separate and follow the weekly update once you leave Development.](https://kiweely.com/guides/workday-extend-amd-vs-pmd-beginners)
-   [### Workday Developer Agent Prompt Templates That Hold Workday’s prompt guide splits requests into questions, edits, new pages, queries, and business objects. Name the real component and the fields. A prompt that says build everything tends to add model components you cannot remove after they deploy.](https://kiweely.com/guides/workday-developer-agent-prompt-templates)
-   [### A Learning Path on a Workday Build Personal Tenant Workday’s tutorials create a free Build account and a development tenant, then sign you in as Logan McNeil. Follow the platform tour, a catalog copy, API Explorer, an Extend app, and one custom agent. Personal Developer Agent use is capped for the life of the account.](https://kiweely.com/guides/workday-build-personal-tenant-learning-path)
-   [### Your First Workday Extend Validation Error from AI Validate checks schema, semantics, and syntax, and some of those checks do not run as you type. A generated diff can still fail. Model error codes name the limit you hit. Reject a bad diff instead of stacking repairs, and do not deploy over a red validate.](https://kiweely.com/guides/first-workday-extend-validation-error-ai)
-   [### Security Domains for Your First Workday Extend App A security domain file does nothing until you deploy, create the domain security policy, grant a security group, and activate it. Page security should use unconstrained role-based groups. Developer Agent can write the file. It does not configure the tenant.](https://kiweely.com/guides/first-workday-extend-app-security-domains)

### More guides on Custom agents and Workday AI

[All 91 guides](https://kiweely.com/guides#custom-agents)

-   [What counts as Workday test evidence when an agent helped](https://kiweely.com/guides/workday-uat-evidence-pack-ai-agents)
-   [Security workshops that follow Workday’s own access model](https://kiweely.com/guides/security-design-workshops-deployment-agent)
-   [Pick a Workday integration tool before you prompt an agent](https://kiweely.com/guides/ai-workday-integration-design-workshop)
-   [Is there an AI agent that can do Workday configuration, business processes and security changes in a tenant for me?](https://kiweely.com/guides/ai-agent-for-workday-configuration-business-process-security)
-   [Our Workday consulting firm wants an AI tool that does tenant work for our consultants: what are the options and costs?](https://kiweely.com/guides/ai-tools-for-workday-consulting-firms-options-costs)
-   [Discovery questions Workday’s Deployment Agent can answer](https://kiweely.com/guides/ai-workday-discovery-fit-gap-workshops)
-   [Use Deployment Agent beside Object Transporter, not instead of it](https://kiweely.com/guides/ai-assistant-workday-object-transporter)
-   [Planning Agent and Decision Intelligence](https://kiweely.com/guides/workday-planning-agent-decision-intelligence)

### From the blog on Custom agents and Workday AI

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

-   [Tenant Inspection vs. Tenant Execution: Where Workday’s Deployment Agent Stops and Kiweely Starts](https://kiweely.com/blog/workday-deployment-agent-vs-execution-agent)
-   [Why Flex Credit Forecasting Gets Harder When Sana, Data Cloud, and Custom Agents Share One Pool](https://kiweely.com/blog/estimating-workday-flex-credits-for-sana-and-data-cloud)
-   [Connecting Claude or Copilot to Workday via MCP: Seven Security Questions to Answer First](https://kiweely.com/blog/workday-mcp-agent-ready-tools-security-checklist)

## 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.
