---
search:
  tags:
    - organizations
    - POST
seo:
  description: >-
    Creates a new organization member (external contact) for an… Reference for
    the POST /organizations/members endpoint in the Leadtime Public API API.
sidebar:
  badge: POST
  label: Create organization member
title: Create organization member
type: openapi-operation
---
Creates a new organization member (external contact) for an organization. This automatically creates a user account that can be used for guest access to Leadtime.

**What happens:**
1. A new organization member record is created
2. A user account is automatically created and linked to the member
3. If `canLogin` is `true`:
   - User status is set to Active
   - In ready workspaces, an invitation email is sent with a secure link for setting a password
   - During initial workspace setup, invitation email delivery is deferred until setup is finished
   - The user can log in as a guest user
4. If `canLogin` is `false` or omitted:
   - User status is set to Inactive
   - No invitation is sent
   - The member exists as a contact only

**Required fields:**
- `organizationId` - The organization this member belongs to
- `firstName` - Member's first name
- `lastName` - Member's last name
- `email` - Email address (used for user account)
- `roleId` - User role ID (e.g., `workspace-id_guest_` for guest access)

**Avatar management:**
- `avatarId` is an avatar configuration ID. During the transition, an image file ID from `POST /workspace/upload` is also accepted and converted to an uploaded avatar configuration.

**Personality classifications:**
- **Influence level:** Low, Medium, High, Dominant
- **Attitude level:** Enthusiastic, WellMeaning, Neutral, Opposing
- **Personality type:** Dominant, Conscientious, Steady, Initiative

**Returns:** The created organization member with all details including the generated user ID.

<Operation source="api-reference" id="organizationmemberscontroller-createorganizationmember" />