> ## 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.

# Events

> Send events to trigger automations.

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:

```bash theme={"dark"}
loops events send signup \
  --email test@example.com
```

### Flags

| 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](/events/properties)     |
| `--contact-props`   | Path to a JSON file of [contact properties](/contacts/properties) |
| `--list`            | Mailing list subscription as `id=true\|false` (repeatable)        |
| `--idempotency-key` | Idempotency key to prevent duplicate sends                        |

### Event properties file

Use `--props` to attach [event properties](/events/properties) to the event:

```json event-props.json theme={"dark"}
{
  "plan": "Pro",
  "trialDays": 14
}
```

```bash theme={"dark"}
loops events send signup \
  --email test@example.com \
  --props ./event-props.json
```