---
title: "Create a VCS Provider"
method: POST
path: "/vcs-providers"
tags: ["vcs-providers"]
---

# Create a VCS Provider

`POST /vcs-providers`

Create a new VCS connection between Scalr and a VCS provider.

VCS providers can be created at the Scalr account. Self-hosted Scalr also supports
the creation of global VCS providers. If a VCS provider is created globally, all accounts
within the self-hosted installation will have access to use the VCS provider.

Only VCS providers with `personal_token` auth type, can be created through the API.
If you need to set up `oauth2` provider, you should use Scalr
[web interface](/docs/github) to do this.

## Response `201`

Created.

## Other responses

- `403` — User unauthorized to perform action.
- `404` — Relationship resource not found, or user unauthorized to perform action.
- `422` — Malformed request body (missing attributes, wrong types, etc.).
- `4XX` — Client error.
- `5XX` — Server error.

---

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