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

# Push Event

> Push linked events

<Note>
  ⚠️ Important: Always sync [Schema](/reference/cli-schema-push) changes before pushing Events.
  If the schema referenced in an event is not available in the target workspace, it will result in validation errors during sync.
</Note>

Push event-to-schema mappings from a local `event_schema_mapping.json` file to a workspace. Reads the mapping file from the specified directory.

## Syntax

```bash theme={"system"}
suprsend event push [flags]
```

## Flags

| Flag                | Description                                                                                    | Default            |
| ------------------- | ---------------------------------------------------------------------------------------------- | ------------------ |
| `-h, --help`        | Show help for the command                                                                      | –                  |
| `-d, --dir string`  | Directory containing event files                                                               | `./suprsend/event` |
| `-j, --json string` | Events payload as a JSON object with an `"events"` array, matching the format produced by pull | –                  |

## Example

```bash theme={"system"}
# Push events from default directory
suprsend event push

# Push events from custom directory
suprsend event push --dir events

# Push events to production workspace
suprsend event push --workspace production

# Push events inline via JSON
suprsend event push --json '{"events":[{"name":"user_signed_up","description":"Triggered when user signs up"}]}'
```