---
title: "Webhook trigger"
method: POST
path: "/api/trigger/{source}/{triggerId}"
tags: ["Agent Triggers"]
---

# Webhook trigger

`POST /api/trigger/{source}/{triggerId}`

## Request

- Base URL: `https://app.cotool.ai`
- URL: `https://app.cotool.ai/api/trigger/{source}/{triggerId}`
- Auth: HTTP bearer

Invoke an agent trigger via incoming webhook. External services post to this endpoint.

## Path parameters

- `source` 'jira' | 'jira-automation' | 'slack' | 'linear' | 'webhook' | 'bugcrowd' | 'hackerone' | 'zscaler' | 'darktrace' | 'seon', required: Source system sending the webhook (jira, jira-automation, slack, linear, webhook, bugcrowd, hackerone, zscaler, darktrace, seon)
- `triggerId` string, uuid, required: Unique identifier of the trigger to invoke

## Request body

- unknown

## Response `200`

Successful response

- union: Response from webhook trigger containing execution ID, skip message, or error message
  - object: Response from webhook trigger containing execution ID. Use this to retrieve the execution status of the agent.
    - `executionId` string, required: Unique identifier for the agent execution
  - object: Response from webhook trigger containing execution ID, skip message, or error message
    - `executionId` 'skipped', required: Indicates the webhook was skipped
    - `message` string, required: Reason why the webhook was skipped
    - `action` string, required: The action that caused the webhook to be skipped
  - object: Response from webhook trigger containing error message
    - `error` string, required: Error message if webhook processing failed

## Other responses

- `400`: Bad request — input validation failed or the request was malformed
- `500`: Internal server error

---

[API](https://skmtc.dev/cotool/apis/cotool-api.md) - [All operations](https://skmtc.dev/cotool/apis/cotool-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cotool/apis/cotool-api/revisions/f5abe0add203?raw)