---
title: "Create a custom provider"
method: POST
path: "/api/providers/"
tags: ["models"]
---

# Create a custom provider

`POST /api/providers/`

Create a custom provider. Use `PATCH /api/providers/{provider_id}/` to update an existing provider.

## Headers

- `Authorization` string, required

## Request body

- object
  - `provider_id` string, required — Unique provider identifier within your organization.
  - `provider_name` string, required — Human-readable provider name.
  - `extra_kwargs` object — Provider configuration. Put provider credentials under extra_kwargs.api_key.

## Response `201`

Created provider.

- ModelsCreateCustomProviderResponse201
  - `id` string, required — Provider string ID. Same value as `provider_id`.
  - `provider_id` string, required — Unique provider identifier within your organization.
  - `provider_name` string, required — Human-readable provider name.
  - `extra_kwargs` object — Stored provider configuration. The current backend returns this object, including credentials it contains; handle the response as sensitive.
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized - Missing or invalid authentication

## Changes

> 6 revisions in range; 3 could not be searched.

- **2026-07-31** `c26d550029f8` — 2 breaking, 1 warning, 9 info
  - the `extra_kwargs` request property type/format changed from `object`/`` to ``/``
  - the `extra_kwargs` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - removed the request property `api_key`
  - added the new optional request property `models_sync_config`
  - …8 more

[Change history](https://skmtc.dev/keywordsai/apis/api-reference/changes/api/providers/post.md)

---

[API](https://skmtc.dev/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.dev/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keywordsai/api-reference/revisions/c61efaf24756/schema)