Triggers

Get Triggers

get
Authorizations
OAuth2passwordRequired
Token URL:
Path parameters
project_idstringRequired
Responses
200

Successful Response

application/json
get
/projects/{project_id}/triggers
GET /projects/{project_id}/triggers HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "project_trigger_id": "123e4567-e89b-12d3-a456-426614174000",
    "project_id": "text",
    "connection_id": "123e4567-e89b-12d3-a456-426614174000",
    "provider_id": "text",
    "trigger_id": "text",
    "webhook_data": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "cursor_data": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "trigger_config": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "status": "DISABLED",
    "created_at": "2025-11-28T01:31:30.449Z",
    "updated_at": "2025-11-28T01:31:30.449Z",
    "created_by": "123e4567-e89b-12d3-a456-426614174000",
    "updated_by": "123e4567-e89b-12d3-a456-426614174000"
  }
]

Create Trigger

post
Authorizations
OAuth2passwordRequired
Token URL:
Path parameters
project_idstringRequired
Body

A domain model representing a request to create a new Trigger.

provider_idstringRequired
trigger_idstringRequired
connection_idany ofOptional
string · uuidOptional
or
nullOptional
Responses
post
/projects/{project_id}/triggers
POST /projects/{project_id}/triggers HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 160

{
  "provider_id": "text",
  "trigger_id": "text",
  "trigger_config_params": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "connection_id": "123e4567-e89b-12d3-a456-426614174000"
}
{
  "project_trigger_id": "123e4567-e89b-12d3-a456-426614174000",
  "project_id": "text",
  "connection_id": "123e4567-e89b-12d3-a456-426614174000",
  "provider_id": "text",
  "trigger_id": "text",
  "webhook_data": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "cursor_data": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "trigger_config": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "status": "DISABLED",
  "created_at": "2025-11-28T01:31:30.449Z",
  "updated_at": "2025-11-28T01:31:30.449Z",
  "created_by": "123e4567-e89b-12d3-a456-426614174000",
  "updated_by": "123e4567-e89b-12d3-a456-426614174000"
}

Get Trigger

get
Authorizations
OAuth2passwordRequired
Token URL:
Path parameters
project_trigger_idstring · uuidRequired
Responses
200

Successful Response

application/json
get
/triggers/{project_trigger_id}
GET /triggers/{project_trigger_id} HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "project_trigger_id": "123e4567-e89b-12d3-a456-426614174000",
  "project_id": "text",
  "connection_id": "123e4567-e89b-12d3-a456-426614174000",
  "provider_id": "text",
  "trigger_id": "text",
  "webhook_data": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "cursor_data": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "trigger_config": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "status": "DISABLED",
  "created_at": "2025-11-28T01:31:30.449Z",
  "updated_at": "2025-11-28T01:31:30.449Z",
  "created_by": "123e4567-e89b-12d3-a456-426614174000",
  "updated_by": "123e4567-e89b-12d3-a456-426614174000"
}

Delete Trigger

delete
Authorizations
OAuth2passwordRequired
Token URL:
Path parameters
project_trigger_idstring · uuidRequired
Responses
delete
/triggers/{project_trigger_id}
DELETE /triggers/{project_trigger_id} HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Get Triggers By User Org

get
Authorizations
OAuth2passwordRequired
Token URL:
Responses
200

Successful Response

application/json
get
/triggers
GET /triggers HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
200

Successful Response

[
  {
    "project_trigger": {
      "project_trigger_id": "123e4567-e89b-12d3-a456-426614174000",
      "project_id": "text",
      "connection_id": "123e4567-e89b-12d3-a456-426614174000",
      "provider_id": "text",
      "trigger_id": "text",
      "webhook_data": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "cursor_data": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "trigger_config": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "status": "DISABLED",
      "created_at": "2025-11-28T01:31:30.449Z",
      "updated_at": "2025-11-28T01:31:30.449Z",
      "created_by": "123e4567-e89b-12d3-a456-426614174000",
      "updated_by": "123e4567-e89b-12d3-a456-426614174000"
    },
    "project_name": "text"
  }
]

Enable Trigger

post
Authorizations
OAuth2passwordRequired
Token URL:
Path parameters
project_trigger_idstring · uuidRequired
Responses
200

Successful Response

application/json
Responseany
post
/triggers/{project_trigger_id}/enable
POST /triggers/{project_trigger_id}/enable HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Disable Trigger

post
Authorizations
OAuth2passwordRequired
Token URL:
Path parameters
project_trigger_idstring · uuidRequired
Responses
200

Successful Response

application/json
Responseany
post
/triggers/{project_trigger_id}/disable
POST /triggers/{project_trigger_id}/disable HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Get Available Triggers By Provider

get

Get the list of native triggers available and implemented by Stack AI.

Path parameters
provider_idstringRequired
Responses
200

Successful Response

application/json
get
/providers/{provider_id}/triggers
GET /providers/{provider_id}/triggers HTTP/1.1
Host: api.stack-ai.com
Accept: */*

[
  {
    "trigger_type": "POLLING",
    "provider_id": "text",
    "trigger_id": "text",
    "trigger_name": "text",
    "description": "text",
    "instructions": "text",
    "icon": "text",
    "tags": [
      "text"
    ],
    "version": "1.0.0",
    "webhook_requires_verification": false,
    "can_get_test_samples": true
  }
]

Get Specific Trigger From Provider

get

Get the data for a specific native trigger available and implemented by Stack AI.

Path parameters
provider_idstringRequired
trigger_idstringRequired
Responses
200

Successful Response

application/json
get
/providers/{provider_id}/triggers/{trigger_id}
GET /providers/{provider_id}/triggers/{trigger_id} HTTP/1.1
Host: api.stack-ai.com
Accept: */*

{
  "trigger_type": "POLLING",
  "provider_id": "text",
  "trigger_id": "text",
  "trigger_name": "text",
  "description": "text",
  "instructions": "text",
  "icon": "text",
  "tags": [
    "text"
  ],
  "version": "1.0.0",
  "webhook_requires_verification": false,
  "can_get_test_samples": true
}
Deprecated

Webhook Trigger

post
Path parameters
project_trigger_idstring · uuidRequired
api_keystringRequired
org_idstringRequired
Query parameters
trigger_idany ofOptional
stringOptional
or
nullOptional
provider_idany ofOptional
stringOptional
or
nullOptional
Responses
post
/organizations/{org_id}/triggers/{project_trigger_id}/webhook/key/{api_key}
POST /organizations/{org_id}/triggers/{project_trigger_id}/webhook/key/{api_key} HTTP/1.1
Host: api.stack-ai.com
Accept: */*

No content
Deprecated

Polling Trigger

post
Path parameters
project_trigger_idstring · uuidRequired
api_keystringRequired
org_idstringRequired
Responses
post
/organizations/{org_id}/triggers/{project_trigger_id}/polling/key/{api_key}
POST /organizations/{org_id}/triggers/{project_trigger_id}/polling/key/{api_key} HTTP/1.1
Host: api.stack-ai.com
Accept: */*

No content
Deprecated

Scheduled Trigger

post
Path parameters
project_trigger_idstring · uuidRequired
api_keystringRequired
org_idstringRequired
Responses
post
/organizations/{org_id}/triggers/{project_trigger_id}/scheduled/key/{api_key}
POST /organizations/{org_id}/triggers/{project_trigger_id}/scheduled/key/{api_key} HTTP/1.1
Host: api.stack-ai.com
Accept: */*

No content

Webhook Handler

post

Handle webhook requests for all incoming webhook events.

Path parameters
webhook_idstringRequired

Webhook identifier - either an app webhook provider (e.g., 'slack', 'github') or a project trigger UUID

Example: slack
Responses
200

Successful Response

application/json
Responseany
post
/v1/webhooks/{webhook_id}
POST /v1/webhooks/{webhook_id} HTTP/1.1
Host: api.stack-ai.com
Accept: */*

No content

Get Trigger Test Samples

get

Get test samples for a trigger.

Authorizations
OAuth2passwordRequired
Token URL:
Path parameters
project_trigger_idstring · uuidRequired
Responses
200

Successful Response

application/json
get
/api/v0/project-triggers/{project_trigger_id}/test-samples
GET /api/v0/project-triggers/{project_trigger_id}/test-samples HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}
PreviousAnalytics

Last updated

Was this helpful?