> ## 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](/docs/events/properties)     |
| `--contact-props`   | Path to a JSON file of [contact properties](/docs/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](/docs/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
```


## Related topics

- [Event properties](/docs/events/properties.md)
- [Send an event](/docs/api-reference/send-event.md)
- [List event patterns](/docs/api-reference/list-event-patterns.md)
- [Events API examples](/docs/api-reference/examples/events.md)
- [Get an event pattern by name](/docs/api-reference/get-event-pattern-by-name.md)