---
title: "Add a destination to a room"
method: POST
path: "/{id}/integrations"
---

# Add a destination to a room

`POST /{id}/integrations`

## Request

- Base URL: `https://marklayer.app/api`
- URL: `https://marklayer.app/api/{id}/integrations`
- Auth: none declared

## Path parameters

- `id` string, required: Unguessable share id (nanoid/uuid) — it is the access token

## Request body

- AddIntegration
  - `provider` string, required
  - `config` object, required

## Response `200`

Stored

- Integrations
  - `integrations` IntegrationSummary[], required
    - `provider` string, required
    - `hint` string, nullable, required

## Other responses

- `400`: Destination rejected
- `401`: Password-protected link: send `Authorization: Bearer <password>`
- `404`: Not found
- `429`: Too many wrong passwords for this link from this client

---

[API](https://skmtc.dev/marklayer/apis/marklayer-share-api.md) · [All operations](https://skmtc.dev/marklayer/apis/marklayer-share-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marklayer/apis/marklayer-share-api/revisions/0d8cd55afad9?raw)