Max Playbooks

Create a Max playbook

Changed on

Creates a playbook. Chat playbooks describe a workflow Max should follow when asked; auto-drafting playbooks shape the email replies Max writes for you. Requires a USER API key.

post/public/v1/max/playbooks

Request

Request body

namestring required
descriptionstring
type'AUTO_DRAFTING' | 'MAIN_AGENT' required
instructionsstring required
toolsstring[]
visibility'PRIVATE' | 'ACCOUNT'
assignToMyMaxAgentboolean
isActiveboolean
integrationsstring[]
appliesToAllAccountsboolean nullable
connectedAccountIdsinteger[]

Example request

{
  "name": "example",
  "description": "example",
  "type": "AUTO_DRAFTING",
  "instructions": "example value",
  "tools": [
    "example"
  ],
  "visibility": "PRIVATE",
  "integrations": [
    "GMAIL"
  ],
  "selectedRecordTypes": [
    {
      "recordTypeId": 1
    }
  ],
  "selectedCustomTools": [
    {
      "id": 1
    }
  ],
  "connectedAccountIds": [
    1
  ]
}

Response

Playbook created

oktrue required

Example response

{
  "ok": true,
  "data": {
    "id": 1,
    "name": "example",
    "description": "example",
    "type": "AUTO_DRAFTING",
    "instructions": "example",
    "tools": [
      "example"
    ],
    "attachments": [
      {
        "id": 1,
        "name": "example",
        "description": "example",
        "fileUrl": "example",
        "mimeType": "example",
        "fileSize": 1,
        "createdAt": "example",
        "updatedAt": "example"
      }
    ],
    "accountId": 1,
    "createdByUserId": 1,
    "visibility": "PRIVATE",
    "createdAt": "example",
    "updatedAt": "example",
    "assignedAt": "example",
    "integrations": [
      "GMAIL"
    ],
    "selectedRecordTypes": [
      {
        "recordTypeId": 1
      }
    ],
    "selectedCustomTools": [
      {
        "id": 1
      }
    ],
    "connectedAccounts": [
      {
        "id": 1,
        "toolkit": "example",
        "connectedEmail": "example",
        "alias": "example"
      }
    ]
  }
}

Changes