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

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:

```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](https://loops.so/docs/events/properties.md) |
| `--contact-props` | Path to a JSON file of [contact properties](https://loops.so/docs/contacts/properties.md) |
| `--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](https://loops.so/docs/events/properties.md) 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
```


## Related topics

- [Event properties](https://loops.so/docs/events/properties.md)
- [Send an event](https://loops.so/docs/api-reference/send-event.md)
- [Event patterns](https://loops.so/docs/cli/event-patterns.md)
- [List event patterns](https://loops.so/docs/api-reference/list-event-patterns.md)
- [Events API examples](https://loops.so/docs/api-reference/examples/events.md)