Campaign Actions (Developer Guide)

BODY='{"linkedinUrl":"https://www.linkedin.com/in/jane-doe","context":"Booked for Nov 14","eventId":"evt_1"}'
TS=$(date +%s)
SIG=$(printf '%s.%s' "$TS" "$BODY" | openssl dgst -sha256 -hmac "$KAKIYO_ACTION_SECRET" -hex | sed 's/^.* //')

curl -X POST "https://api.kakiyo.com/webhooks/actions/$ACTION_ID" \
  -H 'Content-Type: application/json' \
  -H "X-Kakiyo-Timestamp: $TS" \
  -H "X-Kakiyo-Signature: sha256=$SIG" \
  --data "$BODY"

import crypto from 'node:crypto';

const body = JSON.stringify({
  linkedinUrl: 'https://www.linkedin.com/in/jane-doe',
  context: 'Booked a call for Nov 14 at 3pm',
  eventId: 'booking_8231',
});
const timestamp = Math.floor(Date.now() / 1000).toString();
const signature = crypto
  .createHmac('sha256', process.env.KAKIYO_ACTION_SECRET)
  .update(`${timestamp}.${body}`)
  .digest('hex');

const res = await fetch(`https://api.kakiyo.com/webhooks/actions/${process.env.ACTION_ID}`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Kakiyo-Timestamp': timestamp,
    'X-Kakiyo-Signature': `sha256=${signature}`,
  },
  body, // send exactly the string you signed
});
console.log(res.status, await res.json());

import hashlib, hmac, json, os, time, requests

body = json.dumps({
    "linkedinUrl": "https://www.linkedin.com/in/jane-doe",
    "context": "Booked a call for Nov 14 at 3pm",
    "eventId": "booking_8231",
}, separators=(",", ":"))
timestamp = str(int(time.time()))
signature = hmac.new(
    os.environ["KAKIYO_ACTION_SECRET"].encode(),
    f"{timestamp}.{body}".encode(),
    hashlib.sha256,
).hexdigest()

res = requests.post(
    f"https://api.kakiyo.com/webhooks/actions/{os.environ['ACTION_ID']}",
    data=body,
    headers={
        "Content-Type": "application/json",
        "X-Kakiyo-Timestamp": timestamp,
        "X-Kakiyo-Signature": f"sha256={signature}",
    },
)
print(res.status_code, res.json())

{
  "ok": true,
  "status": "recorded",
  "data": {
    "action": { "id": "act_qT-UXFITFYRGe1R17W8Tq_qz", "name": "Booked a call" },
    "campaignId": "6a8f…",
    "chatId": "6af5…",
    "prospectId": "6a90…",
    "matchedBy": ["linkedinUrl"],
    "completion": {
      "count": 1,
      "context": "Booked a call for Nov 14 at 3pm",
      "firstCompletedAt": "2026-11-12T10:30:00.000Z",
      "lastCompletedAt": "2026-11-12T10:30:00.000Z"
    }
  },
  "requestId": "6af5cfb6002489d2c956"
}

{
  "ok": false,
  "error": {
    "code": "validation_failed",
    "message": "The request body is not valid",
    "details": [
      { "field": "linkedinUrl", "message": "must be a LinkedIn profile URL like https://www.linkedin.com/in/jane-doe" }
    ]
  },
  "requestId": "6af5cfb600259316bd06"
}