Skip to main content

​
Build Social Workflows With Ocoya

Create API key Ocoya is a social media content, scheduling, and automation platform. The REST API lets you manage workspace data, connected social profiles, posts, and workflows from your own backend services. Ocoya also provides an MCP server so AI clients can work with the same workspace and publishing tools through OAuth-approved access.

​
What You Can Build

Create draft posts, attach media, select connected social profiles, and schedule content from your own app or automation.
List workspaces, resolve workspace IDs, and inspect connected social profiles before creating posts.
List workflows, inspect workflow steps, and toggle automations on or off from external systems.
Connect Claude, Codex, ChatGPT, and other MCP-compatible clients to help create posts and operate workspace workflows.

​
REST API Flow

1

Create an API key

Generate an API key from Ocoya settings and keep it server-side.
2

Resolve workspace context

Call /me and /workspaces, then choose the workspace you want to operate on.
3

Find social profiles

Use /social-profiles with a workspaceId to find the profile IDs that posts should target.
4

Create or manage posts

Create drafts, schedule posts, list existing posts, update schedules, or delete posts.

​
Where To Go Next

How to use

Learn the typical REST API setup flow and make your first request.

Authentication

See how API keys are sent and how to keep them safe.

MCP

Connect AI tools to Ocoya with the Model Context Protocol.

API reference

Browse generated endpoint reference pages from the OpenAPI spec.