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

# Create a new organization

> Create a new organization within the store by providing required fields such as `email` and `organization_name` in the request body. The request should include the `x-store-id` header for association with the store.

- **Request Body:**
  - `email`: Email address of the organization.
  - `organization_name`: Name of the organization.
  - `billing_email` (optional): Billing email for the organization.

- **Responses:**
  - `201`: Organization created successfully.
  - `400`: Bad request if required fields are missing.
  - `401`: Unauthorized if `x-store-id` is not provided.



## OpenAPI

````yaml /api-reference/blink-api.json post /organizations
openapi: 3.0.0
info:
  title: Blink API
  description: Comprehensive API documentation for Blink.
  version: 1.0.0
servers:
  - url: https://api.blink.store/v1
security:
  - storeIdHeader: []
tags:
  - name: Invoices
    description: Unified merchant of record invoices for products and subscriptions.
  - name: Geo Pricing
    description: Resolve Purchasing Power Parity (PPP) localized pricing.
paths:
  /organizations:
    post:
      tags:
        - Organizations
      summary: Create a new organization
      description: >-
        Create a new organization within the store by providing required fields
        such as `email` and `organization_name` in the request body. The request
        should include the `x-store-id` header for association with the store.


        - **Request Body:**
          - `email`: Email address of the organization.
          - `organization_name`: Name of the organization.
          - `billing_email` (optional): Billing email for the organization.

        - **Responses:**
          - `201`: Organization created successfully.
          - `400`: Bad request if required fields are missing.
          - `401`: Unauthorized if `x-store-id` is not provided.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateOrganizationRequest'
      responses:
        '201':
          description: Organization created successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationDetails'
        '400':
          description: Bad Request - Required fields missing.
        '401':
          description: Unauthorized - Store ID header missing.
      security:
        - storeIdHeader: []
components:
  schemas:
    CreateOrganizationRequest:
      type: object
      properties:
        email:
          type: string
        organization_name:
          type: string
        billing_email:
          type: string
      required:
        - email
        - organization_name
    OrganizationDetails:
      type: object
      properties:
        id:
          type: string
        email:
          type: string
        organization_name:
          type: string
        billing_email:
          type: string
        created_at:
          type: string
          format: date-time
  securitySchemes:
    storeIdHeader:
      type: apiKey
      in: header
      name: x-store-id

````