curl --request POST \
  --url https://api.useautumn.com/v1/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "customer_id": "john-123",
  "feature_id": "user-login"
}'

This endpoint is for sending usage events to Autumn, required for tracking your usage-based features.

If the customer_id you send doesn’t already exist, Autumn will automatically create a new customer. You can optionally set the properties of this new customer through the customer_data field.

Authorizations

​
Authorization
string
header
required

Your secret key must be used as the Bearer token for this endpoint.

Body

application/json
Event to send
​
feature_id
string
required

ID of the feature to track usage for.

​
customer_id
string
required

ID which you provided when creating the customer

​
value
integer
default:1

How much of the event should be counted towards the balance. Default is 1.

​
event_name
string

For use in place of the feature_id. This should be used if multiple features are tracked in the same event.

​
idempotency_key
string

Unique identifier for the event. If the same event is sent multiple times, it will be ignored.

​
properties
object

Event properties.

​
customer_data
object

Properties to create a new customer. If a customer with the provided customer_id already exists, this object is ignored. Alternatively, use the /customers endpoint.

Response

200

Event sent