---
title: "Bitrise integration"
slug: "bitrise-integration"
updated: 2024-07-02T06:43:12Z
published: 2024-07-02T06:43:12Z
canonical: "help.autify.com/bitrise-integration"
---

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

# Bitrise integration

Autify provides the official Bitrise step to upload a build and run a test plan easily from your Bitrise workflow.

## Getting started

This document describes how to use our Bitrise integrations with your Bitrise workflow step-by-step.

### Prerequisites

First, we assume you already have Bitrise workflow to build your application. We'll add an Autify test step right after the build step to confirm the newly built application doesn't break the end-to-end experience.

Secondly, you need to create a test plan on [Autify NoCode Mobile](https://mobile-app.autify.com). Please note the URL of your test plan e.g. `https://mobile-app.autify.com/projects/AAA/test_plans/BBB` and we'll use it later.

You also need to [create a personal access token](https://help.autify.com/mobile/docs/api-integration#api-authentication-token-generation-method) of Autify NoCode Mobile. Please note the generated token somewhere so that we can store the value on Bitrise Secrets later.

*Note: Since the personal access token is associated with a single user, we recommend you to create a machine user in your organization and use its personal access token for CI/CD integration.*

### Store personal access token on Bitrise Secrets

Store the personal access token you generated above on Secrets by following [Bitrise's document](https://devcenter.bitrise.io/en/builds/secrets.html). You can use an arbitrary name for the Secrets but that name will be referred by your Bitrise workflow definition later. Assuming you named it `AUTIFY_MOBILE_ACCESS_TOKEN` here.

### Add Bitrise step to upload a build and run Autify NoCode Mobile

Finally, let's add a new step to your existing Bitrise workflow. See the examples below to edit your `bitrise.yaml`. The `autify-test-url` value should be the URL you noted above. You can also configure exactly the same steps via Bitrise UI.

- [Autify Test Run step](https://www.bitrise.io/integrations/steps/autify-test-run)
- [Autify Upload step](https://www.bitrise.io/integrations/steps/autify-upload)

---

Upload a new build file and start a test (no waiting for the finish of the test):

```
## With Android Build step: https://www.bitrise.io/integrations/steps/android-build
- android-build@1: {}
- autify-test-run@1:
    inputs:
    - access_token: "$AUTIFY_MOBILE_ACCESS_TOKEN"
    - autify_test_url: https://mobile-app.autify.com/projects/AAA/test_plans/BBB
    - build_path: "$BITRISE_APK_PATH"

## With Xcode build for simulator step: https://www.bitrise.io/integrations/steps/xcode-build-for-simulator
- xcode-build-for-simulator@0: {}
- autify-test-run@1:
    inputs:
    - access_token: "$AUTIFY_MOBILE_ACCESS_TOKEN"
    - autify_test_url: https://mobile-app.autify.com/projects/AAA/test_plans/BBB
    - build_path: "$BITRISE_APP_DIR_PATH"
```

If you want to wait until the test finishes or timed out:

```
- autify-test-run@1:
    inputs:
    - access_token: "$AUTIFY_MOBILE_ACCESS_TOKEN"
    - autify_test_url: https://mobile-app.autify.com/projects/AAA/test_plans/BBB
    - build_path: /path/to/your-[ios.app|android.apk]
    - wait: 'true'
    - timeout: '3000'
```

**CAVEAT: This will consume your Bitrise credits while waiting. Be careful when extending the timeout value.**

Just upload a new build file (`workspace_id` is the id right after `/projects/` in the URL you noted above):

```
- autify-upload@1:
    inputs:
    - access_token: "$AUTIFY_MOBILE_ACCESS_TOKEN"
    - workspace_id: AAA
    - build_path: /path/to/your-[ios.app|android.apk]
```

## Conclusion

By using [Autify's Bitrise step](https://www.bitrise.io/integrations/steps/autify-test-run), you can automatically run a test plan after build so that you can detect regressions right away and take an appropriate actions without wasting time.