Skip to main content
POST
Create Enterprise Playbook
Playbooks are moving to Skills. In an account that has moved, this request writes the playbook’s skill instead: a create adds a skill, an update changes it, a delete removes it. Create and edit skills on the Customize page. New accounts will start with Skills and have no Playbooks, from October 24, 2026. See Playbooks are moving to Skills.
Requires an enterprise admin personal API key. Create a new playbook. The playbook will be associated with your account and enterprise. Use macros to create quick shortcuts (e.g., !deploy).

Authorizations

Authorization
string
header
required

Personal API Key (apk_user_*) for Enterprise Admins only

Body

application/json
body
string
required
Minimum string length: 1
title
string
required
Minimum string length: 1
macro
string | null

Response

Successful Response

access
string
required
account_id
string
required
body
string
required
created_at
string<date-time> | null
required
created_by_user_id
string | null
required
created_by_user_name
string | null
required
playbook_id
string
required
status
string
required
title
string
required
updated_at
string<date-time> | null
required
updated_by_user_id
string | null
required
updated_by_user_name
string | null
required
macro
string | null