Create a playbook

curl --request POST \
  --url https://api.reply.io/v3/ai-sdr/playbooks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Outbound playbook v2",
  "description": "Tone and pacing for cold outreach",
  "body": "## Voice\nFriendly, concise, never desperate.\n\n## Pacing\nTwo touches per week max.",
  "type": "team"
}
'

import requests

url = "https://api.reply.io/v3/ai-sdr/playbooks"

payload = {
    "name": "Outbound playbook v2",
    "description": "Tone and pacing for cold outreach",
    "body": "## Voice
Friendly, concise, never desperate.

## Pacing
Two touches per week max.",
    "type": "team"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Outbound playbook v2',
    description: 'Tone and pacing for cold outreach',
    body: JSON.stringify('## Voice\nFriendly, concise, never desperate.\n\n## Pacing\nTwo touches per week max.'),
    type: 'team'
  })
};

fetch('https://api.reply.io/v3/ai-sdr/playbooks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.reply.io/v3/ai-sdr/playbooks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Outbound playbook v2',
    'description' => 'Tone and pacing for cold outreach',
    'body' => '## Voice
Friendly, concise, never desperate.

## Pacing
Two touches per week max.',
    'type' => 'team'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.reply.io/v3/ai-sdr/playbooks"

	payload := strings.NewReader("{\n  \"name\": \"Outbound playbook v2\",\n  \"description\": \"Tone and pacing for cold outreach\",\n  \"body\": \"## Voice\\nFriendly, concise, never desperate.\\n\\n## Pacing\\nTwo touches per week max.\",\n  \"type\": \"team\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.reply.io/v3/ai-sdr/playbooks")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Outbound playbook v2\",\n  \"description\": \"Tone and pacing for cold outreach\",\n  \"body\": \"## Voice\\nFriendly, concise, never desperate.\\n\\n## Pacing\\nTwo touches per week max.\",\n  \"type\": \"team\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.reply.io/v3/ai-sdr/playbooks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Outbound playbook v2\",\n  \"description\": \"Tone and pacing for cold outreach\",\n  \"body\": \"## Voice\\nFriendly, concise, never desperate.\\n\\n## Pacing\\nTwo touches per week max.\",\n  \"type\": \"team\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "t-7",
  "name": "Outbound playbook v2",
  "description": "Tone and pacing for cold outreach",
  "body": "## Voice\nFriendly, concise, never desperate.\n\n## Pacing\nTwo touches per week max.",
  "type": "team",
  "lastUpdatedAt": "2026-05-10T14:32:11Z",
  "authorUserId": 4821,
  "styleFiles": [
    {
      "id": 12345,
      "fileName": "tone-guide.pdf"
    }
  ]
}

AI SDR Playbooks

Create a playbook

Requires the ai-sdr:write scope (or a broader one that includes it).

Use this endpoint when you need a new playbook to hold the tone, voice and writing guidance your AI SDR should follow. All four fields are required: name of up to 128 characters, description of up to 1000 characters, body carrying the guidance itself, and type — either organization to share the playbook across your organization or team to keep it to your own team, since global playbooks are Reply-curated and cannot be created here. The description and body fields accept an empty string if you would rather fill them in later, and any template variables used in body must be ones your account recognizes; creating an organization playbook also needs your account to be allowed to create organization playbooks. The created playbook is returned in full with its assigned id, which carries the o- or t- scope prefix. The AI SDR feature must be enabled for your team.

POST

ai-sdr

playbooks

Create a playbook

curl --request POST \
  --url https://api.reply.io/v3/ai-sdr/playbooks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Outbound playbook v2",
  "description": "Tone and pacing for cold outreach",
  "body": "## Voice\nFriendly, concise, never desperate.\n\n## Pacing\nTwo touches per week max.",
  "type": "team"
}
'

import requests

url = "https://api.reply.io/v3/ai-sdr/playbooks"

payload = {
    "name": "Outbound playbook v2",
    "description": "Tone and pacing for cold outreach",
    "body": "## Voice
Friendly, concise, never desperate.

## Pacing
Two touches per week max.",
    "type": "team"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Outbound playbook v2',
    description: 'Tone and pacing for cold outreach',
    body: JSON.stringify('## Voice\nFriendly, concise, never desperate.\n\n## Pacing\nTwo touches per week max.'),
    type: 'team'
  })
};

fetch('https://api.reply.io/v3/ai-sdr/playbooks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.reply.io/v3/ai-sdr/playbooks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Outbound playbook v2',
    'description' => 'Tone and pacing for cold outreach',
    'body' => '## Voice
Friendly, concise, never desperate.

## Pacing
Two touches per week max.',
    'type' => 'team'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.reply.io/v3/ai-sdr/playbooks"

	payload := strings.NewReader("{\n  \"name\": \"Outbound playbook v2\",\n  \"description\": \"Tone and pacing for cold outreach\",\n  \"body\": \"## Voice\\nFriendly, concise, never desperate.\\n\\n## Pacing\\nTwo touches per week max.\",\n  \"type\": \"team\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.reply.io/v3/ai-sdr/playbooks")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Outbound playbook v2\",\n  \"description\": \"Tone and pacing for cold outreach\",\n  \"body\": \"## Voice\\nFriendly, concise, never desperate.\\n\\n## Pacing\\nTwo touches per week max.\",\n  \"type\": \"team\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.reply.io/v3/ai-sdr/playbooks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Outbound playbook v2\",\n  \"description\": \"Tone and pacing for cold outreach\",\n  \"body\": \"## Voice\\nFriendly, concise, never desperate.\\n\\n## Pacing\\nTwo touches per week max.\",\n  \"type\": \"team\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "t-7",
  "name": "Outbound playbook v2",
  "description": "Tone and pacing for cold outreach",
  "body": "## Voice\nFriendly, concise, never desperate.\n\n## Pacing\nTwo touches per week max.",
  "type": "team",
  "lastUpdatedAt": "2026-05-10T14:32:11Z",
  "authorUserId": 4821,
  "styleFiles": [
    {
      "id": 12345,
      "fileName": "tone-guide.pdf"
    }
  ]
}

Authorizations

Authorization

string

header

required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Authorization: Bearer <your-api-key>

Get your API key from the Reply dashboard: Settings → API Key.

Body

application/json

Request body for creating a new playbook.

name

string

required

Display name of the playbook

Required string length: 1 - 128

description

string

required

Short description of the playbook's purpose. Empty string allowed.

Maximum string length: 1000

body

string

required

Full playbook body — typically Markdown or plain text instructions the AI SDR follows when this playbook is applied. Empty string allowed.

type

enum<string>

required

Visibility scope for the new playbook. Only organization and team are accepted — global playbooks are Reply-curated and cannot be created via the API.

Available options:

global,

organization,

team

Response

Playbook created successfully

Detailed representation of a playbook, returned by get/create/update responses.

string

read-only

Composite identifier formatted as {prefix}-{numericId} where the prefix encodes the playbook scope: g for global, o for organization, t for team (e.g. g-1, o-42, t-7).

name

string

Display name of the playbook

description

string

Short description of the playbook's purpose

body

string

Full playbook body — typically Markdown or plain text instructions the AI SDR follows when this playbook is applied.

type

enum<string>

Visibility scope of the playbook. Set on create and immutable thereafter.

Available options:

global,

organization,

team

lastUpdatedAt

string<date-time>

read-only

Timestamp of the last modification

authorUserId

integer | null

read-only

User ID of the playbook author. null for global playbooks and when the original author is no longer a team member.

styleFiles

PlaybookStyleFile · object[]

read-only

Style files attached to the playbook. Managed via the /style-files sub-resource — uploads are immediate, deletes are immediate; the field is read-only on the playbook payload.

Show child attributes

Getting started

For AI agents

API Documentation

Schemas

Webhooks

Machine-readable

Create a playbook

Authorizations

Body

Response