---
title: "Create a plugin"
method: POST
path: "/workspaces/{ws_id}/plugins"
tags: ["Plugin"]
---

# Create a plugin

`POST /workspaces/{ws_id}/plugins`

## Request body

- Plugin
  - `id` string
  - `name` string
  - `enabled` boolean
  - `endpoint_id` string, nullable
  - `source_id` string, nullable
  - `config` object
  - `metadata` Metadata
  - `created_at` integer
  - `updated_at` integer

## Response `200`

OK

- Plugin
  - `id` string
  - `name` string
  - `enabled` boolean
  - `endpoint_id` string, nullable
  - `source_id` string, nullable
  - `config` object
  - `metadata` Metadata
  - `created_at` integer
  - `updated_at` integer

## Changes

> 44 revisions in range; 1 could not be searched.

- **2025-11-17** `ac82b7ca7ad3` — 1 breaking, 2 info
  - the request property `config` became not nullable
  - the `config` request property default value `{}` was added
  - the `config` response's property default value `{}` was added for the status `200`
- **2025-07-29** `232f34fd9749` — 2 breaking, 10 info
  - the response property `config` became nullable for the status `200`
  - the response property `name` became optional for the status `200`
  - the request optional property `created_at` became read-only
  - the request optional property `updated_at` became read-only
  - …8 more
- **2025-07-04** `52cf706a43db` — 2 info
  - added the new optional request property `metadata`
  - added the optional property `metadata` to the response with the `200` status
- **2025-04-29** `f9c4a6a3fe7d` — 2 breaking, 2 warning, 4 info
  - the response property `endpoint_id` became nullable for the status `200`
  - the response property `endpoint_id` became optional for the status `200`
  - removed the request property `config/key`
  - removed the optional property `config/key` from the response with the `200` status
  - …4 more
- **2024-09-24** `ae3acfa4f278` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/webhookx-io/apis/webhookx-admin-api/changes/workspaces/:ws_id/plugins/post.md)

---

[API](https://skmtc.dev/webhookx-io/apis/webhookx-admin-api.md) · [All operations](https://skmtc.dev/webhookx-io/apis/webhookx-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/webhookx-io/webhookx-admin-api/revisions/0afb563ce365/schema)