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

# Send Trigger Event

> Process a trigger event for a partnership to initiate campaign reward evaluation

> [!NOTE]
>
> The `x-api-key` header value to be used on this API is your **partner API key**, which can be generated through the dashboard.

**partnership\_id** `string` *required*

The unique identifier of the partnership associated with this trigger event.

**trigger\_name** `string` *required*

The name of the trigger event to process. This identifies the type of event being triggered (e.g., 'user\_signup', 'transaction\_completed'). Trigger name can be found in the triggers section of the Pilot dashboard.

**external\_user\_id** `string`

Your external identifier of the user. Used to map the event to a specific user in the Benji platform.

**user\_uuid** `string`

The unique Benji identifier of the user associated with this trigger event.

**transaction\_context** `object`

Additional context data about the transaction that triggered this event. Contains partner-specific information about the transaction details as configured on the trigger in the triggers section on Pilot.

### Response

**trigger\_event\_id** `string` *required*

The UUID of the trigger event. This is the preferred identifier for referencing the trigger event.

```json 200 theme={null}
{
    "code": "ok",
    "data": {
        "trigger_event_id": "f0f8ae48-f005-471c-9a15-ec53c207218c"
    }
}
```

```json 400 theme={null}
{
  "code": "invalid_token",
  "message": "Invalid token"
}
```

```json 401 theme={null}
{
  "code": "unauthorized_request",
  "message": "Token is not authorized to make this request"
}
```

```json 404 theme={null}
{
  "code": "partnership_does_not_exist",
  "message": "The partnership does not exist"
}
```

> [!TIP]
>
> Trigger events are used to activate campaign flows and generate rewards for users. Make sure the trigger is configured in your partnership settings before sending events.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.