Skip to main content

Documentation Index

Fetch the complete documentation index at: https://loops.so/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

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

Flags

FlagDescription
--emailContact email address (required if --user-id is not provided)
--user-idContact user ID (required if --email is not provided)
--propsPath to a JSON file of event properties
--contact-propsPath to a JSON file of contact properties
--listMailing list subscription as id=true|false (repeatable)
--idempotency-keyIdempotency key to prevent duplicate sends

Event properties file

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 April 28, 2026