---
title: "POST /api/llm/providers"
method: POST
path: "/api/llm/providers"
tags: ["/api/llm"]
---

# POST /api/llm/providers

`POST /api/llm/providers`

## Request

- Base URL: `` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/llm/providers`
- Auth: API key in header `X-API-Key`

Create a provider connection. The credentials are verified before the connection is saved.

## Request body

- object
  - `config` object, nullable: Value must be a map.
  - `key` string, nullable
  - `model` string, nullable
  - `name` string, nullable
  - `type` string, required

## Response `2XX`

Successful response

- object
  - `config` object, required
  - `env_fields` string[], required
  - `env_vars` string[], required
  - `key` string, required
  - `name` string, required
  - `source` 'db' | 'env', required
  - `type` string, required
  - `usable` boolean, required

## Other responses

- `4XX`: Client error response
- `5XX`: Server error response

## Changes

- **2026-11-04** `2e178f5a7934`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/metabase/apis/metabase-api/changes/api/llm/providers/post.md)

---

[API](https://skmtc.dev/metabase/apis/metabase-api.md) - [All operations](https://skmtc.dev/metabase/apis/metabase-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metabase/apis/metabase-api/revisions/2e178f5a7934?raw)