> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Events

> Name facts from your system and trigger journeys when they happen.

<Tip>
  **Event** = fact **name** (`order.paid`). Your backend **triggers**; **ENABLED** automations with that trigger create **runs**. Not the same as Notifique channel delivery webhooks.
</Tip>

## What is an event?

A **name contract** between your system and automations. You register it (optionally with `schemaJson`), attach automations to `eventName`, and trigger with **Send event**.

## Event × automation webhook × inbound message

|            | **Event (API)** | **HTTP webhook**         | **Inbound message**      |
| ---------- | --------------- | ------------------------ | ------------------------ |
| Who starts | Your backend    | External system (POST)   | Customer on channel      |
| Config     | Name + schema   | URL/secret on automation | Inbound trigger in graph |
| Data       | JSON `payload`  | POST body                | Message text/media       |

This page focuses on **API events**. Other triggers are set in the automation **editor**.

## Register

```json theme={null}
{
  "name": "order.paid",
  "schemaJson": {
    "orderId": "string",
    "total": "number"
  }
}
```

Scope: **`events:write`**. Routes in **Automations and events** spec.

## Trigger

```json theme={null}
{
  "event": "order.paid",
  "email": "customer@example.com",
  "payload": {
    "orderId": "ORD-99",
    "total": 150.0
  }
}
```

* Recipient: `contactId`, `email`, or `phone`
* **`Idempotency-Key`** header recommended
* Response: list of `runs` (one per linked automation)

## Best practices

* Stable names: `order.paid`, `user_created`
* Small payload (IDs, amounts, dates)
* One trigger can start **several** automations, plan volume and credits

## Scopes

| Action                              | Scope          |
| ----------------------------------- | -------------- |
| List / get                          | `events:read`  |
| Create, update, delete, **trigger** | `events:write` |

## Next steps

* [Quick Start](/en/automations-api/como-funciona/quick-start)
* [Introduction](/en/automations-api/como-funciona/introducao)
* [Scopes](/en/automations-api/como-funciona/escopos-da-api-key)