Create signals

POST

https://api.talktohumans.app

signals

Create signals

curl --request POST \
  --url https://api.talktohumans.app/v1/signals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_id": "42",
  "signals": [
    {
      "contact_id": "123",
      "signal_type": "custom:webinar_attended",
      "text": "Attended the pricing webinar",
      "occurred_at": "2026-10-28T17:00:00Z",
      "key": "webinar-2026-10-28:123"
    }
  ]
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    account_id: '42',
    signals: [
      {
        contact_id: '123',
        signal_type: 'custom:webinar_attended',
        text: 'Attended the pricing webinar',
        occurred_at: '2026-10-28T17:00:00Z',
        key: 'webinar-2026-10-28:123'
      }
    ]
  })
};

fetch('https://api.talktohumans.app/v1/signals', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.talktohumans.app/v1/signals"

payload = {
    "account_id": "42",
    "signals": [
        {
            "contact_id": "123",
            "signal_type": "custom:webinar_attended",
            "text": "Attended the pricing webinar",
            "occurred_at": "2026-10-28T17:00:00Z",
            "key": "webinar-2026-10-28:123"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

package main

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

func main() {

	url := "https://api.talktohumans.app/v1/signals"

	payload := strings.NewReader("{\n  \"account_id\": \"42\",\n  \"signals\": [\n    {\n      \"contact_id\": \"123\",\n      \"signal_type\": \"custom:webinar_attended\",\n      \"text\": \"Attended the pricing webinar\",\n      \"occurred_at\": \"2026-10-28T17:00:00Z\",\n      \"key\": \"webinar-2026-10-28:123\"\n    }\n  ]\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))

}

{
  "data": {
    "created": 1,
    "updated": 0,
    "errors": []
  }
}

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

account_id

string

required

LinkedIn account ID returned by GET /v1/accounts.

Pattern: ^[1-9][0-9]*$

signals

object[]

required

Required array length: 1 - 500 elements

Show child attributes

Response

Signals written. Invalid ones are listed in errors and the others are written.

data

object

required

Show child attributes

Create signals

curl --request POST \
  --url https://api.talktohumans.app/v1/signals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_id": "42",
  "signals": [
    {
      "contact_id": "123",
      "signal_type": "custom:webinar_attended",
      "text": "Attended the pricing webinar",
      "occurred_at": "2026-10-28T17:00:00Z",
      "key": "webinar-2026-10-28:123"
    }
  ]
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    account_id: '42',
    signals: [
      {
        contact_id: '123',
        signal_type: 'custom:webinar_attended',
        text: 'Attended the pricing webinar',
        occurred_at: '2026-10-28T17:00:00Z',
        key: 'webinar-2026-10-28:123'
      }
    ]
  })
};

fetch('https://api.talktohumans.app/v1/signals', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.talktohumans.app/v1/signals"

payload = {
    "account_id": "42",
    "signals": [
        {
            "contact_id": "123",
            "signal_type": "custom:webinar_attended",
            "text": "Attended the pricing webinar",
            "occurred_at": "2026-10-28T17:00:00Z",
            "key": "webinar-2026-10-28:123"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

package main

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

func main() {

	url := "https://api.talktohumans.app/v1/signals"

	payload := strings.NewReader("{\n  \"account_id\": \"42\",\n  \"signals\": [\n    {\n      \"contact_id\": \"123\",\n      \"signal_type\": \"custom:webinar_attended\",\n      \"text\": \"Attended the pricing webinar\",\n      \"occurred_at\": \"2026-10-28T17:00:00Z\",\n      \"key\": \"webinar-2026-10-28:123\"\n    }\n  ]\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))

}

{
  "data": {
    "created": 1,
    "updated": 0,
    "errors": []
  }
}

Conversations

Templates

Contacts

Content

Companies

Custom fields

Tags

Enrich

Views

Sequences

Accounts

Activity

Agents

Authorizations

Body

Response