Building on Oyapost

Public API

The JSON API lives under /api/v1/agent. Create a key in Settings, then Agents, and send it as Authorization: Bearer oyp_...

Create a key

The full key is shown once. The same key works for the API, the OpenAPI file, and MCP. You can also send it as the header X-Api-Key.

List accounts, then create a post

Call GET https://oyapost.com/api/v1/agent/integrations and use the integration_id values in the post.

POST https://oyapost.com/api/v1/agent/posts
Authorization: Bearer oyp_...

{
  "caption": "Posting from the API",
  "integration_ids": [12],
  "scheduled_at": "2026-09-29T15:00:00Z",
  "timezone": "Africa/Lagos"
}

Omit scheduled_at and set status to immediate to publish on the next cycle. draft saves the post without publishing. Instagram, TikTok, and Pinterest need media that is already uploaded.

Every field

Captions, media, boards, subreddits, repeats, and invites are described on the reference:

https://oyapost.com/api/v1/agent/docs