Log Interaction to CRM

POST

competitor-interactions

log-to-crm

curl -X POST https://api.clustr-ai.com/api/public/competitor-interactions/log-to-crm \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actor_linkedin_id": "per_bs9t25pnx8ax5p80ckexz9r35s",
    "target_linkedin_id": "per_pfc2a7z0j6r9sbtedxy7gayf39",
    "post_key": "urn:li:activity:7212345678901234567"
  }'

import requests

requests.post(
    "https://api.clustr-ai.com/api/public/competitor-interactions/log-to-crm",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "actor_linkedin_id": "per_bs9t25pnx8ax5p80ckexz9r35s",
        "target_linkedin_id": "per_pfc2a7z0j6r9sbtedxy7gayf39",
        "post_key": "urn:li:activity:7212345678901234567",
    },
)

await fetch("https://api.clustr-ai.com/api/public/competitor-interactions/log-to-crm", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    actor_linkedin_id: "per_bs9t25pnx8ax5p80ckexz9r35s",
    target_linkedin_id: "per_pfc2a7z0j6r9sbtedxy7gayf39",
    post_key: "urn:li:activity:7212345678901234567",
  }),
});

{
  "success": true,
  "data": { "ok": true, "already_logged": false, "result_id": "note_90210" }
}

{
  "success": false,
  "error": {
    "message": "CRM connection does not permit note creation",
    "code": "FORBIDDEN"
  }
}

{
  "success": false,
  "error": {
    "message": "This account does not resolve to a CRM company",
    "code": "NOT_FOUND"
  }
}

Write one critical competitor interaction onto the matched CRM company as a note, so the signal lands where the deal is worked rather than only in Clustr. It works the same way for HubSpot, Salesforce and Attio, so you do not choose a provider. Clustr composes the note body from the interaction’s stored verdict. Your request picks the interaction, and Clustr writes the text that lands in your system of record. Requires the account to resolve to a CRM company and your CRM connection to permit note creation; both fail as 403. Idempotent: an already-logged interaction returns 200 with already_logged: true rather than writing a second note, because your CRM would otherwise store a duplicate.

curl -X POST https://api.clustr-ai.com/api/public/competitor-interactions/log-to-crm \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actor_linkedin_id": "per_bs9t25pnx8ax5p80ckexz9r35s",
    "target_linkedin_id": "per_pfc2a7z0j6r9sbtedxy7gayf39",
    "post_key": "urn:li:activity:7212345678901234567"
  }'

import requests

requests.post(
    "https://api.clustr-ai.com/api/public/competitor-interactions/log-to-crm",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "actor_linkedin_id": "per_bs9t25pnx8ax5p80ckexz9r35s",
        "target_linkedin_id": "per_pfc2a7z0j6r9sbtedxy7gayf39",
        "post_key": "urn:li:activity:7212345678901234567",
    },
)

await fetch("https://api.clustr-ai.com/api/public/competitor-interactions/log-to-crm", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    actor_linkedin_id: "per_bs9t25pnx8ax5p80ckexz9r35s",
    target_linkedin_id: "per_pfc2a7z0j6r9sbtedxy7gayf39",
    post_key: "urn:li:activity:7212345678901234567",
  }),
});

{
  "success": true,
  "data": { "ok": true, "already_logged": false, "result_id": "note_90210" }
}

{
  "success": false,
  "error": {
    "message": "CRM connection does not permit note creation",
    "code": "FORBIDDEN"
  }
}

{
  "success": false,
  "error": {
    "message": "This account does not resolve to a CRM company",
    "code": "NOT_FOUND"
  }
}

Authorizations

Authorization

string

header

required

The API key you created on the API settings page of the Clustr app.

Body

application/json

actor_linkedin_id

string

required

The Clustr ID (per_…) of the competitor's salesperson. Their LinkedIn id (rep_linkedin_id on the feed entry) also works.

target_linkedin_id

string

required

The engaged person's Clustr ID (per_…). Their LinkedIn id also works.

post_key

string

required

The interaction's post_key.

Response

Note written, or already present

success

boolean

required

Example:

true

data

object

required

curl -X POST https://api.clustr-ai.com/api/public/competitor-interactions/log-to-crm \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actor_linkedin_id": "per_bs9t25pnx8ax5p80ckexz9r35s",
    "target_linkedin_id": "per_pfc2a7z0j6r9sbtedxy7gayf39",
    "post_key": "urn:li:activity:7212345678901234567"
  }'

import requests

requests.post(
    "https://api.clustr-ai.com/api/public/competitor-interactions/log-to-crm",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "actor_linkedin_id": "per_bs9t25pnx8ax5p80ckexz9r35s",
        "target_linkedin_id": "per_pfc2a7z0j6r9sbtedxy7gayf39",
        "post_key": "urn:li:activity:7212345678901234567",
    },
)

await fetch("https://api.clustr-ai.com/api/public/competitor-interactions/log-to-crm", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    actor_linkedin_id: "per_bs9t25pnx8ax5p80ckexz9r35s",
    target_linkedin_id: "per_pfc2a7z0j6r9sbtedxy7gayf39",
    post_key: "urn:li:activity:7212345678901234567",
  }),
});

{
  "success": true,
  "data": { "ok": true, "already_logged": false, "result_id": "note_90210" }
}

{
  "success": false,
  "error": {
    "message": "CRM connection does not permit note creation",
    "code": "FORBIDDEN"
  }
}

{
  "success": false,
  "error": {
    "message": "This account does not resolve to a CRM company",
    "code": "NOT_FOUND"
  }
}

API Reference

Import

Search

Jobs

Network

Opportunities

Owners

Accounts

Account States

Saved Views

Workflows

Intro Requests

Notes

Record Activity

Tags

Target Accounts

Client Companies

Excluded Companies

Buyer Titles

ICP

Competitor Monitoring

Connector Refresh

Notifications

Log Interaction to CRM

Authorizations

Body

Response