> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create the caller's organization

> Creates the organization a partner signs up with. Through an open partner invite for the caller's email domain: the first person at the domain gets a new organization bound to the invite, later ones join it as admins until the agreement is signed. On their own: any address creates its own organization; a caller who belongs to one already is refused. The product decides what the organization owes next: a storefront sign-up (the default) owes the seller agreement; an Agent Simulations sign-up names the website the simulations run against (required, kept as its host), which becomes the organization's first site (`site`; null for a storefront sign-up), and accepts the Agent Simulation Terms when it starts its plan instead. Where the sign-up came from is kept with it. A sign-up without an invite must say how the person heard about us (`heardAbout`), or is refused with `heard_about_required`; an invited sign-up's answer is not kept.



## OpenAPI

````yaml https://api.zeroclick.io/openapi.json post /v1/organizations/
openapi: 3.0.0
info:
  title: ZeroClick API
  description: >-
    REST API for managing ZeroClick sellers, services, pricing, usage, and
    analytics. Authenticate with an API key from the ZeroClick dashboard.
  version: 1.0.0
servers:
  - url: https://api.zeroclick.io
security:
  - bearerAuth: []
tags:
  - name: API keys
  - name: Sellers
  - name: Services
  - name: Meters
  - name: Plans
  - name: Plan meter prices
  - name: Usage
  - name: Analytics
  - name: Agentify
  - name: Stripe Connect
  - name: Sandbox
  - name: Organizations
  - name: Users
paths:
  /v1/organizations/:
    post:
      tags:
        - Organizations
      summary: Create the caller's organization
      description: >-
        Creates the organization a partner signs up with. Through an open
        partner invite for the caller's email domain: the first person at the
        domain gets a new organization bound to the invite, later ones join it
        as admins until the agreement is signed. On their own: any address
        creates its own organization; a caller who belongs to one already is
        refused. The product decides what the organization owes next: a
        storefront sign-up (the default) owes the seller agreement; an Agent
        Simulations sign-up names the website the simulations run against
        (required, kept as its host), which becomes the organization's first
        site (`site`; null for a storefront sign-up), and accepts the Agent
        Simulation Terms when it starts its plan instead. Where the sign-up came
        from is kept with it. A sign-up without an invite must say how the
        person heard about us (`heardAbout`), or is refused with
        `heard_about_required`; an invited sign-up's answer is not kept.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 200
                  pattern: ^[^<>\p{Cc}]*$
                product:
                  type: string
                  enum:
                    - agent_storefront
                    - agent_simulations
                website:
                  type: string
                  minLength: 1
                  maxLength: 2048
                arrival:
                  type: object
                  properties:
                    zcVisitorId:
                      type: string
                      minLength: 1
                      maxLength: 200
                    landingEventId:
                      type: string
                      minLength: 1
                      maxLength: 200
                    acquisitionLandingId:
                      type: string
                      minLength: 1
                      maxLength: 200
                    utmSource:
                      type: string
                      minLength: 1
                      maxLength: 200
                    utmMedium:
                      type: string
                      minLength: 1
                      maxLength: 200
                    utmCampaign:
                      type: string
                      minLength: 1
                      maxLength: 200
                    utmTerm:
                      type: string
                      minLength: 1
                      maxLength: 200
                    utmContent:
                      type: string
                      minLength: 1
                      maxLength: 200
                    utmId:
                      type: string
                      minLength: 1
                      maxLength: 200
                    fitCheckId:
                      type: string
                      minLength: 1
                      maxLength: 200
                heardAbout:
                  type: string
                  minLength: 2
                  maxLength: 200
              required:
                - name
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  organization:
                    type: object
                    properties:
                      workosOrganizationId:
                        type: string
                    required:
                      - workosOrganizationId
                    additionalProperties: false
                  origin:
                    type: object
                    properties:
                      channel:
                        type: string
                        enum:
                          - website
                          - invite_link
                      product:
                        type: string
                        enum:
                          - agent_storefront
                          - agent_simulations
                      selfServe:
                        type: boolean
                      website:
                        nullable: true
                        type: string
                    required:
                      - channel
                      - product
                      - selfServe
                      - website
                    additionalProperties: false
                  site:
                    nullable: true
                    type: object
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                      host:
                        nullable: true
                        type: string
                      websiteUrl:
                        nullable: true
                        type: string
                      createdAt:
                        type: string
                    required:
                      - id
                      - name
                      - host
                      - websiteUrl
                      - createdAt
                    additionalProperties: false
                required:
                  - organization
                  - origin
                  - site
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key created in the ZeroClick dashboard under Settings → API keys.
        Keys start with `zc_`. Send them as `Authorization: Bearer zc_...`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.