---
title: "Create vault provider"
method: POST
path: "/api/v1/vault/providers"
tags: ["Customer Vault"]
---

# Create vault provider

`POST /api/v1/vault/providers`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/api/v1/vault/providers`
- Auth: API key in header `Authorization`

Create a new vault provider configuration for an organization

## Headers

- `X-Organization-ID` string, required
- `X-User-ID` string, required

## Request body

- CustomervaultCreateVaultProviderRequest
  - `display_name` string
  - `is_default` boolean
  - `provider_config` object, required
  - `provider_name` 'internal' | 'hashicorp_vault' | 'aws_secrets_manager' | 'azure_key_vault' | 'gcp_secret_manager', required

## Response `200`

Vault provider created successfully

- CustomervaultCustomerVaultProvider
  - `created_at` string
  - `created_by` string
  - `display_name` string
  - `id` string
  - `is_active` boolean
  - `is_default` boolean
  - `organization_id` string: Populated at runtime via JOIN with vault_provider_organizations
  - `provider_config` object
  - `provider_name` 'internal' | 'hashicorp_vault' | 'aws_secrets_manager' | 'azure_key_vault' | 'gcp_secret_manager'
  - `updated_at` string

## Other responses

- `400`: Invalid request body or missing headers
- `500`: Internal server error

---

[API](https://skmtc.dev/nife/apis/nife-io-swagger-api.md) - [All operations](https://skmtc.dev/nife/apis/nife-io-swagger-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nife/apis/nife-io-swagger-api/revisions/6e868dc62795?raw)