Ordinal Agency API - Ordinal Docs

Looking for the Workspace API?This is the Agency API for managing multiple workspaces at the company level. If you want to create posts, manage profiles, or access workspace-specific resources, see the Workspace API instead.

Overview

The Ordinal Agency API allows agencies and teams to programmatically manage multiple workspaces from a single company account. With company-level API access, you can create new workspaces, manage workspace API keys, and automate your multi-client workflows.

Base URL

https://app.tryordinal.com/api/v1/company

Use Cases

The Agency API is designed for:

Agencies managing social media for multiple clients, each with their own workspace
Enterprises with multiple brands or business units
Platforms building integrations that provision Ordinal workspaces for their users

Quick Start

Enterprise Plan RequiredThe Agency API requires an Enterprise plan. Contact sales to upgrade your account.

Generate a Company API Key

Navigate to your company settings and create a new company API key. See the Authentication guide for details.

Make Your First Request

Use the company API key as a Bearer token to authenticate your requests:

curl -X GET "https://app.tryordinal.com/api/v1/company/workspaces" \
  -H "Authorization: Bearer ord_c_XXXXXXXXXXXXXXXX"

Confirm that you see your workspaces in the response.

{
  "workspaces": [
    {
      "id": "workspace-uuid-1",
      "name": "Client A",
      "slug": "client-a",
      "timezone": "America/New_York",
      "createdAt": "2025-01-01T00:00:00.000Z"
    },
    {
      "id": "workspace-uuid-2",
      "name": "Client B",
      "slug": "client-b",
      "timezone": "Europe/London",
      "createdAt": "2025-02-01T00:00:00.000Z"
    }
  ]
}

Explore Endpoints

Browse the endpoint documentation to discover all available operations for managing workspaces and API keys.

Available Operations

List Workspaces

List all workspaces in your company

Create Workspace

Create a new workspace for a client

Get Workspace

Retrieve details of a specific workspace

Manage API Keys

Create and list workspace API keys programmatically

Agency API vs Workspace API

Feature	Agency API	Workspace API
Scope	All workspaces in your company	Single workspace
Key prefix	`ord_c_*`	`ord_*`
Create workspaces	Yes	No
Manage workspace API keys	Yes	No
Access posts and profiles	No (use workspace keys)	Yes

Use the Agency API to create workspaces and generate workspace API keys. Then use those workspace API keys with the Workspace API to manage posts, profiles, and other workspace-specific resources.

Rate Limiting

API requests are rate limited to ensure fair usage. The Agency API has a limit of 100 requests per minute per API key.

{
  "code": "TOO_MANY_REQUESTS",
  "message": "Rate limit of 100 requests per 60s exceeded. Quota resets in 45 seconds"
}

If you need a higher rate limit, please reach out to support.

Need Help?

Authentication

Learn how to authenticate your Agency API requests

Error Handling

Understand API error responses

​Overview

Base URL

​Use Cases

​Quick Start

​Available Operations

List Workspaces

Create Workspace

Get Workspace

Manage API Keys

​Agency API vs Workspace API

​Rate Limiting

​Need Help?

Authentication

Error Handling

Overview

Use Cases

Quick Start

Available Operations

Agency API vs Workspace API

Rate Limiting

Need Help?