Skip to main content
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.
1

Generate a Company API Key

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

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"
    }
  ]
}
3

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

FeatureAgency APIWorkspace API
ScopeAll workspaces in your companySingle workspace
Key prefixord_c_*ord_*
Create workspacesYesNo
Manage workspace API keysYesNo
Access posts and profilesNo (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