---
category: [Administration & Integrations, Administration & Integrations/Custom Integrations & Apps, Platform and Product Extensions, Platform and Product Extensions/Integration]
keyword: Integrate
nav: wcp_docs
parent_url: /wcp_docs/
title: >- 
  Concept: Integration App Lifecycle
layout: subsection
---

<a id="section_wf5_5rg_vpb"></a>
Orchestrate for Integrations enables you to iteratively develop and test your integration apps across multiple environments. This iterative approach ensures that apps are working properly before you install them in your production environment.

When you have an idea to solve a business problem for your organization, you iterate through these phases of the app lifecycle to put your idea into action:

-   Build: Create an integration app that brings your idea to life.
-   Test: Test your app and its configurations.
-   Verify: Verify that your app works in a production-like environment.
-   Release: Release your app to production.


![](GUID-b10b0e60-80ed-46ab-8cbd-ebd653387929-enHYPHENus.png)

Each stage of the lifecycle corresponds to the promotion level of your app and the Workday environment in which you can run the app. Each completed cycle results in a new version of the app that you can run in your production environment.

![](GUID-3bc89d16-526f-4073-8ab3-c11fe3982d71.png)

## <a id="section_ict_n1h_mqb"></a>Promotion Levels

When you upload source code to App Hub, App Hub compiles the code into a build that you can promote. You promote integration apps through these promotion levels. Each promotion level corresponds to the runtime environment of the tenant on which you can deploy or install your app. You can take different actions for each promotion level:

-   <b>Implementation Release</b>

    When you build an integrations app, you first save your code to AppHub, then promote it to Implementation Release. You can then install, configure, and test the app on Implementation or Implementation Preview tenants.

    When you create an Implementation Release, you replace the existing Implementation Release version of the app, if one exists.

-   <b>Sandbox Release</b>

    Promote your app to Sandbox Release to install, configure, and test the app on Sandbox or Sandbox Preview tenants.

    When you promote an app to Sandbox Release, you:

    -   Promote the latest Implementation Release version of your app to Sandbox Release.
    -   Replace the existing Sandbox Release version of the app, if one exists.

    Because Sandbox and Sandbox Preview tenants are refreshed every week with production data, this is a best practice to ensure that there are no issues with your code.

    <b>Note:</b> On the external client credential store, you must create refresh tokens in both Sandbox and Sandbox Preview tenants. If you have business objects in Sandbox Preview but don't have refresh tokens in Sandbox Preview, you encounter HTTP 500 errors when accessing those business objects. If you've only created refresh tokens in the Sandbox tenant, you can only access the business objects in the Sandbox tenant.

-   <b>Production Release</b>

    When you promote your app to Production Release, your Company Administrator can install and configure the app on Production tenants.



## <a id="section_bz2_rfd_npb"></a>Promote Apps

Promote your apps from the Workday Developer Site. Select the app you want to promote from the <b>Apps</b> page of the Console.

On the <b>Overview</b> tab, you can:

-   View the Build Status and Build Log of the most recent build of your app.
-   View the app components that comprise your app.


On the <b>Promotions</b> tab, you can:

-   Promote your app to the next available promotion level.
-   Install your app on Implementation, Sandbox, and Production tenants.

    <b>Note:</b> Once you install an app on an Implementation, Sandbox, or Production tenant, you can't remove the app from that tenant.



When you promote an app, you replace the existing version of the app with the target promotion level.

## <a id="section_nqf_3vg_vpb"></a>Configure Apps on Tenants

Use the <b>App Manager</b> worklet on your Workday tenant to configure apps on the tenant.

The <b>App Manager</b> worklet displays the latest version of the app that you can install and configure on the tenant.