Ingest events

1 min

POST

https://app.amberflo.io/ingest

Ingests meter usage events for processing and aggregation. Send a single event object or an array of events for batch processing.

Required fields per event:

meterApiName: Must match an existing meter's API name
customerId: Identifier for the customer generating usage
meterTimeInMillis: Event timestamp in Unix milliseconds
meterValue: Usage amount (numeric value)

Optional fields:

dimensions: Key-value pairs for event categorization and filtering
uniqueId: Custom identifier for event deduplication

Events are validated against existing meters and customer records. Invalid events are rejected with detailed error messages.

bodyarrayMessage structure for ingesting meter usage events with flexible value and variant support

200Successful request

curl --request POST \
     --url https://app.amberflo.io/ingest \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '[
     {
     "meterTimeInMillis": 0
     }
     ]'