Skip to main content
POST
Create an outbound credential
Requires Admin or Owner. Supply a unique name, credential type, and matching credential_data. Duplicate names return 409; missing required credential fields return 400. The response contains metadata and a UUID, not the stored secret. Supply credentials through your secret-management process. Do not place real secrets in shared examples or source control.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Headers

X-VOAI-ORGANIZATION-ID
string | null

Required with X-BW-LABS-AGENTS-API-KEY: the positive local workspace ID to access. The key owner must be a current member. Missing or invalid IDs return 400; non-member workspaces return 403. Not required for bearer authentication, which uses the user's selected workspace.

Body

application/json
credential_data
Credential Data · object
required
credential_type
enum<string>
required
Available options:
none,
api_key,
bearer_token,
basic_auth,
custom_header,
oauth2_client_credentials
name
string
required
description
string | null

Response

Successful Response

created_at
string<date-time>
required
credential_type
string
required
description
string | null
required
name
string
required
updated_at
string<date-time> | null
required
uuid
string
required