Automations
POST
Publish Automation
POST /v1/automations/{automationId}/publishPublish an automation to make it active and start processing triggers.
Use Cases:
- Activate a draft automation after configuration
- Go live with a new email workflow
- Re-publish an updated automation version
Behavior:
- Performs strict validation of the automation workflow
- Validates trigger configuration, node data, and flow structure
- Sets automation status to PUBLISHED
- Records publishedAt timestamp
- Automation begins processing matching triggers immediately
- Creates a new version if publishing an update to an existing automation
Required Scope: write:automations
Validation at Publish Time:
The following are validated strictly (unlike save, which is lenient):
- Trigger type is valid and configured
- All nodes have valid type and required data
- Flow structure is valid (connected graph, no orphan nodes)
- Email nodes have subject and content
- Delay nodes have valid durations
- Condition nodes have valid rules
Prerequisites:
- Automation must be in DRAFT status
- Must have a valid trigger configured
- Must pass all validation checks
Note: Publishing is immediate. The automation will start processing events as soon as it is published.
Path parameters
automationIdstringrequiredAutomation ID to publish
Response
200Automation published successfully. It is now active and processing triggers.
objectstringrequiredidstringrequirednamestringrequireddescriptionanyrequiredstatus"DRAFT" | "PUBLISHED" | "ARCHIVED"requiredversionnumberrequiredparentIdanyrequiredtriggerobjectrequirednodesany[]requirededgesany[]requiredstatsanyrequiredpublishedAtanyrequiredcreatedAtstringrequiredupdatedAtstringrequired