v1
integrations

Create Credentials

Changed on
post/api/integrations/{provider}/credentials

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

Path parameters

providerstring required

Provider name for integrations. Can be any string value, including custom provider names.

Request body

OR
OR
OR

Response

Successful Response

idstring required
providerstring required
type'api_key' | 'oauth2' | 'user_password' | 'host_scoped' | 'device_code' required
titlestring nullable required
scopesstring[] nullable required
usernamestring nullable required
hoststring nullable

Host pattern for host-scoped or MCP server URL for MCP credentials

scopestring nullable

What a user/password login may be used for, e.g. smtp://host[:port]; null for a login saved before scopes existed

mcp_auth_scheme'basic' | 'bearer' nullable

Manual authorization scheme for MCP credentials

is_managedboolean
servicestring
service_namestring nullable
service_iconstring nullable

Changes

    • info

      added the new optional request property /

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status