Creating a workspace

A new workspace: its own connected accounts, posts and media library.

POSThttps://antwork.io/api/v1/workspacesScopewrite

Request

curl -X POST https://antwork.io/api/v1/workspaces \
  -H "Authorization: Bearer $ANTWORK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "name": "Acme",
    "website": "acme.com"
  }'

name is required, 1 to 60 characters. website is optional; a bare host like example.com becomes https://example.com. No plan limits how many workspaces you have. Send an Idempotency-Key so a retry cannot create a second one. Needs the write scope.

Response

201 Created

{
  "object": "workspace",
  "id": "ws_...",
  "name": "Acme",
  "website": "https://acme.com/",
  "logoUrl": null,
  "timezone": null,
  "brandVersion": 1,
  "createdAt": "2026-10-22T10:00:00.000Z",
  "updatedAt": "2026-10-22T10:00:00.000Z"
}

A new workspace has no accounts. GET /api/v1/workspaces/{id}/connect-urls returns the links that connect them.

An account under review answers 403 with account_under_review until the review is done.