---
title: "Connect a vault provider"
method: POST
path: "/v1/vault/connections"
tags: ["Vault"]
---

# Connect a vault provider

`POST /v1/vault/connections`

Connect a supported password manager and immediately sync display-safe credential metadata.

## Request body

- object — Connect a vault provider. For `1password`, provide `token`. For `bitwarden`, provide `clientId`, `clientSecret`, and `masterPassword`.
  - `provider` '1password' | 'bitwarden', required — Vault provider identifier.
  - `token` string — 1Password service account token. Required when provider is 1password.
  - `clientId` string — Bitwarden client ID. Required when provider is bitwarden.
  - `clientSecret` string — Bitwarden client secret. Required when provider is bitwarden.
  - `masterPassword` string — Bitwarden master password. Required when provider is bitwarden.
  - `serverUrl` string, uri — Optional self-hosted Bitwarden server URL.

## Response `200`

Vault connected successfully.

- object
  - `connectionId` string, required
  - `connected` true, required
  - `provider` '1password' | 'bitwarden', required — Vault provider identifier.
  - `items` object[], required
    - `itemId` string, required
    - `connectionId` string, nullable, required
    - `label` string, required
    - `vaultName` string, required
    - `domains` string[], required
    - `fieldMetadata` object[], required
      - `fieldId` string, required
      - `label` string, required
      - `type` 'STRING' | 'CONCEALED' | 'OTP', required
    - `hasTotp` boolean, required

## Other responses

- `400` — Invalid request body or provider credentials.
- `401` — Unauthorized - Invalid or missing API key
- `500` — Internal server error
- `503` — Vault feature is not enabled

---

[API](https://skmtc.dev/tinyfish/apis/tinyfish-web-agent-automation-api.md) · [All operations](https://skmtc.dev/tinyfish/apis/tinyfish-web-agent-automation-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tinyfish/tinyfish-web-agent-automation-api/revisions/bea716bc627d/schema)