---
title: "Select the account a project uses"
method: PUT
path: "/api/v1/manage/integrations/connections/{provider}"
tags: ["Integrations"]
---

# Select the account a project uses

`PUT /api/v1/manage/integrations/connections/{provider}`

## Request

- Base URL: `https://fillo.so`
- URL: `https://fillo.so/api/v1/manage/integrations/connections/{provider}`
- Auth: HTTP bearer

Point the key's project at one of the workspace's provider accounts. Accounts belong to the workspace and are selected per project, so one install can serve several projects. Scope: integrations:manage.

## Path parameters

- `provider` 'notion' | 'slack' | 'hubspot' | 'discord', required

## Request body

- object
  - `connectionId` string, required

## Response `200`

The accounts, with the new selection applied.

- IntegrationConnections
  - `accounts` object[], required
    - `id` string, required
    - `provider` 'notion' | 'slack' | 'hubspot' | 'discord', required
    - `label` string, required: The account's display name — also the exact value a removal must confirm with.
    - `selected` boolean, required: True when the key's project currently uses this account.
    - `projectCount` integer, required
    - `formDestinationCount` integer, required
  - `selected` object, required: The account id this project uses for each provider, or null.
    - `notion` string, nullable, required
    - `slack` string, nullable, required
    - `hubspot` string, nullable, required
    - `discord` string, nullable, required
  - `discordServers` object[], required
    - `id` string, required
    - `guildId` string, required
    - `name` string, nullable, required

## Other responses

- `400`: Invalid request (e.g. a body on a GET/DELETE, or a missing required query parameter).
- `401`: Missing, malformed, unknown, revoked, or expired key.
- `403`: The key is valid but lacks the required scope.
- `404`: No such resource in this project (returned instead of 403 for ids in other projects).
- `409`: The request was understood but refused in this state — an unmet precondition, or a confirm value that did not match. Nothing was changed.
- `413`: The request body exceeded the 16 KiB management cap.
- `429`: Per-key (120/min), per-workspace (240/min), or per-IP (300/min) rate limit exceeded. Retry after the Retry-After header.

---

[API](https://skmtc.dev/fillo/apis/fillo-management-api.md) · [All operations](https://skmtc.dev/fillo/apis/fillo-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fillo/apis/fillo-management-api/revisions/867f943f04f5?raw)