> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rootly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dropbox Paper

> Connect Dropbox Paper to Rootly to automatically create and update retrospective documents from incidents using Liquid templates.

The Dropbox Paper integration connects Rootly with your Dropbox account so teams can automatically create and update retrospective documents during and after incidents through Genius workflows.

With the Dropbox Paper integration, you can:

* Automatically create retrospective documents in Dropbox Paper from incident workflows
* Populate documents using Rootly retrospective templates or custom Liquid templates
* Update existing Paper documents as an incident progresses
* Attach created documents directly to the incident record

## Before You Begin

Before setting up the integration, make sure you have:

* A Rootly account with admin permission to manage integrations
* A Dropbox or Dropbox Business account

<Info>
  Rootly recommends installing the integration with a **service account** so it does not break if the installing user leaves your organization.
</Info>

<Info>
  Access level depends on your Dropbox account type:

  * **Dropbox Paper** (personal) — non-admin access is sufficient, but you will only have access to your personal folders
  * **Dropbox Paper Business** — admin-level access is required to access team folders and namespaces
</Info>

## Installation

<Steps>
  <Step title="Open the Dropbox Paper integration in Rootly" icon="plug">
    Navigate to the integrations page in Rootly and select **Dropbox Paper**.

    <Frame>
      <img alt="Dropbox Paper integration on the integrations page" src="https://mintcdn.com/rootly/yHcXrOapKHrppc-2/images/integrations/dropbox-paper/installation/images-1.webp?fit=max&auto=format&n=yHcXrOapKHrppc-2&q=85&s=b881ddde39ed459a9b8b0b7baa63314d" width="868" height="419" data-path="images/integrations/dropbox-paper/installation/images-1.webp" />
    </Frame>
  </Step>

  <Step title="Authorize Rootly in Dropbox" icon="key">
    You will be prompted to sign in to Dropbox and grant Rootly permission to access your account.

    Once confirmed, the installation is complete and Dropbox Paper workflow actions become available.

    <Check>
      After authorization, the **Create a Dropbox Paper** and **Update a Dropbox Paper** workflow actions are immediately available in your Genius workflows.
    </Check>
  </Step>
</Steps>

## Workflow Actions

The Dropbox Paper integration provides two workflow actions for creating and updating Paper documents from incidents. If you are unfamiliar with how workflows function, see the [Workflows](/workflows/workflows) documentation first.

<Frame>
  <img alt="Dropbox Paper workflow actions" src="https://mintcdn.com/rootly/7PwamMJIAOaYlZ7c/images/integrations/dropbox-paper/workflows/images-1.webp?fit=max&auto=format&n=7PwamMJIAOaYlZ7c&q=85&s=12a8d18647bfac02e2ba3af9df2a4666" width="868" height="391" data-path="images/integrations/dropbox-paper/workflows/images-1.webp" />
</Frame>

### Create a Dropbox Paper Document

This action creates a new Paper document in a specified Dropbox folder.

<Frame>
  <img alt="Create Dropbox Paper action configuration" src="https://mintcdn.com/rootly/7PwamMJIAOaYlZ7c/images/integrations/dropbox-paper/workflows/images-2.webp?fit=max&auto=format&n=7PwamMJIAOaYlZ7c&q=85&s=bd2814de474703dbaa607350bb02267c" width="871" height="810" data-path="images/integrations/dropbox-paper/workflows/images-2.webp" />
</Frame>

**Name**
The display name for this workflow action. Rename it to describe what the action does — the value does not affect behavior.

**Namespace**
Only available when integrated with **Dropbox Paper Business**. Selects the team namespace from which the parent folder list is populated.

<Info>
  If you integrated with personal Dropbox Paper, the Namespace field is not shown and folders are limited to your personal folders.
</Info>

**Parent Folder**
The folder in which the Paper document will be created.

* **Dropbox Paper** (personal) — shows your personal folders
* **Dropbox Paper Business** — shows folders within the selected Namespace

**Title**
The title of the Paper document. Defaults to `{{ incident.title }}`. Supports Liquid syntax.

<Tip>
  Use the [Incident Variable Explorer](https://rootly.com/account/help/liquid-explorer) to preview what Liquid variables return for your incidents.
</Tip>

**Retrospective Template**
Select a predefined retrospective template to populate the document body. Templates are managed on the [Retrospective Templates page](https://rootly.com/account/retrospective-steps?tab=documents).

<Warning>
  If a Retrospective Template is selected, it overrides any content defined in the Custom Retrospective Template field.
</Warning>

**Custom Retrospective Template**
Define the body content of the Paper document manually. Supports Liquid syntax. Used only when no Retrospective Template is selected.

**Mark Post Mortem as Published**
When enabled, marks the retrospective status as `published` after the document is created. Use this when you have follow-up notification workflows that trigger on published retrospectives.

### Update a Dropbox Paper Document

This action updates an existing Paper document with new content.

**Name**
The display name for this workflow action.

**File ID**
The Dropbox file ID of the Paper document to update. Supports Liquid syntax. Use `{{ incident.retrospective_url }}` or a stored file ID variable to reference the document created earlier in the workflow.

<Info>
  When a **Create a Dropbox Paper** action runs, Rootly stores the resulting document URL and file ID on the incident record. You can reference the file ID in subsequent update actions using Liquid variables.
</Info>

**Title**
The updated title for the document. Supports Liquid syntax. Leave blank to keep the existing title.

**Content**
Additional HTML content to append to the document. Supports Liquid syntax.

**Retrospective Template**
Select a predefined retrospective template to re-render the document body.

## Uninstall

To remove the Dropbox Paper integration, open the integrations panel in Rootly and select **Configure > Delete**.

## Related Resources

* [Workflows](/workflows/workflows)
* [Retrospectives](/retrospectives/retrospectives)
* [Integrations overview](/integrations/overview)
