Create Custom Integration
custom-integrations
Create Custom Integration
Create a new custom integration instance.
Configuration Options:
env_vars: Key-value pairs for environment variablessecrets: List of secret names to resolve from vaultfiles: List of files to create in workspacecontext_prompt: Contextual guidance for AI agentsconnection_test: Optional command to test connectivity
Name Requirements:
- Must be unique within the organization
- Cannot be empty
- Alphanumeric and hyphens recommended
Example Request:
{
"name": "production-postgres",
"integration_type": "postgres",
"description": "Production PostgreSQL database",
"config": {
"env_vars": {
"DB_HOST": "postgres.prod.example.com",
"DB_PORT": "5432",
"DB_NAME": "production"
},
"secrets": ["DB_PASSWORD"],
"files": [
{
"path": "~/.postgresql/client.crt",
"secret_ref": "POSTGRES_CLIENT_CERT",
"mode": "0600"
}
],
"context_prompt": "Production database - use connection pooling"
},
"tags": ["production", "database"]
}
POST
Create Custom Integration
Documentation Index
Fetch the complete documentation index at: https://docs.kubiya.ai/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Enter your Kubiya API token (format: Bearer )
Body
application/json
Request to create a custom integration
Integration name
Required string length:
1 - 255Integration type
Required string length:
1 - 100Integration 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
Tags
Response
Integration created successfully
Custom integration response