Inside Ad API Documentation V2 (AI-Optimized)
API by Inside · rest
AI-ready OpenAPI specifications for V2 endpoints. AI agents (recommended): authenticate via OAuth 2.0 (Authorization Code + PKCE, dynamic client registration — no manual key). Send Authorization: Bearer <access_token>; the userId is derived from the token, so the userId query param is not required. See /auth.md for the full flow, or use the MCP server at /api/mcp. Humans/scripts: supply a manual apiKey in the authorization header. Format: token <apiKey>.
Verification: observed. Source: crawl.
Capabilities (50)
- Create a campaign and generate ad assets from a landing-page URL on behalf of…
- Get ONE of the authenticated user's campaigns by campaignId — its ads as FULL…
- List the authenticated user's advertising campaigns (ads).
- Update fields for one or more ads targeted by campaignId.
- Add a new advertising channel for the authenticated user by URL/link.
- Get ONE of the authenticated user's channels by ID (same object shape as…
- Get the full list of the authenticated user's channels (same data/format as…
- Creates AND (optionally) publishes a post to one of the user's own connected…
- Creates a new draft content item (a post) for a platform channel — the…
- Deletes (soft-removes) an existing not-yet-published post.
- Synchronously generates a draft caption + image for a channel (nothing is…
- Polls the status of a job started by "generate_caption".
- Starts asynchronous AI caption generation for a post.
- Polls the status of a job started by "generate_image".
- Starts asynchronous AI image generation for a post.
- Bulk-generates and schedules a batch of AI-written "account" posts (captions +…
- Polls the status of a job started by "generate_video".
- Starts asynchronous AI video generation for a post (image-to-video; generates…
- Polls the status of a job started by "start_initial_post".
- Starts asynchronous generation of the first ("welcome") post for a newly…
- Publishes an existing "account" post (created via create_post/create_content)…
- Reschedules an existing post to a new date/time or auto-slot.
- Bulk-marks a list of draft posts (by id) as "scheduled"/ready.
- Telegram-only maintenance operation: migrates content rows from a positive…
- Updates an existing not-yet-published post: caption schedule status …