Create template

POST

https://api.talktohumans.app

templates

curl --request POST \
  --url https://api.talktohumans.app/v1/templates \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Event follow-up",
  "type": "message",
  "content": "Hi {{first_name}}, great meeting you at {{event_name}}. Would you be open to a quick call next week?"
}
'

{
  "data": {
    "template": {
      "template_id": "tpl_6f1d2c3a-8b4e-4f5a-9c7d-2e1b0a9f8c7d",
      "name": "Event follow-up",
      "type": "message",
      "scope": "shared",
      "content": "Hi {{first_name}}, great meeting you at {{event_name}}. Would you be open to a quick call next week?",
      "created_at": "2026-06-02T12:00:00Z",
      "updated_at": "2026-06-02T12:00:00Z"
    }
  }
}

Authorizations

Authorization

string

header

required

Pass API key as Authorization: Bearer <api_key>.

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

Show child attributes

Response

Template created.

data

object

required

Show child attributes

curl --request POST \
  --url https://api.talktohumans.app/v1/templates \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Event follow-up",
  "type": "message",
  "content": "Hi {{first_name}}, great meeting you at {{event_name}}. Would you be open to a quick call next week?"
}
'

{
  "data": {
    "template": {
      "template_id": "tpl_6f1d2c3a-8b4e-4f5a-9c7d-2e1b0a9f8c7d",
      "name": "Event follow-up",
      "type": "message",
      "scope": "shared",
      "content": "Hi {{first_name}}, great meeting you at {{event_name}}. Would you be open to a quick call next week?",
      "created_at": "2026-06-02T12:00:00Z",
      "updated_at": "2026-06-02T12:00:00Z"
    }
  }
}

Conversations

Templates

Contacts

Companies

Enrich

Views

Accounts

Activity

Authorizations

Body

Response