Report a conversion from your server
Reports one real conversion — a lead your own systems already accepted. The browser tracker (one <script> line, see https://serp-agent.com/docs/tracking) can only observe that a form was SENT; a form backend, CRM webhook or booking system knows whether the lead was accepted, which is what makes a server report trustworthy enough to count as a business outcome.
Attribution: the conversion is credited to one article, in this order — articleUrl (explicit), ctaTrackingId, pageUrl, then landingUrl (the page the visit started on, which is what usually names the article). The response says which one was used. A conversion that matches no article is still stored and counted for the project.
Idempotency: pass externalId — your own lead id. A repeat with the same id is ignored and answered 200 with duplicate: true, so retries and webhook redeliveries cannot inflate the numbers.
Never send personal data: no names, emails, phone numbers or message bodies. Only the event type, the pages involved and your own lead id.
Request
- Base URL: https://serp-agent.com
- URL: https://serp-agent.com/v1/projects/{projectId}/conversions
- Auth: HTTP bearer
Path parameters
Project id.
Request body
Response
Already reported under this externalId — nothing was stored a second time.
Changes
No recorded changes to this operation across all 1 revision of this API.