ghl_ad_fb_campaign_reporting_get
Retrieve Facebook campaign reporting for a date window by merging stored campaign data, Meta insights, and CDP-attributed contacts; use it to compare campaign metrics for published campaigns.
Instructions
Get campaign reporting
Retrieve reporting for one campaign as a flat object, not the { grouped, totals } envelope the account-level report uses. Merges the locally stored campaign, Meta insights for the window, and CDP-attributed contacts. The campaign must be published — one without an fbCampaignId is rejected. Note results.lead (Meta lead actions) and leads (CDP attributed contacts) measure different things and routinely disagree.
Endpoint: GET /ad-publishing/facebook/reporting/campaign/{campaignId} (Version header: v3; source: v3/ad-publishing-v3.json)
OAuth scopes: adPublishing.readonly
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"campaignId": "<campaignId>",
"locationId": "<locationId>",
"startDate": "<startDate>",
"endDate": "<endDate>"
},
"name": "ghl_ad_fb_campaign_reporting_get"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| endDate | Yes | Report end date (YYYY-MM-DD) | |
| startDate | Yes | Report start date (YYYY-MM-DD) | |
| campaignId | Yes | Campaign identifier | |
| locationId | Yes | Location identifier |