---
title: "Create"
method: POST
path: "/v1/organizations"
tags: ["Organizations"]
---

# Create

`POST /v1/organizations`

Creates a new organization with the specified data.

## Request body

- OrganizationCreateSpec — Organization creation request parameters
  - `organization` OrganizationCreate, required — Organization creation request parameters
    - `name` string, required — Organization legal name
    - `billing_contact_name` string — Contact name
    - `billing_contact_phone` string — Contact phone
    - `billing_contact_email` string — Contact email
    - `address` string — Legal address
    - `managed_by_msp_id` integer, required — Organization is managed by the specified MSP
    - `unique_id` string — Used to determine custom login url for enterprise connections
    - `sku` string — SKU for plan type selected
    - `quantity` integer — Number of licenses to assign
    - `vpn_settings_organization_attributes` object — Vpn organization settings
      - `id` integer
      - `vpn_settings_state_type_id` integer
      - `_destroy` boolean
    - `privacy_mode` 'inherit' | 'standard' | 'identify_devices' | 'maximum' — Privacy mode for the organization, either
    - `enable_cybersight` boolean — This will only enable access if the organization is entitled to CyberSight

## Response `201`

Created organization basic information

- object
  - `data` OrganizationSpec — Organization specification
    - `id` string — Resource Id (integer or uuid)
    - `type` string — Resource type name
    - `uuid` string — Resource UUID (if applicable)
    - `attributes` Organization — Organization resource
      - `id` integer — ID
      - `address` string — Organization legal address
      - `allow_create_network` boolean — Current user can create new networks in the organization
      - `allowlist_updated_at` string, date-time — The datetime the allow list was last updated
      - `billing_address` string — The organization's billing address
      - `billing_contact_email` string — Contact email
      - `billing_contact_name` string — Contact name
      - `billing_contact_phone` string — Contact phone
      - `billing_manual` boolean — Internal Use Only
      - `blocklist_updated_at` string, date-time — The datetime the block list was last updated
      - `canceled` boolean — True if the organization has been canceled
      - `canceled_at` string, date-time — The datetime the organization was canceled
      - `external_id` string — A unique identifier for external integrations
      - `feature_flags` string[] — Allowed features in APP
      - `fetched_onboard_details` boolean — True if organization has provided onboarding details
      - `first_traffic_sent` string, date-time — The datetime the organizations first received DNS network traffic
      - `industry` string — Internal Use Only
      - `managed_by_msp_id` integer — Organization is managed by the specified MSP (may be null)
      - `metadata` string — Internal Use Only
      - `msp_feature_flags` string[] — Allowed features in APP (defined for sub orgs only)
      - `name` string — Organization legal name
      - `owned_msp_id` integer — Organization is owned by an MSP (may be null)
      - `plan_details` string — Internal Use Only
      - `release_channel` string — Internal Use Only
      - `role` string — Role
      - `send_uninstall_notifications_to_admin_users` boolean — Notify admins of uninstall notifications
      - `sso_enabled` boolean — Organization's SSO status
      - `stripe_customer_id` string — Stripe ID
      - `summary_email_address` string — The email to send the weekly summary of activity email
      - `summary_email_enabled` boolean — True if the weekly summary of activity email should be sent
      - `sync_tools_auto_update` string — Internal Use Only
      - `trial_days` integer — Number of trial days (may be null)
      - `unbounce_data` string — Internal Use Only
      - `unique_id` string — A globally unique value among all organizations
      - `update_payment` boolean — Organization has a valid payment method associated
      - `usage_alert_cents` string — Internal Use Only
      - `user_agent_uninstall_notification` boolean — Notify recipients when user agent is uninstalled
      - `user_agent_uninstall_notification_recipient_emails` string[] — Recipients to receive uninstalled user agent notifications
      - `user_agents_auto_update` boolean — True if user agents will auto update
      - `will_cancel_at` string, date-time — The datetime the organization will be canceled
      - `active_psa_integration` boolean — Organization has an active PSA integration
      - `segment` string — Internal Use Only
      - `vpn_settings_organization` object — Vpn organization settings
        - `vpn_settings_state_type_id` integer
    - `relationships` object — Network associated resources
      - `networks` object
        - `data` IdType[]
          - `id` string — Resource Id (integer or uuid)
          - `type` string — Resource type name
          - `uuid` string — Resource UUID (if applicable)

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `422` — Can not create organization with the specified data

---

[API](https://skmtc.net/dnsfilter/apis/dnsfilter-api.md) · [All operations](https://skmtc.net/dnsfilter/apis/dnsfilter-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dnsfilter/dnsfilter-api/revisions/29e5e6ee3316/schema)