---
title: "Create integration"
method: POST
path: "/api/projects/{projectId}/integrations"
tags: ["Integration"]
---

# Create integration

`POST /api/projects/{projectId}/integrations`

Create a new integration within the specified project.

## Path parameters

- `projectId` string, uuid, required

## Request body

- object
  - `name` string, required — Name of the integration
  - `description` string, nullable — Description of the integration
  - `group` string, nullable — Group the integration belongs to
  - `type` 'http', required — Type of integration
  - `kind` string, required — Unique kind identifier (lowercase, alphanumeric with dots and underscores)
  - `config` object, required — HTTP integration configuration
    - `method` 'post' | 'get' | 'delete' | 'put' | 'patch', required — HTTP method for the request
    - `url` string, required — URL endpoint for the HTTP request
    - `timeout` number — Request timeout in milliseconds
    - `output` string, nullable — Output mapping configuration
    - `headers` object[], nullable — HTTP headers to include in the request
      - `key` string, required — Header name
      - `value` string, required — Header value
    - `cookies` object[], nullable — Cookies to include in the request
      - `key` string, required — Cookie name
      - `value` string, required — Cookie value
    - `enableInputs` boolean — Enable custom input fields
    - `inputs` object[], nullable — Custom input field definitions
      - `control` 'text' | 'checkbox', required — Input control type
      - `name` string, required — Input field name
      - `label` string, required — Input field label

## Response `200`

Created integration

- object — Created integration
  - `id` string, uuid, required — Unique identifier of the integration
  - `type` 'http', required — Type of integration
  - `config` object, required — Integration configuration
    - `method` 'post' | 'get' | 'delete' | 'put' | 'patch', required — HTTP method for the request
    - `url` string, required — URL endpoint for the HTTP request
    - `timeout` number, required — Request timeout in milliseconds
    - `output` string, nullable — Output mapping configuration
    - `headers` object[], nullable, required — HTTP headers to include in the request
      - `key` string, required — Header name
      - `value` string, required — Header value
    - `cookies` object[], nullable, required — Cookies to include in the request
      - `key` string, required — Cookie name
      - `value` string, required — Cookie value
    - `enableInputs` boolean, required — Enable custom input fields
    - `inputs` object[], nullable, required — Custom input field definitions
      - `control` 'text' | 'checkbox', required — Input control type
      - `name` string, required — Input field name
      - `label` string, required — Input field label
  - `name` string, required — Name of the integration
  - `description` string, nullable — Description of the integration
  - `group` string, nullable — Group the integration belongs to
  - `kind` string, required — Unique kind identifier for the integration
  - `projectId` string, uuid, required — Project ID the integration belongs to
  - `createdAt` string, required — Timestamp when the integration was created
  - `updatedAt` string, required — Timestamp when the integration was last updated
  - `deletedAt` string, nullable — Timestamp when the integration was deleted

---

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