# Create Events

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.


Endpoint: POST /1/batch/{datasetSlug}
Version: 1.0.0
Security: configuration_key, ingest_key

## Path parameters:

  - `datasetSlug` (string, required)
    The dataset slug.

## Header parameters:

  - `Content-Encoding` (string)
    Included when sending events in a file. Size limitations may be addressed by compressing request bodies with gzip or zstd compression. Be sure to set the Content-Encoding to  or  when compressing the request body. If sending plaintext, omit this header; "plaintext" is included to simplify the example with curl.
    Enum: "gzip", "zstd"

## Request fields (application/json):

  - `data` (object)

  - `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 , meaning "not sampled". Refer to [Sampling](https://docs.honeycomb.io/manage-data-volume/sample/sampled-data-in-honeycomb/) for more detail.

## Response 200 fields (application/json):

  - `status` (number)

  - `error` (string)

## Response 400 fields (application/json):

  - `error` (string)

## Response 401 fields (application/json):

  - `error` (string)

## Response 403 fields (application/json):

  - `error` (string)

## Response 404 fields (application/json):

  - `error` (string)

## Response 429 fields (application/json):

  - `error` (string)