---
title: Map Playbook Outputs to Applications
slug: map-playbook-outputs-to-applications
docTags: 
createdAt: 2025-08-11T11:13:46.000Z
---

When you map playbook outputs to an application, you allow the playbook runs to update records for various things, such as performing manual security actions, collecting information for charts and dashboards, and increasing visibility for auditing.

## Map Playbook Outputs to Applications

Create a new playbook or upload an existing playbook, then follow the steps below:

1. Click **Playbook Outputs**.
2. On **Playbook Outputs**, click the **Application Mapping** tab.
3. To map the promoted playbook outputs to an application, click **Select Existing Application**.
4. On **Select an Application**, click the application to which you want to map the playbook outputs and click **Confirm**.

::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/5DzzZrQAzd30esB_CcI7i_select-an-application-record-linking.png" size="64" width="500" height="400" darkWidth="800" darkHeight="640" position="center" indent="2" showCaption="false"}

## Update or Create New Records

Select how you want to handle distribution of the playbook outputs to the application's records.

1. Click **Update or create new records**.
2. Choose one of the following:
   - To create a new record with the playbook outputs, click **Create new records**.
   - To create or update a record with the playbook outputs, click **Update or create new records**.
3. In the **Key Field** drop-down menu, select the field that uniquely identifies each record.

::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/_r5cxq-euas30gOPiUNhy_record-creation-update-or-create-new.png" size="68" width="1795" height="811" darkWidth="800" darkHeight="361" position="center" indent="2" showCaption="false"}

4. When finished, click **Apply**.
5. To remove any application mappings, click **Remove App & Mappings**.

## Set Up Error Handling

Select how you want to handle errors encountered during the insertion process.

1. Choose an error handling option:
   - **Set fields as empty on error**
   - **Skip record on error**
   - **Stop record creation on error**
2. When finished, click **Apply**.

## Record Linking

There are three possible scenarios that can occur with record linking when mapping playbook outputs to an application.

See [Record Use Cases](#) for details.