MetorialDocs

Provider Triggers

A provider trigger describes an event source a provider can emit for callbacks. Use triggers to discover which callback subscriptions a provider version supports.

The Provider Trigger object

provider_trigger.json
{
  "object": "provider.capabilities.trigger",
  "id": "ptr_4nOpQrStUvWxYzAb",
  "key": "messages.created",
  "name": "Messages Created",
  "description": "Fires whenever a new message is created in the provider",
  "input_schema": {
    "type": "json_schema",
    "schema": {}
  },
  "output_schema": {
    "type": "json_schema",
    "schema": {}
  },
  "invocation": {
    "type": "polling",
    "interval_seconds": 60
  },
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "provider_specification_id": "psp_9gHjKlMnPqRsTuVw",
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z"
}
object"provider.capabilities.trigger"required
idstringrequired
keystringrequired
namestringrequired
descriptionstringrequirednullable
provider_idstringrequired
provider_specification_idstringrequired
created_atdaterequired
updated_atdaterequired

Endpoints

List provider triggers

GET/provider-triggers

Returns a paginated list of provider triggers for a specific provider version.

Query parameters

provider_version_idstringrequired

Provider version to list triggers for

Example request

curl -X GET "https://api.metorial.com/provider-triggers" \
  -H "Authorization: Bearer metorial_sk_io2h4..."

Get provider trigger

GET/provider-triggers/:provider_trigger_id

Retrieves a specific provider trigger by ID.

Path parameters

provider_trigger_idstringrequired

The unique identifier for the provider_trigger

Example request

curl -X GET "https://api.metorial.com/provider-triggers/pro_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_io2h4..."