Subscription Components

Bulk Event Ingestion

POST
/events/{api_handle}/bulk.json

Records a collection of events.

Note: this endpoint differs from the standard URL for this API in that events and your site subdomain are included in the path.

A maximum of 1000 events can be published in a single request. A 422 will be returned if this limit is exceeded.

Authorization

BasicAuth
AuthorizationBasic <token>

The username is a Maxio Chargify API key. The password is x.

In: header

Path Parameters

api_handle*string

Identifies the Stream for which the events should be published.

Query Parameters

store_uid?string

If you've attached your own Keen project as an Advanced Billing event data-store, use this parameter to indicate the data-store. This applies to Legacy Metering sites only — it has no effect on Maxio Metering sites.

Request Body

application/json

[index: integer]?

Response Body

curl -X POST "https://example.com/events/string/bulk.json" \  -H "Content-Type: application/json" \  -d '[    {      "chargify": {        "subscription_id": 1,        "timestamp": "2020-02-27T17:45:50-05:00"      },      "messages": 150,      "country": "US",      "customer": {        "name": "John",        "lastName": "Doe",        "address": {          "street": "Maple Street",          "zip": 4888,          "state": "MA"        }      }    }  ]'
Empty