Endpoint: v1/events
Send an event to trigger automation workflows. Events are matched against workflow triggers based on the event name and optional conditions.
Deduplication:
Workflows have deduplication enabled by default with a 5-minute window. If the same event for the same email is sent within this time window, the duplicate event will be ignored and return a deduplicated status response. This prevents accidentally triggering the same workflow multiple times for the same user.
You can configure deduplication settings when creating workflows in the dashboard (up to 30 days maximum window).
API key with format "Bearer {your-api-key}"
Name of the event to trigger.
100"user_signed_up"
Event properties used for workflow condition matching and email personalization.
Workflow Conditions: Properties enable dynamic workflow branching based on condition rules. Each property can be evaluated using:
equals, not_equals, greater_than, less_thancontains, not_contains, begins_with, ends_withexists, not_existsMultiple rules can be combined with AND/OR logic for complex conditions.
Supported Types:
"pro", "landing_page"99.99, 1true, false["item1", "item2"]Nested Properties:
Use dot notation to access nested values (e.g., "user.profile.tier").
Example Use Case: Send different welcome emails based on subscription plan:
plan equals "pro" → send premium welcome emailplan equals "free" → send standard welcome email{
"plan": "pro",
"signup_source": "landing_page"
}Event successfully processed or deduplicated