Skip to main content
POST

Authorizations

Authorization
string
header
required

Pass Authorization: Bearer <credential>, where the credential is either:

  • an API key (sk_…), generated by an organization admin in Settings, for scripts and automation;
  • an access token from tth auth login (the TalkToHumans CLI), which any member of the workspace can use.

Both resolve to the same organization and user. A login token acts in the user's workspace: one with no workspace yet returns 403 workspace_setup_required, and one in several workspaces returns 403 forbidden (use an API key instead).

Body

application/json
name
string
required

Template name shown in TalkToHumans.

Required string length: 1 - 200
type
enum<string>
required
Available options:
message,
sequence
scope
enum<string>
default:shared

shared for the whole workspace, or personal for the API key's or MCP user's own templates.

Available options:
shared,
personal
content
string

Plain-text message. Required for message templates and not allowed for sequence templates. Use contact and company variables such as {{first_name}} or {{company_name}}, or your own {{key}} variables filled when drafting.

Minimum string length: 1
steps
object[]

Ordered steps. Required for sequence templates and not allowed for message templates.

Minimum array length: 1

Response

Template created.

data
object
required