Skip to main content
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 signup \
  --email alice@example.com

Flags

FlagDescription
--eventEvent name Required
--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 \
  --event signup \
  --email alice@example.com \
  --props ./event-props.json
Last modified on April 7, 2026