POST https://api.usecommune.comautomation.run.completed Production. There is no separate sandbox host.

Automation run completed

A run of one of the newsletter's automations reached the end of its graph. Every step it was going to take has been taken.

A run is one subscriber's passage through one automation, so this fires once per person per entry rather than once per automation. Read GET /runs/{run} for the step history; this message carries the outcome, not the walk.

actor names the run, not a credential. Every automation.run.* message carries actor: {"type": "system", "id": "<run_id>"}, which is the same attribution Commune puts on the events a run's own actions cause, such as the subscriber.tagged of an add_tag step. That is what the loop guard reads: a run started by this message inherits this run's chain plus this run's automation, so an automation triggered by its own runs starts one further run and is then refused. data.chain_depth is how many automations' actions already led here, out of a limit of five.

Delivered as a single HTTPS POST to the consumer's registered endpoint, with the message as the JSON request body. Respond 2xx to acknowledge. Anything else, or a timeout, is retried with backoff, so acknowledge fast and do the work afterwards.

Request Headers

  • string Required
  • string(uuid) Required
  • string Required
  • string Required
  • string(date-time) Required
  • integer

Body

A run reached the end of its graph.

  • string(uuid) Required
  • string Required
  • string Required
  • string(date-time) Required
  • string(uuid) | null Required
  • string | null Required
POST automation.run.completed
Loading...

Share your request

Use this link to easily share a pre-filled request of this operation. Everything you filled will be shared apart from the authentication fields.

Request URL

https://api-reference.usecommune.dev/explorer/operation/operation-onautomationruncompleted

Send a delete request

It looks like you’re about to send a DELETE request to this API. This type of request carries a risk of permanent and irreversible data loss.

Are you sure you want to continue?
Response
Waiting for a request to be sent.