Project API

Events API

Track customer behavior to drive automations and segments.

Project key. Acts in the project the key belongs to. An all-access key works too — name the project with an X-Project-Id header. How keys and scopes work.

Endpoint

POST/v1/events

Track behavior to power automations and segments. Identify the contact by email (auto-created if unknown) or contact_id.

Track an event

Body parameters

eventstringrequired

Event name, e.g. Purchased. Stored with a normalized key.

emailstringoptional

Identify the contact by email (auto-created if unknown).

contact_idstringoptional

Identify the contact by id instead of email.

propertiesobjectoptional

Arbitrary metadata (product_id, category, …).

valuenumberoptional

Monetary value for revenue tracking.

currencystringoptional

ISO currency code for value, e.g. usd.

quantityintegeroptional

Item quantity for the event (e.g. units purchased).

occurred_atstringoptional

ISO 8601 timestamp of when the event happened. Defaults to now.

Provide either email or contact_id.

cURL

curl -X POST https://emailbump.com/api/v1/events \
  -H "Authorization: Bearer ebk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "event": "Purchased",
    "value": 49.0,
    "currency": "usd",
    "properties": { "product": "Widget" }
  }'