---
title: "The vendor’s call (public)"
method: POST
path: "/v1/source-connections/webhook/{address}"
tags: ["Source Plane"]
---

# The vendor’s call (public)

`POST /v1/source-connections/webhook/{address}`

## Request

- Base URL: `https://brain.inite.ai`
- URL: `https://brain.inite.ai/v1/source-connections/webhook/{address}`
- Auth: none required

Where a CRM calls on change — the address the setup call handed out. Public by construction: the HMAC-signed address names the tenant and the connection, and the call is trusted the vendor’s way (HubSpot v3 signature, Pipedrive basic auth, Bitrix24 `auth[application_token]`, Kommo / custom `?token=` or `X-Brain-Signature`). The events name entity + id (+ deleted); the engine fetches those records through the records door as a queued `source_sync` job (202) — or inline without a queue (200, summary). The webhook never carries data into memory. 404 for an unknown address or a connection whose webhook is off; 401 for a call the scheme rejects. Records (docs/roadmap/crm-sources-2026-09.md): a CRM row enters as FACTS — its mapped attributes become deterministic candidates under the record’s own id, never prose a model re-extracts. Source plane operator surface (docs/roadmap/raw-evidence-sources-2026-09.md) — answers a bare 404 until `SOURCE_PLANE_ENABLED=1`.

## Path parameters

- `address` string, required

## Request body

- object

## Response `200`

Applied inline.

- WebhookReceipt
  - `accepted` integer, required
  - `ignored` integer, required
  - `runId` string, nullable, required
  - `summary` object
    - `closed` integer, required
    - `connectionId` string, required
    - `deduplicated` integer, required
    - `errors` object[], required
      - `error` string, required
      - `externalId` string, required
    - `failed` integer, required
    - `fetched` integer, required
    - `gone` integer, required
    - `ingested` integer, required
    - `received` integer, required

## Other responses

- `202`: Queued.
- `401`: Missing or unknown bearer key.
- `404`: No such resource in this tenant.

---

[API](https://skmtc.dev/inite/apis/inite-brain-platform-api.md) · [All operations](https://skmtc.dev/inite/apis/inite-brain-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inite/apis/inite-brain-platform-api/revisions/c7c3eb5e304b?raw)
