Create Provider Integration

{
  "providerCode": "SLACK",
  "name": "provider-integrations-name",
  "configuration": {
    "botAuthToken": "your-auth-token",
    "appId": "your-app-id"
  },
  "isPrimary": false
}

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "providerCode": "SLACK",
  "name": "provider-integrations-name",
  "status": "ACTIVE",
  "configuration": {
    "botAuthToken": "your-auth-token",
    "appId": "your-app-id"
  },
  "isPrimary": false,
  "createdAt": "2025-07-29T12:00:00Z",
  "updatedAt": "2025-07-29T12:00:00Z"
}

POST

api

public

provider-integrations

{
  "providerCode": "SLACK",
  "name": "provider-integrations-name",
  "configuration": {
    "botAuthToken": "your-auth-token",
    "appId": "your-app-id"
  },
  "isPrimary": false
}

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "providerCode": "SLACK",
  "name": "provider-integrations-name",
  "status": "ACTIVE",
  "configuration": {
    "botAuthToken": "your-auth-token",
    "appId": "your-app-id"
  },
  "isPrimary": false,
  "createdAt": "2025-07-29T12:00:00Z",
  "updatedAt": "2025-07-29T12:00:00Z"
}

string

required

string

required

Request Body

string

required

string

required

object

required

Request Example

{
  "providerCode": "SLACK",
  "name": "provider-integrations-name",
  "configuration": {
    "botAuthToken": "your-auth-token",
    "appId": "your-app-id"
  },
  "isPrimary": false
}

Response

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "providerCode": "SLACK",
  "name": "provider-integrations-name",
  "status": "ACTIVE",
  "configuration": {
    "botAuthToken": "your-auth-token",
    "appId": "your-app-id"
  },
  "isPrimary": false,
  "createdAt": "2025-07-29T12:00:00Z",
  "updatedAt": "2025-07-29T12:00:00Z"
}

Status Codes

201 - Created: Provider integration created successfully
400 - Bad Request: Invalid input data
401 - Unauthorized: Invalid or missing authentication
409 - Conflict: Provider integration with this name already exists
500 - Internal Server Error: Failed to create provider integration

cURL Example

curl --location 'https://api.trysiren.io/api/v1/public/provider-integrations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bd9d07a8073a41eca003e5f0a841db7c' \
--data '{
  "providerCode": "SLACK",
  "name": "provider-integrations-name",
  "configuration": {
    "botAuthToken": "your-auth-token",
    "appId": "your-app-id"
  },
  "isPrimary": false
}'

Delete Template Update Provider Integration

User Management

Workflow APIs

Chat Node APIs (Beta)

Template APIs

Provider APIs

Webhook APIs

Messaging APIs

Create Provider Integration

Header

Request Body

Request Example

Response

Status Codes

cURL Example

​Header

​Request Body

​

​Request Example

​Response

​Status Codes

​cURL Example

Header

Request Body

Request Example

Response

Status Codes

cURL Example