# Create a billing meter event

Creates a billing meter event

## Returns

Returns a billing meter event

## Parameters

- `event_name` (string, required)
  The name of the meter event. Corresponds with the `event_name` field on a meter.

- `payload` (object, required)
  The payload of the event. This must contain the fields corresponding to a meter’s `customer_mapping.event_payload_key` (default is `stripe_customer_id`) and `value_settings.event_payload_key` (default is `value`). Read more about the [payload](https://docs.stripe.com/billing/subscriptions/usage-based/recording-usage.md#payload-key-overrides).

- `identifier` (string, optional)
  A unique identifier for the event. If not provided, one will be generated. We recommend using a globally unique identifier for this. We’ll enforce uniqueness within a rolling 24 hour period.

- `timestamp` (timestamp, optional)
  The time of the event. Measured in seconds since the Unix epoch. Must be within the past 35 calendar days or up to 5 minutes in the future. Defaults to current timestamp if not specified.

## Request

```python
client = StripeClient("<<YOUR_SECRET_KEY>>")

meter_event = client.v1.billing.meter_events.create({
  "event_name": "ai_search_api",
  "payload": {"value": "25", "stripe_customer_id": "{{CUSTOMER_ID}}"},
  "identifier": "identifier_123",
})
```

### Response

```json
{
  "object": "billing.meter_event",
  "created": 1704824589,
  "event_name": "ai_search_api",
  "identifier": "identifier_123",
  "livemode": true,
  "payload": {
    "value": "25",
    "stripe_customer_id": "cus_NciAYcXfLnqBoz"
  },
  "timestamp": 1680210639
}
```