Integrations

Integrations connect nambikk.ai to external systems. Each integration can have multiple actions that a capability can call. The LLM never accesses systems directly; the platform executes actions under policy.

Integration Types

Type	Description
rest_api	Standard REST API integration
graphql	GraphQL API integration
webhook	Webhook based integration
composio	Composio connector
mcp	Model Context Protocol connector

Integration Structure

{
  "name": "Orders API",
  "slug": "orders",
  "description": "Integration with order management system",
  "type": "rest_api",
  "config": {
    "base_url": "https://api.example.com/v1",
    "auth_type": "bearer",
    "credentials": {
      "api_key": "your-api-key"
    },
    "default_headers": {
      "Accept": "application/json"
    },
    "test_endpoint": "/health"
  }
}

Auth Types

Supported values for auth_type:

• none
• bearer
• api_key
• basic
• oauth2_client_credentials

Bearer

{
  "auth_type": "bearer",
  "credentials": {"api_key": "your-token"}
}

API Key In Header

{
  "auth_type": "api_key",
  "credentials": {
    "api_key": "your-key",
    "api_key_header": "X-API-Key"
  }
}

Basic

{
  "auth_type": "basic",
  "credentials": {
    "username": "user",
    "password": "pass"
  }
}

OAuth2 Client Credentials

{
  "auth_type": "oauth2_client_credentials",
  "credentials": {
    "client_id": "your-client-id",
    "client_secret": "your-client-secret",
    "token_url": "https://auth.example.com/oauth/token",
    "scope": "read write"
  }
}

Common Config Options

• base_url: base URL for API calls
• default_headers: static headers sent with every request
• test_endpoint: optional endpoint used to verify connectivity
• credentials.custom_headers: additional headers for auth or compliance

Next Step

Define actions inside your integration:

• Actions