# Create Playbook

**POST /v1/admin/orgs/{org_id}/playbooks**




## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Http bearer


## Parameters

### Path parameters

- **org_id** (string)



### Body: application/json (object)

- **playbook_id** (string)
  Partner-chosen identifier, e.g. 'day_0_welcome'

- **name** (string)

- **description** (string | null)

- **goal** (string)
  Declarative business goals, presented to the LLM

- **pre_filter** (object | null)
  Boolean flag gates evaluated cheaply before any AI call. Keys must be registered in PRE_FILTER_FLAGS.

- **audience_description** (string | null)
  Natural language description of the intended audience, evaluated by the LLM.

- **available_channels** (array[string])

- **capabilities_on_send** (array[string])

- **tone_hint** (string | null)

- **must_mention** (array[string] | null)

- **must_not_mention** (array[string] | null)



## Responses
### 201
Successful Response

#### Body: application/json (object)
- **id** (string)

- **org_id** (string)

- **playbook_id** (string)

- **name** (string)

- **description** (string | null)

- **goal** (string)

- **pre_filter** (object | null)

- **audience_description** (string | null)

- **available_channels** (array[string])

- **capabilities_on_send** (array[string])

- **tone_hint** (string | null)

- **must_mention** (array[string] | null)

- **must_not_mention** (array[string] | null)

- **version** (integer)

- **active** (boolean)

- **created_at** (string(date-time))

- **updated_at** (string(date-time))

- **created_by** (string | null)


### 422
Validation Error

#### Body: application/json (object)
- **detail** (array[object])



[Powered by Bump.sh](https://bump.sh)