# How do I send KPI events in?

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.

Read online: https://docs.closemagnet.com/articles/questions/how-do-i-send-kpi-events-in