How do I send KPI events in?
Download MarkdownPOST them to https://app.closemagnet.com/api/connector/kpi with two headers. Authorization: Bearer carries a scoped API credential with the kpi:write scope, which the account owner creates on the API tab of Settings. x-kpi-type na
POST them to https://app.closemagnet.com/api/connector/kpi with two headers. Authorization: Bearer carries a scoped API credential with the kpi:write scope, which the account owner creates on the API tab of Settings. x-kpi-type names the event. The Record KPI events card on the owner-only Webhooks tab shows the full example.
x-kpi-type has to be one of new_seller_lead, pass_off, process_call, dial, call_connected, call_disposition, touch, or quality_touch. Anything else is refused with a 400 bad_request. The body carries only the contact context, and fields outside the known set are never read.
A duplicate is not an error. It answers 200 with recorded set to false and the reason duplicate, so a workflow that fires the same event twice neither double-counts nor fails.
Links to the app require your CloseMagnet login.
Related Articles
- What can the CloseMagnet API do?It reads almost everything in your account, and what it writes is deliberately narrow. Its endpoints span 17 domains and the large majority are read-only. The ones that write do one of these things:
- How do I create an API credential?Only the account owner can mint one, and it happens at Settings -> API.
- What is the difference between my account API token and a scoped credential?Your account API token was minted automatically when the account was created. It sits pinned as the first row in Settings -> API with the type "Automatic", carries a fixed set of scopes, can be revealed again at any time, and can
- How do I rotate or revoke a credential?It depends which kind you have, and only the account owner can do either one.