Skip to main content
POST
Create event trigger

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agent_id
string
required

The ID of the agent to create the event trigger for.

Body

application/json
enabled
boolean
required

Whether the trigger should be active immediately. Set to false to create it in a paused state.

trigger_source
enum<string>
required

The external provider that emits the event. Currently only Procore is supported.

Available options:
procore
trigger_event
string
required

The event that fires the agent, in "ResourceName:eventType" format (e.g. "Tasks:create"). Required even when enabled is false.

Maximum string length: 255
name
string | null

Optional name for the App Event automation.

Maximum string length: 255
description
string | null

Optional description of what the App Event automation does.

Maximum string length: 1000
run_conditions
string | null

Optional natural-language conditions that must hold for the agent to run when the event fires.

Maximum string length: 3000
response_thread
enum<string> | null

Controls how the agent's response conversation is threaded when the trigger fires. create_new_thread_each_time starts a fresh thread for every event; when omitted, responses reuse a single thread.

Available options:
create_new_thread_each_time

Response

Created event trigger

object
enum<string>
required

The object type, always 'event_trigger'.

Available options:
event_trigger
id
string
required

Unique identifier for the event trigger.

enabled
boolean
required

Whether the trigger is active. When false the agent does not run in response to the event until it is re-enabled.

trigger_source
enum<string>
required

The external provider that emits the event. Currently only Procore is supported.

Available options:
procore
trigger_event
string
required

The event that fires the agent, in "ResourceName:eventType" format (e.g. "Tasks:create", "Project Users:update").

name
string | null
required

User-provided name for the App Event automation.

description
string | null
required

User-provided description of what the App Event automation does.

run_conditions
string | null
required

Optional natural-language conditions that must hold for the agent to run when the event fires. When null, the agent runs on every matching event.

response_thread
enum<string> | null
required

Controls how the agent's response conversation is threaded when the trigger fires. create_new_thread_each_time starts a fresh thread for every event; when omitted, responses reuse a single thread.

Available options:
create_new_thread_each_time
created_at
string<date-time>
required

ISO 8601 timestamp of when the event trigger was created.

updated_at
string<date-time>
required

ISO 8601 timestamp of the last modification to the event trigger.

warnings
object[]
required

Non-fatal issues surfaced while wiring up the trigger (e.g. Procore company/project/credential prerequisite gaps). An empty array means the trigger was configured with no issues. Each entry pairs a stable machine-readable code with a human-readable message.