---
title: "Create a custom integration"
method: POST
path: "/v1/fleet/integrations"
tags: ["fleet integrations"]
---

# Create a custom integration

`POST /v1/fleet/integrations`

Registers a new custom integration. Type is forced to CUSTOM.

## Request body

- IntegrationsCreateRequest
  - `category` string
  - `description` string
  - `icon_url` string
  - `name` string, required
  - `source` string
  - `url` string, required

## Response `201`

Created

- IntegrationsIntegration
  - `auth_methods` IntegrationsAuthMethod[]
    - `provider_match` IntegrationsProviderMatch
      - `by` 'kind' | 'id'
      - `value` string
    - `type` 'oauth2' | 'headers' | 'api_key' | 'none'
  - `category` string
  - `created_at` string
  - `description` string
  - `enabled` boolean
  - `icon_url` string
  - `id` string
  - `name` string
  - `source` string
  - `transport` 'mcp_http'
  - `updated_at` string
  - `url` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/langchain-ai/apis/langsmith.md) · [All operations](https://skmtc.net/langchain-ai/apis/langsmith/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langchain-ai/langsmith/revisions/a0acb3a6a101/schema)