---
title: "Create Organization"
method: POST
path: "/admin/organizations"
---

# Create Organization

`POST /admin/organizations`

## Request

- Base URL: `https://app.runconverge.com/api`
- URL: `https://app.runconverge.com/api/admin/organizations`
- Auth: none declared

## Headers

- `Authorization` string, nullable

## Cookies

- `session_id` string, nullable

## Request body

- CreateOrganizationSchema
  - `name` string, required
  - `hubspot_company_id` string, required
  - `workspaces` WorkspaceInput[], required
    - `name` string, required
    - `workspace_settings` ValidatedWorkspaceInternalSettings, required
      - `features` object
      - `attributed_spend_settings` AttributedSpendSettings
        - `event_name` 'Viewed Product' | 'Added To Cart' | 'Placed Order', required

## Response `200`

Successful Response

- CreateOrganizationResponse
  - `id` integer, required
  - `name` string, required
  - `hubspot_company_id` string, required
  - `workspaces` WorkspaceOutput[], required
    - `name` string, required
    - `id` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-15** `f723e951cc0b`: 1 info
  - added the new `slack_agent` enum value to the request property `workspaces/items/workspace_settings/features/propertyNames/`

[Operation history](https://skmtc.dev/runconverge/apis/runconverge-api/changes/admin/organizations/post.md)

---

[API](https://skmtc.dev/runconverge/apis/runconverge-api.md) - [All operations](https://skmtc.dev/runconverge/apis/runconverge-api/llms.txt) - [OpenAPI document](https://skmtc.dev/runconverge/apis/runconverge-api/revisions/f723e951cc0b?raw)