---
title: "Create a new organization"
method: POST
path: "/customerbase/v1/organizations"
tags: ["CustomerBASE API"]
---

# Create a new organization

`POST /customerbase/v1/organizations`

Creates an organization if it doesn't exist based on website, custom ID, or LinkedIn URL. Returns existing organization if found.

## Request body

- CustomerbaseCreateOrganizationRequest — Request to create an organization
  - `customId` string — Custom ID provided by the user example: 12345
  - `icpFit` boolean — Indicates if the organization is an ICP (Ideal Customer Profile) fit example: true
  - `leadSource` string — Lead source of the organization example: Web Search
  - `linkedinUrl` string — Organization's LinkedIn profile URL example: https://linkedin.com/company/openline
  - `name` string — Organization's name required: true example: CustomerOS
  - `relationship` string — Relationship status of the organization example: customer
  - `website` string — Organization's website URL example: https://customeros.ai

## Response `201`

Organization created successfully

- CustomerbaseOrganizationResponse — Response structure for single organization operations
  - `organization` CustomerbaseOrganizationRecord — Detailed organization information returned by API operations
    - `cosId` string — CustomerOS unique identifier example: C-A12-B45
    - `customId` string — Custom ID provided by the user example: 12345
    - `domains` string[] — Associated domains example: ["customeros.com","customeros.ai"]
    - `externalLinks` CustomerbaseExternalLink[] — External system links
      - `id` string — External system identifier example: cos-12345
      - `name` string — External system name example: stripe
      - `primary` boolean — Indicates if this is the primary link example: true
    - `icpFit` boolean — ICP fit indicator example: true
    - `id` string — Organization's unique identifier example: 123e4567-e89b-12d3-a456-426614174000
    - `leadSource` string — Lead source of the organization example: Web Search
    - `name` string — Organization name example: CustomerOS
    - `relationship` string — Relationship status with the organization example: customer
    - `stage` string — Current stage in the organization lifecycle example: lead
    - `website` string — Organization's website URL example: https://customeros.ai
  - `requestId` string
  - `status` string — Status indicates the result of the operation ("success" or "error")

## Other responses

- `206` — Organization created with partial data
- `400` — Invalid request - Missing required fields
- `401` — Unauthorized - Invalid or missing API key
- `409` — Conflict - Organization already exists with provided identifiers
- `500` — Internal server error

## Changes

- **2024-09-27** `0a093cd43811` — 1 info
  - endpoint added
- **2024-09-10** `1ee4ed170cfa` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/customeros/apis/customeros-api/changes/customerbase/v1/organizations/post.md)

---

[API](https://skmtc.dev/customeros/apis/customeros-api.md) · [All operations](https://skmtc.dev/customeros/apis/customeros-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customeros/customeros-api/revisions/73526747b270/schema)