Events

The events command lets you send events to Loops to trigger workflows.

`send`

Send an event for a contact identified by email or user ID.

loops events send <event> [--flags]

Example:

loops events send signup \
  --email test@example.com

Flag	Description
`--email`	Contact email address (required if `--user-id` is not provided)
`--user-id`	Contact user ID (required if `--email` is not provided)
`--props`	Path to a JSON file of event properties
`--contact-props`	Path to a JSON file of contact properties
`--list`	Mailing list subscription as `id=true\|false` (repeatable)
`--idempotency-key`	Idempotency key to prevent duplicate sends

Use --props to attach event properties to the event:

event-props.json

{
  "plan": "Pro",
  "trialDays": 14
}

loops events send signup \
  --email test@example.com \
  --props ./event-props.json

Last modified on September 8, 2026