POST/v1/organizationscontacts:write

Create an organization

Idempotent on `domain` — if the domain already exists, returns the existing row.

Run a request

POST/v1/organizations

Base URL

Request body (JSON)

Resolved URL

POSThttps://coldos.justgotwyrd.com/api/v1/organizations

Paste an API key in the bar at the top of the page to enable Execute.

Parameters

Body parameters

namestringrequired
Display name.
domainstringoptional
Primary domain (no scheme).
industrystringoptional
Free-form industry label.
sizestringoptional
Headcount band, e.g. "51-200".
locationstringoptional
City, country.

Responses

400Invalid request — see `error.message`.
401Missing or invalid API key.
403Authenticated, but the key lacks the required scope.
404The referenced resource does not exist or is not visible to your key.
429Rate limit exceeded — see `Retry-After`.
500Unexpected server error. Safe to retry with idempotency-key.

Code samples

curl -X POST "https://coldos.justgotwyrd.com/api/v1/organizations" \
  -H "Authorization: Bearer $COLD_OS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "name": "Acme Logistics",
      "domain": "acmelogistics.io"
    }'

Response · 200

{
  "id": "9b2e1cd4-3c9b-4a1d-9b2f-21efae55c012",
  "name": "Acme Logistics",
  "domain": "acmelogistics.io",
  "website": "https://acmelogistics.io",
  "industry": "Logistics & Supply Chain",
  "size": "51-200",
  "location": "Bengaluru, IN",
  "linkedin_url": "https://www.linkedin.com/company/acme-logistics",
  "created_at": "2026-04-09T10:01:00.000+05:30"
}

Was this page helpful?

Your vote stays in this browser. We'll use it to prioritise rewrites.