---
title: Sending custom events
description: Send custom events from Python applications to Honeybadger Insights for monitoring and analysis.
url: https://docs.honeybadger.io/lib/python/insights/sending-custom-events/
---

Use `honeybadger.event` method to send custom events to [Honeybadger Insights](https://docs.honeybadger.io/guides/insights/). This allows you to track and monitor important events in your application. (For the events the package captures on its own, see [Automatic instrumentation](https://docs.honeybadger.io/lib/python/insights/automatic-instrumentation/).)

```python
from honeybadger import honeybadger


# Send a simple event
honeybadger.event('user.signup', {'email': 'user@example.com'})


# Send an event with additional metadata
honeybadger.event(
    'order.completed',
    {
        'order_id': '123',
        'total': 49.99,
        'items': ['item1', 'item2']
    }
)


# Or pass everything as a dictionary
honeybadger.event({
    'event_type': 'order.completed',
    'order_id': '123',
    'total': 49.99,
    'items': ['item1', 'item2']
})
```

The `event` method can be called in two ways:

* With two parameters: `event_type` (string) and `data` (dictionary)
* With one parameter: a dictionary containing `event_type` and any additional data

We recommend `event_type` for grouping your events. A `ts` timestamp is automatically added to events if not present, using the current UTC time in ISO 8601 format.

For more information about configuring Insights and events, see [Insights Configuration](https://docs.honeybadger.io/lib/python/reference/configuration/#insights-configuration).

---

## Try Honeybadger for FREE

Intelligent logging, error tracking, and Just Enough APM™ in one dev-friendly platform. Find and fix problems before users notice.

[Start free trial](https://app.honeybadger.io/users/sign_up)

[See plans and pricing](https://www.honeybadger.io/plans/)