Skip to main content
POST
Create 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.
Create a new team playbook. Requires ManageOrgPlaybooks permission.

Authorizations

Authorization
string
header
required

Personal API Key (apk_user_*) or Service API Key (apk_*)

Body

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

Response

Successful Response

access_type
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
org_id
string
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