Automations
Track event
Fire a named event for a contact to trigger any active automations that use a Contact Event trigger matching that event name.
- The contact must already exist in the workspace — events for unknown emails are silently dropped.
- If the contact is already enrolled in a matching automation it is silently skipped (deduped).
- Multiple automations can react to the same event name.
Requires automations:trigger scope.
Authorization
bearerAuth AuthorizationBearer <token>
Bearer token authentication. Use a Regular API key for email sending, or an Admin API key for marketing and automation endpoints.
Get your API keys from Settings → API Keys (regular) or Settings → Admin API Keys (admin) in the dashboard.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://api.keplars.com/api/v1/public/automations/events/track" \ -H "Content-Type: application/json" \ -d '{ "email": "[email protected]", "event_name": "pricing_page_visited" }'{
"success": true,
"message": "Success"
}{
"success": false,
"error": "VALIDATION_ERROR",
"message": "Field 'to' is required"
}