Facebook-HubSpot Ad Tracking Integration

I need a clean, reliable bridge between Facebook’s Marketing API and my HubSpot account so every lead and sale that comes from a Facebook or Instagram campaign shows up in HubSpot with its full ad performance data attached. The goal is simple: when a contact is created or updated in HubSpot, I should instantly see which campaign, ad set, creative, and cost per result influenced that action.

Core scope
• Authenticate to both platforms securely (OAuth 2.0).
• Pull campaign-level, ad-set-level, and ad-level metrics from Facebook in near-real-time.
• Map those metrics to the correct HubSpot objects (contacts, deals, custom properties).
• Write a sync routine that runs automatically on a schedule I can adjust.
• Provide a lightweight dashboard or custom report inside HubSpot so I can filter and segment by ROAS, cost per lead, and conversion value.

Nice-to-have flexibility
While the immediate priority is tracking ad performance, the structure should leave room for future extensions like post scheduling or auto-responses without needing a full re-write.

Acceptance
• A Git repo with well-documented code (language is your choice, but Node.js or Python preferred).
• One-click deploy instructions (Heroku, AWS Lambda, or similar).
• Proof of data flowing: a sample Facebook campaign populating test contacts in my HubSpot sandbox with matched spend, impressions, and clicks.
• Error handling and simple logging so I can audit failed syncs.

If you’ve handled Facebook Marketing API rate limits and HubSpot custom property mapping before, this should be straightforward. I’m ready to give access tokens and a sandbox portal as soon as we agree on the structure.