# Bitrise

{% embed url="<https://bitrise.io/integrations/steps/deploy-to-updraft>" %}

## Updraft Integration with Bitrise

This guide outlines the steps to integrate **Updraft** into your **Bitrise CI/CD Workflow** for automated builds and deployments.

### Prerequisites

Before you begin, ensure the following prerequisites are met:

* An **Updraft** account with the appropriate permissions to upload builds.
* A **Bitrise** account with an existing project integrated into Bitrise.
* API and App keys for **Updraft**
  * **Each app has his own App key in Updraft**

## 1. Prepare Your Bitrise Project

### 1.1. Set Up the Workflow

1. Log in to your Bitrise account and navigate to your project.
2. From the left-hand menu, select the **Workflow Editor**.
3. Create a new workflow or select an existing workflow where you want to integrate Updraft build step: <https://bitrise.io/integrations/steps/deploy-to-updraft>

## 2. Add the Updraft Step

### 2.1. Add Step to Workflow

1. In the **Workflow Editor**, click the **+** button to add a new step.
2. Search for the **Updraft** build step&#x20;

### 2.2. Add app token in Bitrise project

#### Now it’s time to paste your **Updraft  App Token** in Bitrise.io <a href="#step-5--setup-your-app-token-in-the-bitrise-project" id="step-5--setup-your-app-token-in-the-bitrise-project"></a>

Go to the menu of the Bitrise.io dashboard and select the **Secrets** menu option. Click the **Add New** button and add the API key in the  input field and paste your Updraft API Key  and click “Save”.

## 3. Test the Workflow

1. Save your changes in the Workflow Editor.
2. Trigger a new build in Bitrise to test the workflow.
3. Check the build logs to ensure the upload of the artifacts to Updraft was successful.
4. Verify that the build artifact is available in Updraft.

## 4. Troubleshooting

If issues arise during the integration, check the following:

* **API and App Key**: Ensure the API key and the App key is correct and valid.
* **Build Artifact Path**: Make sure the path to the build artifact is correctly specified.
* **Network Access**: Verify that network access from Bitrise to Updraft is not blocked.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.getupdraft.com/integrations/bitrise.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
