Make your first API request.
PulseFlow exposes a REST API for creating events, executing workflows, inspecting runs and managing resources programmatically.
curl https://api.pulseflow.ai/v1/health \
-H "Authorization: Bearer pf_live_your_key"
Secure every request.
Authenticate requests using a PulseFlow secret key in the Authorization header.
Authorization: Bearer pf_live_****************
Use server-side environment variables or your organization's secret manager.
Events API
Create an event and route it into a configured workflow.
/v1/events
Create an execution event
curl -X POST https://api.pulseflow.ai/v1/events \
-H "Authorization: Bearer pf_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"workflow_id": "wf_customer_intent",
"event": "customer.message",
"payload": {
"customer_id": "cus_82391",
"message": "I need help with my account"
}
}'
Response
{
"id": "exec_01J9X2K9",
"status": "queued",
"workflow_id": "wf_customer_intent",
"created_at": "2026-09-09T08:42:11Z"
}
Listen for workflow events.
Webhooks allow your infrastructure to receive execution state changes from PulseFlow.
Predictable error handling.
400Invalid request parameters401Authentication failed403Insufficient permissions404Resource not found429Rate limit exceeded500Internal server errorUse your preferred language.
Built for high-volume workloads.
Standard API access uses burst-aware rate limiting. Enterprise deployments can be configured around workload-specific requirements.