---
title: "Create playbook"
method: POST
path: "/v1/playbooks"
tags: ["Playbooks"]
---

# Create playbook

`POST /v1/playbooks`

Create a new team playbook. Requires ManageOrgPlaybooks permission.

## Request body

- CreatePlaybookRequest — Request body for creating or updating a playbook
  - `title` string, required — The title of the playbook
  - `body` string, required — The content/instructions of the playbook
  - `macro` string, nullable — Optional macro shortcut for the playbook (e.g., !deploy)

## Response `200`

Playbook created successfully

- PlaybookResponse — Response object for playbook operations
  - `playbook_id` string — Unique identifier for the playbook
  - `title` string — The title of the playbook
  - `body` string — The content/instructions of the playbook
  - `status` string — Status of the playbook (published, deleted, etc.)
  - `access_type` string — Access level of the playbook (team, community, etc.)
  - `org_id` string — Organization ID that owns the playbook
  - `created_at` string, date-time — When the playbook was created
  - `updated_at` string, date-time — When the playbook was last updated
  - `created_by_user_id` string, nullable — ID of the user who created the playbook
  - `created_by_user_name` string, nullable — Name of the user who created the playbook
  - `updated_by_user_id` string, nullable — ID of the user who last updated the playbook
  - `updated_by_user_name` string, nullable — Name of the user who last updated the playbook
  - `macro` string, nullable — Optional macro shortcut for the playbook

## Other responses

- `400` — Bad Request
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - User does not have permission to access the resource

---

[API](https://skmtc.net/devin/apis/devin-external-api.md) · [All operations](https://skmtc.net/devin/apis/devin-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/devin/devin-external-api/versions/bb0fabac5cbe/schema)