---
title: "Add a new app"
method: POST
path: "/apps/register"
tags: ["app-setup"]
---

# Add a new app

`POST /apps/register`

Add a new app to Bitrise. This is the first step of the app registration process. To successfully set it up, you need to provide the required app parameters: the repository URL and the isPublic field. Read more about the app creation process in our [detailed guide](https://devcenter.bitrise.io/api/adding-and-managing-apps/#adding-a-new-app).

## Request body

- V0AppUploadParams
  - `default_branch_name` string — The default branch of the repository. If it's not specified, it will be `master`.
  - `git_owner` string — [Deprecated] You no longer need to provide this field.
  - `git_repo_slug` string — [Deprecated] You no longer need to provide this field.
  - `is_public` boolean, required — If `true` then the repository visibility setting will be public, in case of `false` it will be private
  - `manual_approval_enabled` boolean — Toggles whether manual approval should be enabled for the app's builds. If it's not specified, it will be `true`.
  - `organization_slug` string — The slug of the organization, who will be the owner of the application. If it's not specified, then the authenticated user will be the owner.
  - `provider` string — The git provider you are using, it can be `github`, `bitbucket`, `gitlab`, `gitlab-self-hosted` or `custom`
  - `repo_url` string, required — The URL of your repository
  - `title` string — The title of the application. If it's not specified, it will be the git repository's name.
  - `type` string — [Deprecated] You no longer need to provide this field.

## Response `200`

OK

- V0AppRespModel
  - `slug` string
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/bitrise/apis/bitrise-api.md) · [All operations](https://skmtc.net/bitrise/apis/bitrise-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitrise/bitrise-api/revisions/89468e4a014b/schema)