# Create an Event

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.


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

## Path parameters:

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

## Header parameters:

  - `X-Honeycomb-Event-Time` (integer)
    The Event's timestamp. Optional. Defaults to server time.

  - `X-Honeycomb-Samplerate` (integer)
    Optional. Defaults to 1.

## 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)