---
title: "Start an OAuth channel installation"
method: POST
path: "/rest/api/v1/projects/{projectId}/integrations/{provider}/install"
tags: ["Integrations API"]
---

# Start an OAuth channel installation

`POST /rest/api/v1/projects/{projectId}/integrations/{provider}/install`

## Request

- Base URL: `https://api.metacopier.io`
- URL: `https://api.metacopier.io/rest/api/v1/projects/{projectId}/integrations/{provider}/install`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/metacopier/apis/metacopier-api/docs/rest/api/v1/projects/:projectId/integrations/:provider/install/post.ts> (a function with typed inputs; its response is checked against the schema)

Returns the provider authorization URL (Slack or Discord). The browser is redirected there and comes back via the callback, which creates the channel or reconnects featureId.

## Path parameters

- `projectId` string, uuid, required
- `provider` string, required

## Query parameters

- `featureId` string, uuid

## Response `200`

OK

- IntegrationInstallDTO: Start of an OAuth channel installation
  - `authorizeUrl` string: Redirect the browser to this URL

## Changes

- **2026-11-02** `2ac6d7461345`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/metacopier/apis/metacopier-api/changes/rest/api/v1/projects/:projectId/integrations/:provider/install/post.md)

---

[API](https://skmtc.dev/metacopier/apis/metacopier-api.md) - [All operations](https://skmtc.dev/metacopier/apis/metacopier-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metacopier/apis/metacopier-api/revisions/2ac6d7461345?raw)