---
title: "Create Events"
method: POST
path: "/1/batch/{datasetSlug}"
tags: ["Events"]
---

# Create Events

`POST /1/batch/{datasetSlug}`

Supports batch creation of events.

Dataset names are case insensitive. `POST` requests to "MyDatasET" will land in the same dataset as "mydataset". Names may contain URL-encoded spaces or other special characters, but not URL-encoded slashes. For example, "My%20Dataset" will show up in the UI as "My Dataset".

The first event received for a dataset determines the casing of the displayed name. All subsequent variations in casing will use the originally specified case.

## Headers

- `Content-Encoding` 'gzip' | 'zstd'

## Request body

- BatchEvent[]
  - `data` Event
  - `time` string — Should be in RFC3339 high precision format (for example, YYYY-MM-DDTHH:MM:SS.mmmZ). May be a Unix epoch (seconds since 1970) with second or greater precision (for example, 1452759330927). Optional. If not set, defaults to the time that the API receives the event.
  - `samplerate` integer — An integer representing the denominator in the fraction 1/n when client-side sampling has been applied. Optional. If not set, defaults to `1`, meaning "not sampled". Refer to [Sampling](https://docs.honeycomb.io/manage-data-volume/sample/sampled-data-in-honeycomb/) for more detail.

## Response `200`

Enqueued for processing

- object[]
  - `status` number
  - `error` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Dropped due to administrative throttling
- `404` — Not Found
- `429` — Dropped due to rate limiting

---

[API](https://skmtc.net/honeycomb/apis/honeycomb-api.md) · [All operations](https://skmtc.net/honeycomb/apis/honeycomb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/honeycomb/honeycomb-api/revisions/117619fac2a5/schema)