POST /v0/events

The Events API is designed to enable streaming ingestion into Tinybird using an easy to use HTTP API that can be called at a high frequency.

Common use cases are:


Send NDJSON data at high frequency to Tinybird.
curl \
-H "Authorization: Bearer <import_token>" \
-d '{"date": "2020-04-05 00:05:38", "city": "Chicago"}' \

Appends data in NDJSON format to a JSON Data Source. If the Data Source doesn’t exist, create it with a guessed schema. Requests to this endpoint are not restricted by regular rate limits.

Requets parameters






name or ID of the target Data Source to append data to it



‘false’ by default. Set to ‘true’ to wait until the write is acknowledged by the database. Enabling this flag makes possible to retry on database errors, but it introduces additional latency. It’s recommended to enable it in use cases in which data loss avoidance is critical. It’s recommended to disable it otherwise.

Return HTTP status codes

Status Code



The data has been inserted into the database. The write has been acknowledged. The request ‘wait’ parameter was enabled.


The data has been processed, and it will be send to the database eventually. The write has not been acknownledged yet. The request ‘wait’ parameter was disabled.


The request is invalid. The body will contain more information. A common cause is missing the ‘name’ parameter. No data has been inserted, but the request shouldn’t be retried.


The token is not valid.


The token’s workspace doesn’t belong to this cluster. The workspace is probably removed or in another cluster


The ingestion has been partially completed due to an error in a Materialized View. Retrying may result in data duplication, but not retrying may result in data loss.


The request/second limit has been reached. Default limit is 1000 requests/second, contact us for increased capacity.


An error has occurred while processing the data. The body will contain more information.


The service is temporarily unavailable. The body will contain more information. A common cause is to have reached a throughput limit, or to have attached a Materialized View with an issue. No data has been inserted, and it’s safe to retry.

Limits and capacity

The Events API is designed to deliver an out of the box capacity of:

  • Up to 1000 requests/second

  • Up to 20MB/s

We support much higher throughputs, but please, contact us for enhanced capacity.

When these limits are reached, we provide a best-effort service. You may experience higher throughputs without errors, but please, contact us at for reserved capacity.