Ordinal Agency API

Programmatically manage multiple workspaces with the Agency API

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

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

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