Skip to main content
POST
/
api
/
integrations
Create Integration
curl --request POST \
  --url https://api.example.com/api/integrations \
  --header 'Content-Type: application/json' \
  --data '
{
  "providerCode": "<string>",
  "name": "<string>",
  "agentId": "<string>",
  "credentials": {},
  "config": {}
}
'
{
  "id": "<string>",
  "message": "<string>"
}

​
Description

Create a new integration.

​
Authentication

Required (API key or JWT token)

​
Request Body

​
providerCode
string
required
Integration provider code (e.g., “notion”, “slack”)
​
name
string
required
Integration name
​
agentId
string
Optional agent ID to link integration
​
credentials
object
required
Integration credentials (OAuth tokens, API keys, etc.)
​
config
object
Integration configuration

​
Response

​
id
string
Created integration ID
​
message
string
Success message