Skip to main content
POST
/
api
/
v1
/
custom-integrations
Create Custom Integration
curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/custom-integrations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "config": {
    "context_prompt": "Production database - handle with care",
    "env_vars": {
      "DB_HOST": "postgres.prod.example.com",
      "DB_PORT": "5432"
    },
    "secrets": [
      "DB_PASSWORD"
    ]
  },
  "description": "Production PostgreSQL database",
  "integration_type": "postgres",
  "name": "production-database",
  "tags": [
    "production",
    "database"
  ]
}
'
{
  "id": "<string>",
  "organization_id": "<string>",
  "name": "<string>",
  "integration_type": "<string>",
  "description": "<string>",
  "status": "<string>",
  "config": {},
  "tags": [
    "<string>"
  ],
  "created_at": "<string>",
  "updated_at": "<string>",
  "created_by": "<string>"
}

Authorizations

Authorization
string
header
required

Enter your Kubiya API token (format: Bearer )

Body

application/json

Request to create a custom integration

name
string
required

Integration name

Required string length: 1 - 255
integration_type
string
required

Integration type

Required string length: 1 - 100
config
CustomIntegrationConfig · object
required

Integration configuration

Example:
{
"context_prompt": "Production PostgreSQL database. Use connection pooling.",
"env_vars": {
"DB_HOST": "postgres.prod.example.com",
"DB_NAME": "production",
"DB_PORT": "5432"
},
"files": [
{
"mode": "0600",
"path": "~/.postgresql/client.crt",
"secret_ref": "POSTGRES_CLIENT_CERT"
}
],
"secrets": ["DB_PASSWORD", "DB_SSL_CERT"]
}
description
string | null

Description

tags
string[]

Tags

Response

Integration created successfully

Custom integration response

id
string
required
organization_id
string
required
name
string
required
integration_type
string
required
description
string | null
required
status
string
required
config
Config · object
required
tags
string[]
required
created_at
string
required
updated_at
string
required
created_by
string | null
required