Docs

Automations

POST

Publish Automation

POST /v1/automations/{automationId}/publish

Publish 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

automationIdstringrequired

Automation ID to publish

Response

200Automation published successfully. It is now active and processing triggers.
objectstringrequired
idstringrequired
namestringrequired
descriptionanyrequired
status"DRAFT" | "PUBLISHED" | "ARCHIVED"required
versionnumberrequired
parentIdanyrequired
triggerobjectrequired
nodesany[]required
edgesany[]required
statsanyrequired
publishedAtanyrequired
createdAtstringrequired
updatedAtstringrequired
Copyright © 2026 Kibamail.·Privacy Policy