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

# Create Invites

> Invites email addresses to the organization as members. If any email is rejected, the whole request fails and no invites are created. Rate limited to 10 requests per hour.



## OpenAPI

````yaml latest.yml POST /organizations/invites
openapi: 3.0.1
info:
  title: Cartesia API
  version: 0.0.1
servers:
  - url: https://api.cartesia.ai
    description: Production
security: []
paths:
  /organizations/invites:
    post:
      tags:
        - Organizations
      summary: Create Invites
      description: >-
        Invites email addresses to the organization as members. If any email is
        rejected, the whole request fails and no invites are created. Rate
        limited to 10 requests per hour.
      operationId: postOrganizationsInvites
      parameters:
        - $ref: '#/components/parameters/CartesiaVersionHeader'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateOrganizationInvitesRequest'
      responses:
        '201':
          description: Create Invites
          content:
            application/json:
              schema:
                description: The created invites, in the same order as the request emails
                type: array
                items:
                  $ref: '#/components/schemas/OrganizationInvite'
              example:
                - id: orginv_123
                  email: jsmith@example.com
                  role: member
                  status: pending
                  created_at: '2023-11-07T05:31:56Z'
                  expires_at: '2023-12-07T05:31:56Z'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateInvitesBadRequestError'
        '500':
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnexpectedErrorResponse'
      security:
        - AdminAPIKeyAuth: []
components:
  parameters:
    CartesiaVersionHeader:
      name: Cartesia-Version
      in: header
      description: API version header.
      required: true
      schema:
        type: string
        format: date
        example: '2026-03-01'
        default: '2026-03-01'
        enum:
          - '2026-03-01'
  schemas:
    CreateOrganizationInvitesRequest:
      description: Request to invite users to the organization
      type: object
      properties:
        emails:
          description: >-
            Email addresses to invite, up to 10 per request. Each address
            receives a `member` invite.
          type: array
          items:
            type: string
          maxItems: 10
          minItems: 1
      required:
        - emails
      title: CreateOrganizationInvitesRequest
    OrganizationInvite:
      description: An invite to join the organization
      type: object
      properties:
        created_at:
          description: When the invite was created
          type: string
          format: date-time
        email:
          description: Email address the invite was sent to
          type: string
        expires_at:
          type: string
          format: date-time
          nullable: true
          description: When the invite expires, if it has an expiry
        id:
          description: Unique identifier for the invite
          type: string
        role:
          description: Role the invited user will receive when they accept
          type: string
          enum:
            - admin
            - member
        status:
          description: Status of the invite
          type: string
          enum:
            - pending
            - accepted
            - revoked
            - expired
      required:
        - id
        - email
        - role
        - status
        - created_at
        - expires_at
      title: OrganizationInvite
    CreateInvitesBadRequestError:
      allOf:
        - $ref: '#/components/schemas/PublicErrorResponse'
      example:
        request_id: 0d766fa2-72ca-41b6-8206-de07ff699f8c
        message: |-
          ✖ Invalid email address
            → at emails[0]
        title: Invalid request
      title: CreateInvitesBadRequestError
    UnexpectedErrorResponse:
      allOf:
        - $ref: '#/components/schemas/PublicErrorResponse'
      example:
        title: Unexpected error
        message: >-
          An unexpected error occurred, please contact support@cartesia.ai if
          the problem persists.
      title: UnexpectedErrorResponse
    PublicErrorResponse:
      type: object
      properties:
        doc_url:
          description: URL to relevant documentation for the error
          type: string
          nullable: true
        error_code:
          description: Machine-readable error code
          type: string
          nullable: true
        message:
          description: Detailed human-readable error message
          type: string
        request_id:
          description: >-
            Unique identifier for this request. Include this when contacting
            support.
          type: string
        title:
          description: Short human-readable error summary, like "File too large"
          type: string
      required:
        - request_id
        - message
        - title
      title: PublicErrorResponse
  securitySchemes:
    AdminAPIKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: Admin API Key
      description: >-
        Cartesia admin API key (`sk_car_admin_...`). Get one at
        [play.cartesia.ai/keys/admin](https://play.cartesia.ai/keys/admin).
      x-default: $CARTESIA_ADMIN_API_KEY

````