API Reference

Complete documentation for the MITPO Universal API

Base URL

https://api.mitpo.io

Channel Guide

The channel parameter tells MITPO which execution rail to target. Each channel has its own capabilities, validation rules, and required connected account before live dispatch can proceed.

Channel valuePlatform
meta_adsMeta Ads (Facebook/Instagram)
google_adsGoogle Ads
linkedin_adsLinkedIn Ads
social_publishTwitter/X, LinkedIn, Instagram

Meta Ads — meta_ads

Creates campaigns on Facebook and Instagram. Requires a Meta Business account connected via OAuth. Campaign results are reflected via the dispatch status webhook.

Meta Ads campaign example
{
  "channel": "meta_ads",
  "campaign": {
    "name": "Summer Sale",
    "objective": "conversion",
    "budget": { "amount_micros": 5000000000, "currency": "USD", "type": "daily" },
    "targeting": { "age_min": 25, "age_max": 45, "geo": ["US"] }
  }
}

Google Ads — google_ads

Creates Search, Display, or Performance Max campaigns on Google Ads. Reuses your existing Google OAuth credentials — no separate app registration needed.

Google Ads campaign example
{
  "channel": "google_ads",
  "campaign": {
    "name": "Brand Search Q2",
    "objective": "traffic",
    "budget": { "amount_micros": 3000000000, "currency": "USD", "type": "daily" },
    "keywords": ["marketing api", "campaign automation"]
  }
}

LinkedIn Ads — linkedin_ads

Creates Sponsored Content or Lead Gen campaigns on LinkedIn. Requires a LinkedIn Company Page and Campaign Manager access via OAuth.

LinkedIn Ads campaign example
{
  "channel": "linkedin_ads",
  "campaign": {
    "name": "B2B Lead Gen Q2",
    "objective": "lead_gen",
    "budget": { "amount_micros": 2000000000, "currency": "USD", "type": "daily" },
    "targeting": { "job_titles": ["Marketing Manager", "CMO"], "geo": ["US", "GB"] }
  }
}

Ready to automate campaign operations?