# Events

The Events API endpoints are the lowest-level way to send Events to Honeycomb. **This should be your last resort!**



If unsure where to start when instrumenting an application, read about how to [Send Data to Honeycomb](https://docs.honeycomb.io/send-data/).


If you are building a tracing or metrics library, we recommend using [OpenTelemetry](https://docs.honeycomb.io/send-data/opentelemetry/).



## Create Events

 - [POST /1/batch/{datasetSlug}](https://api-docs.honeycomb.io/api/events/createevents.md): Supports batch creation of events.

Dataset names are case insensitive.  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.


## Create an Event

 - [POST /1/events/{datasetSlug}](https://api-docs.honeycomb.io/api/events/createevent.md): Using this endpoint for anything more than testing is highly discouraged.

Sending events in batches will be much more efficient and should be preferred if at all possible.