Skip to main content
POST
/
integrations
Create integration
curl --request POST \
  --url https://api.kapso.ai/platform/v1/integrations \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "action_id": "slack-send-message",
  "app_slug": "slack",
  "app_name": "Slack",
  "name": "Notify Sales Channel",
  "configured_props": {
    "channel": "#sales",
    "text": "{{message}}"
  },
  "variable_definitions": {
    "message": "string"
  }
}
'
{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "action_id": "<string>",
    "app_slug": "<string>",
    "enabled": true,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "app_name": "<string>",
    "action_name": "<string>",
    "name": "<string>",
    "metadata": {},
    "configured_props": {},
    "variable_definitions": {},
    "dynamic_props_id": "<string>",
    "pipedream_account": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "pipedream_account_id": "<string>",
      "app_slug": "<string>",
      "healthy": true,
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "app_name": "<string>",
      "account_name": "<string>",
      "user": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "email": "jsmith@example.com",
        "name": "<string>",
        "avatar_url": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "onboarding_status": "<string>"
      },
      "project": {}
    }
  }
}

Authorizations

X-API-Key
string
header
required

Body

application/json
action_id
string
required

Pipedream action ID

app_slug
string
required

App identifier

app_name
string

Human-readable app name

name
string

Custom name for this integration

Maximum string length: 100
configured_props
object

Action configuration values

variable_definitions
object

Variable type definitions

dynamic_props_id
string

Pipedream dynamic props session ID

Response

Integration created

data
object
required