Platforms, unified entities, vendor APIs, endpoints and connectors.
ads.lead_formUnifiedSoonAn instant form on Meta or LinkedIn, with the leads it collected.
key platform + form ID3 planned callsNo Direct endpoint yet
Our own first draft of the paths, not reviewed yet. Each call acts on the platforms it lists through the Connection you grant, and none is deployed yet.
/ v1/ ads/ lead-formsThe lead forms of a pageMeta · LinkedInDraft/ v1/ ads/ lead-formsCreate a lead form with its questionsMeta · LinkedInDraft/ v1/ ads/ leadsThe leads a form collectedMeta · LinkedInDraftA first cut of the schema from the ad platforms' own objects. Names, types and coverage can change before the Unified layer ships.
pageAccountReportednamestringReportedquestionsQuestion[]Reportedprivacy_urlstringReportedstatusStatusReportedsubmissionsSubmission[]ReportedEach lead with its answers and timeVendor endpoints that already return this kind of object, in the vendor's own format. Your code names the vendor, so switching vendors means changing it.
No Direct endpoint returns LeadForm yet. It comes with the Unified layer.
Each link is a field you can ask for in the same call.