---
title: "Create a Provider Configuration"
method: POST
path: "/v1/provider-configurations"
tags: ["Provider Configurations API"]
---

# Create a Provider Configuration

`POST /v1/provider-configurations`

Use this endpoint to create a new provider configuration. The configuration is validated against the provider's JSON Schema.

## Request body

- CreateProviderConfigurationInput
  - `config` object, required — Provider-specific configuration that is validated against the provider's JSON Schema.
  - `description` string — Human-readable description of this provider configuration.
  - `metadata` object — Custom key-value pairs for tagging.
  - `name` string, required — Unique name for this provider configuration.
  - `providerId` string, required — ID of the catalog provider to configure. Must match a registered provider.

## Response `201`

Indicates that the resource was successfully created and the operation was completed as expected.

- ProviderConfigurationCreateOutput
  - `createdAt` string, date-time — Timestamp when the configuration was created.
  - `id` string, uuid — Unique identifier of the created configuration.
  - `name` string — Name of the configuration.
  - `status` string — Initial status (always `active` on creation).

## Other responses

- `400` — Indicates that the request was malformed or contained invalid parameters.
- `404` — Indicates that the requested resource could not be found.
- `409` — Indicates that the request could not be completed due to a conflict with the current state of the resource.
- `422` — Indicates that the request was well-formed but contains semantic errors that prevent processing.
- `500` — Indicates an unexpected internal error. If this persists, please contact support.

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)