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

# Create a new organization

`POST /orgs/v1/organization`

Creates an organization in the system if it doesn't already exist based on website, custom ID, or LinkedIn URL

## Request body

- RestCreateOrganizationRequest — 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 Example: Openline
  - `relationship` string — Relationship status of the organization Example: customer
  - `website` string — Organization's website URL Example: https://openline.com

## Response `201`

Organization created successfully

- RestCreateOrganizationResponse — The response structure after an organization is successfully created.
  - `id` string — ID is the unique identifier of the created organization Example: 1234567890
  - `message` string — Message provides additional information regarding the creation process Example: Organization created successfully
  - `partialSuccess` boolean — PartialSuccess indicates whether the creation process encountered partial success (e.g., when some fields failed to process) Example: false
  - `status` string — Status indicates the status of the creation process (e.g., "success" or "partial_success") Example: success

## Other responses

- `206` — Partial success - failed to add linkedin url
- `400` — Invalid request body or missing input fields
- `401` — Unauthorized access
- `409` — Conflict - organization already exists
- `500` — Failed to create organization

## Changes

- **2024-09-11** `4bda56020ba6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/customeros/apis/customeros-api/changes/orgs/v1/organization/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.dev/customeros/apis/customeros-api/revisions/4bda56020ba6?raw)