Events API reference

Emit an app event

events.emitwrite

Fire one of your app's own events into the account. Any automation whose trigger is 'App event' (matched to your app + this event key) runs. Use it to let people build workflows that start when something happens in your app. Needs the events:write scope.

Parameters

Field	Type	Required	Description
key	string	required	Your event key, e.g. 'subscription_renewed'. What workflows match on.
contact_id	string (uuid)	optional	The contact this event is about, so contact-scoped workflows enroll them.
data	map of string → object	optional	Extra event context (available to the workflow). Default: {}

Example

curl -X POST https://app.chirply.io/api/v1/actions/events.emit \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "example"
  }'

Test with your API key

Over MCP the same operation is the tool events_emit at https://app.chirply.io/api/mcp, same bearer token, same input.