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 brand 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 brand 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 brands, resolve brand 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 brand workflows.

REST API Flow

1

Create an API key

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

Resolve brand context

Call /me and /brands, then choose the brand you want to operate on.
3

Find social profiles

Use /social-profiles with a brandId 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.