API Reference

Complete documentation for the MITPO Universal API

Base URL

https://api.mitpo.io

Error Codes

All errors follow a consistent structure. Every response includes a X-Request-Id header for debugging.

Error response format

{
  "error": {
    "code": "validation_error",
    "message": "The 'channels' field is required.",
    "details": { "field": "channels" }
  },
  "request_id": "req_abc123..."
}

Status	Code	Description
400	bad_request	Malformed request body or parameters
401	unauthorized	Missing or invalid API key
402	payment_required	Insufficient credits for this operation
403	forbidden	Key lacks required scope for this endpoint
404	not_found	Resource does not exist
422	validation_error	Request body failed validation
429	rate_limited	Too many requests, retry after reset
500	internal_error	Unexpected server error

Ready to automate campaign operations?

Get an API key Try the Playground