MITPO AssistantDevelopers

API Reference

Complete documentation for the MITPO Universal API

Base URL

https://api.mitpo.io

Campaigns

Campaigns are MITPO's primary execution surface. Create, update, and manage multi-channel launches, then monitor the resulting dispatches, failures, and provider responses from one system.

POST/v1/campaigns

Create a new campaign launch. The API returns execution metadata you can monitor through dispatches, webhooks, and usage tracking.

Request
curl -X POST https://api.mitpo.io/v1/campaigns \
  -H "Authorization: Bearer mk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "meta_ads",
    "campaign": {
      "name": "Summer Launch 2026",
      "objective": "conversion",
      "budget": {
        "amount_micros": 5000000000,
        "currency": "USD",
        "type": "daily"
      }
    }
  }'
Response 200
{
  "success": true,
  "data": {
    "id": "cmp_f7k2a9m1x3",
    "dispatch_id": "dsp_a1b2c3d4e5f6",
    "status": "accepted",
    "channel": "meta_ads",
    "environment": "live",
    "credits_charged": 1
  },
  "request_id": "req_8f3k2m1n..."
}
GET/v1/campaigns/:id

Retrieve full details for a specific campaign including its dispatches.

Request
curl https://api.mitpo.io/v1/campaigns/cmp_f7k2a9m1x3 \
  -H "Authorization: Bearer mk_live_..."
Response 200
{
  "success": true,
  "data": {
    "id": "cmp_f7k2a9m1x3",
    "name": "Summer Launch 2026",
    "channel": "meta_ads",
    "objective": "conversion",
    "status": "active",
    "budget": {
      "amount_micros": 5000000000,
      "currency": "USD",
      "type": "daily"
    },
    "dispatches": [
      {
        "id": "dsp_a1b2c3d4e5f6",
        "status": "completed",
        "provider_resource_id": "23851234567890"
      }
    ],
    "created_at": "2026-03-22T10:00:00Z",
    "updated_at": "2026-03-22T10:05:00Z"
  },
  "request_id": "req_5h2j4k6l..."
}
PATCH/v1/campaigns/:id

Update a campaign. Only include the fields you want to change.

Request
curl -X PATCH https://api.mitpo.io/v1/campaigns/cmp_f7k2a9m1x3 \
  -H "Authorization: Bearer mk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "campaign": {
      "name": "Summer Launch 2026 - Updated",
      "budget": {
        "amount_micros": 7500000000,
        "currency": "USD",
        "type": "daily"
      }
    }
  }'
Response 200
{
  "success": true,
  "data": {
    "id": "cmp_f7k2a9m1x3",
    "name": "Summer Launch 2026 - Updated",
    "status": "active",
    "updated_at": "2026-03-22T12:30:00Z"
  },
  "request_id": "req_7m3n5p8q..."
}
DELETE/v1/campaigns/:id

Delete a campaign. Active dispatches will be cancelled.

Request
curl -X DELETE https://api.mitpo.io/v1/campaigns/cmp_f7k2a9m1x3 \
  -H "Authorization: Bearer mk_live_..."
Response 200
{
  "success": true,
  "data": {
    "id": "cmp_f7k2a9m1x3",
    "deleted": true
  },
  "request_id": "req_2a9b4c7d..."
}

Ready to automate campaign operations?

Get an API keyTry the Playground