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

# Create member

> Creates a new member in your organization. When `sendInvitation` is `true`, the new member will receive an email invitation to join your organization. The member status will be `pending` until they accept the invitation.



## OpenAPI

````yaml /openapi-2025-01-15.init.json post /members
openapi: 3.0.0
info:
  title: Tomorro API
  description: >
    The Tomorro Public API enables you to programmatically manage contracts,
    members, and counterparties. Build powerful integrations that automate your
    contract management workflows.


    ## API Version: 2025-01-15.init


    This documentation is for API version `2025-01-15.init`.


    > **Warning:** This version is deprecated. This version is deprecated.
    Please upgrade to 2025-01-29.alpha.


    ### Using this version

    ```

    curl -X GET https://api.tomorro.com/members \
      -H "x-api-key: YOUR_API_KEY" \
      -H "tomorro-version: 2025-01-15.init"
    ```
  version: 2025-01-15.init
  contact: {}
servers:
  - url: https://api.tomorro.com/v2
    description: Production
  - url: https://api.demo.tomorro.com/v2
    description: Demo
  - url: http://localhost:3015
    description: Local Development
security: []
tags: []
paths:
  /members:
    post:
      tags:
        - Members
      summary: Create member
      description: >-
        Creates a new member in your organization. When `sendInvitation` is
        `true`, the new member will receive an email invitation to join your
        organization. The member status will be `pending` until they accept the
        invitation.
      operationId: MemberController_createMember
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MemberCreateDto'
      responses:
        '201':
          description: Member created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MemberResponseDto'
        '400':
          description: Invalid request body
        '401':
          description: Unauthorized - Invalid or missing API key
        '403':
          description: Forbidden - Insufficient permissions
        '429':
          description: Too Many Requests - Rate limit exceeded
      security:
        - X-API-KEY: []
components:
  schemas:
    MemberCreateDto:
      type: object
      properties:
        user:
          description: The user account information for the new member.
          example:
            email: john.doe@example.com
            firstName: John
            lastName: Doe
          allOf:
            - $ref: '#/components/schemas/MemberUserCreateDto'
        role:
          type: string
          description: >-
            Member role. USER: Standard user with basic permissions. MANAGER:
            Can manage contracts and team workflows. ADMIN: Full administrative
            access.
          enum:
            - USER
            - MANAGER
            - ADMIN
          example: USER
        groupIds:
          description: List of group UUIDs to assign the member to
          example:
            - 550e8400-e29b-41d4-a716-446655440000
          type: array
          items:
            type: string
        sendInvitation:
          type: boolean
          description: >-
            Send an invitation email to the new member. When true, the member
            will receive an email invitation and their status will be `pending`
            until they accept.
          default: false
          example: true
      required:
        - user
        - role
    MemberResponseDto:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the member.
          example: 550e8400-e29b-41d4-a716-446655440000
        role:
          type: string
          description: >-
            The role assigned to this member, which determines their
            permissions.


            - `USER`: Standard user with basic access to view and interact with
            contracts.

            - `MANAGER`: Can create, edit, and manage contracts and workflows.

            - `ADMIN`: Full administrative access including member management
            and organization settings.
          enum:
            - USER
            - MANAGER
            - ADMIN
          example: ADMIN
        status:
          type: string
          description: >-
            The current status of the member.


            - `active`: The member has accepted their invitation and can access
            the platform.

            - `disabled`: The member has been deactivated and cannot access the
            platform.

            - `pending`: The member has been invited but has not yet accepted.
          enum:
            - active
            - disabled
            - pending
          example: active
        user:
          description: The user account associated with this member.
          example:
            email: john.doe@example.com
            firstname: John
            lastname: Doe
          allOf:
            - $ref: '#/components/schemas/MemberUserResponseDto'
        groupIds:
          description: List of group UUIDs the member belongs to.
          example:
            - 550e8400-e29b-41d4-a716-446655440000
          type: array
          items:
            type: string
        createdAt:
          format: date-time
          type: string
          description: >-
            Time at which the member was created. Formatted as an ISO 8601
            date-time string.
          example: '2024-01-01T00:00:00.000Z'
        updatedAt:
          format: date-time
          type: string
          description: >-
            Time at which the member was last updated. Formatted as an ISO 8601
            date-time string.
          example: '2024-01-02T00:00:00.000Z'
      required:
        - id
        - role
        - status
        - user
        - groupIds
    MemberUserCreateDto:
      type: object
      properties:
        email:
          type: string
          description: >-
            Email address for the new member. This will be used for login and
            communications.
          example: john.doe@example.com
        firstName:
          type: string
          description: The first name of the user.
          example: John
        lastName:
          type: string
          description: The last name of the user.
          example: Doe
      required:
        - email
    MemberUserResponseDto:
      type: object
      properties:
        email:
          type: string
          description: >-
            The email address of the user. This is used for login and
            communications.
          example: john.doe@example.com
        firstName:
          type: string
          description: The first name of the user.
          nullable: true
          example: John
        lastName:
          type: string
          description: The last name of the user.
          nullable: true
          example: Doe
      required:
        - email
  securitySchemes:
    X-API-KEY:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key for authentication. Get your key at
        https://app.tomorro.com/settings/integrations?integration=api-key

````