Skip to main content
PATCH
Update Automation

Autorisationer

Authorization
string
header
påkrævet

An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Scopes

automation:write

Overskrifter

Api-Version-Date
string

Pins the request to a dated API version.

Eksempel:

"2026-11-17"

Sti-parametre

id
string
påkrævet

Automation ID, prefixed ato_.

Krop

application/json
name
string

The automation's name, shown on the dashboard. Up to 255 characters.

Eksempel:

"Still running"

secrets
object

Secrets to set, by name, merged into the automation's: a name set to null is removed. Step code reads them as environment variables, and no endpoint returns their values. Names are uppercase letters, digits and underscores, starting with a letter, up to 64 characters. Up to 50 secrets, each up to 4 KB.

Eksempel:
status
enum<string>

active enrolls members and runs their steps. closed stops new enrollments and lets members already in it finish. stopped stops new enrollments and ends every member's enrollment. active and closed need a published version.

Tilgængelige muligheder:
active,
closed,
stopped
Eksempel:

"stopped"

trigger_event
enum<string> | null

The webhook event that enrolls the member it's about, such as payment.succeeded. null for an automation that only POST /automations/{id}/trigger enrolls into. Fixed once the automation has been published.

Tilgængelige muligheder:
payment.succeeded,
payment.failed,
membership.activated,
membership.trial_ending_soon,
member.created,
invoice.created,
invoice.paid,
invoice.past_due,
refund.created,
dispute.created,
resolution_center_case.created,
resolution_center_case.decided,
course_lesson_interaction.completed,
null
Eksempel:

"payment.succeeded"

Svar

Automation updated

account_id
string
påkrævet

ID of the account the automation belongs to, prefixed biz_.

Eksempel:

"biz_xxxxxxxxxxxxxx"

active_enrollments_count
integer
påkrævet

Members currently in the automation.

Eksempel:

0

created_at
string
påkrævet

When the automation was created, as an ISO 8601 timestamp.

Eksempel:

"2026-01-01T12:00:00.000Z"

created_by_actor
object
påkrævet

Who created the automation.

draft_version
integer
påkrævet

The version that step edits change. Always published_version plus one, or 1 before the first publish.

Eksempel:

2

has_unpublished_changes
boolean
påkrævet

Whether the draft has edits that POST /automations/{id}/publish would publish. Always true before the first publish.

Eksempel:

false

id
string
påkrævet

Automation ID, prefixed ato_.

Eksempel:

"ato_xxxxxxxxxxxxxx"

name
string
påkrævet

The automation's name, shown on the dashboard. Up to 255 characters.

Eksempel:

"After an order"

published_at
string | null
påkrævet

When the automation was last published, as an ISO 8601 timestamp. null until its first publish.

Eksempel:

"2026-01-01T12:00:00.000Z"

published_by_actor
object | null
påkrævet

Who last published the automation. null until its first publish.

published_version
integer | null
påkrævet

The version new members start on. null until the automation is first published.

Eksempel:

1

secret_names
string[]
påkrævet

Names of the automation's secrets, which its steps' code reads as environment variables. Their values are never returned.

status
enum<string>
påkrævet

active enrolls members and runs their steps. closed enrolls no one new, and members already in it finish. stopped enrolls no one, and its members' enrollments have ended. A new automation is stopped until its first publish makes it active.

Tilgængelige muligheder:
active,
closed,
stopped
Eksempel:

"active"

total_enrollments_count
integer
påkrævet

How many times members have enrolled in the automation, including enrollments that have ended.

Eksempel:

0

trigger_event
enum<string> | null
påkrævet

The webhook event that enrolls the member it's about, such as payment.succeeded. null for an automation that only POST /automations/{id}/trigger enrolls into. Fixed once the automation has been published.

Tilgængelige muligheder:
payment.succeeded,
payment.failed,
membership.activated,
membership.trial_ending_soon,
member.created,
invoice.created,
invoice.paid,
invoice.past_due,
refund.created,
dispute.created,
resolution_center_case.created,
resolution_center_case.decided,
course_lesson_interaction.completed,
null
Eksempel:

"payment.succeeded"

updated_at
string
påkrævet

When the automation was last updated, as an ISO 8601 timestamp.

Eksempel:

"2026-01-01T12:00:00.000Z"