Sign in
Triggers

Create trigger

Create a trigger from a preset and return it with its signing secret.

post/api/triggers

Request body

preset_idstring required

ID of the preset to instantiate.

descriptionstring

Optional note describing this trigger.

inputsobject

Values for the preset's inputs.

Example request

{
  "preset_id": "GITHUB_1",
  "description": "Reviews I am tagged on, sent to my team's review channel",
  "inputs": {
    "repository": "acme/payments-api"
  },
  "delivery": {
    "webhook_url": "https://customer.app/webhook",
    "auth": {
      "secret": "secret_test_123"
    }
  }
}

Response

Trigger created.

request_idstring required

Platform-generated request ID for support correlation.

Example response

{
  "trigger": {
    "trigger_id": "trigger_test_123",
    "preset_id": "GITHUB_1",
    "description": "Reviews I am tagged on, sent to my team's review channel",
    "status": "ENABLED",
    "inputs": {
      "repository": "acme/payments-api"
    },
    "delivery": {
      "webhook_url": "https://customer.app/webhook",
      "auth": {
        "secret": "secret_test_123"
      }
    },
    "signing_secret": "whsec_xxx"
  }
}

Changes