For AI agents: a documentation index is available at /llms.txt
Skip to main content

/integrations/onepassword

POST 

/integrations/onepassword

Registers a 1Password integration for the requesting token. The supplied service-account token is encrypted at rest and is never returned by this or any other endpoint. Returns the created integration without any token field.

Note: This endpoint is also available at: /management/integrations/onepassword for backwards compatibility.

Request​

Body

    labelstringrequired

    A user-visible label for the integration. Unique per token.

    kindstring

    Integration kind. Defaults to "service_account".

    Possible values: [connect, service_account]

    serviceAccountTokenstringrequired

    The 1Password service-account token (or Connect access token when kind is "connect"). Encrypted at rest; never returned by any API.

    allowedDomainsstring[]

    Origins this integration may fill credentials into. Empty means no fills pass.

    connectUrlstring

    Connect server URL. Required when kind is "connect", rejected otherwise.

Responses​

Public-facing integration response returned by HTTP routes. Omits internal fields — never includes token_hash or any token material.

Schema
    vaultsstring[]

    Live vault titles, only with includeVaults=true; null when unavailable.

    idstringrequired

    Unique integration identifier.

    labelstringrequired

    User-supplied label. Unique per token.

    kindOpIntegrationKindrequired

    Integration kind: service_account (default) or connect.

    Possible values: [connect, service_account]

    allowedDomainsstring[]required

    Origins this integration is allowed to fill into.

    connectUrlstringrequired

    Connect server URL when kind is connect, otherwise null.

    expiresAtstringrequired

    ISO timestamp after which the integration is treated as expired, or null.

    lastResolvedAtstringrequired

    ISO timestamp of the last successful secret resolve, or null if never used.

    createdAtstringrequired

    ISO timestamp of when the integration was created.

    updatedAtstringrequired

    ISO timestamp of the last metadata change.

Was this page helpful?