---
search:
  tags:
    - helpdesk
    - PUT
seo:
  description: >-
    Updates organization-specific helpdesk… Reference for the PUT
    /helpdesk/organizations/{organizationId}/settings endpoint in the Leadtime
    Public API API.
sidebar:
  badge: PUT
  label: Update organization helpdesk settings
title: Update organization helpdesk settings
type: openapi-operation
---
Updates organization-specific helpdesk settings. These settings override workspace defaults for the specified organization.

**What can be configured:**
- **Organization mode**: How settings apply (`onlyMembers` or `all`)
  - `onlyMembers`: Settings apply only when sender is a member of this organization
  - `all`: Settings apply to ALL emails sent to the account, regardless of sender
- **Default task priority**: Priority level for organization helpdesk tasks
- **Default task type**: Task type ID for organization helpdesk tasks
- **Default task status**: Task status ID for organization helpdesk tasks
- **Auto-assign user**: Optional user ID to automatically assign tasks to
- **Default reply body**: HTML template for automatic replies (supports variables like `taskNumber`)
- **Send default reply**: Whether to automatically send replies to new email senders

**How it works:**
1. Organization settings override workspace defaults when emails are processed
2. Settings apply based on the organization mode:
   - `onlyMembers`: Only when sender is an organization member
   - `all`: For all emails to the account (highest priority)
3. Null fields inherit from workspace email account settings or workspace defaults
4. Multiple organizations can have settings for the same email account

**Settings resolution example:**
If an email is sent to `support@company.com`:
- First check: Any org with mode='all'? → Use that org's settings
- Second check: Is sender a member? → Use their org's settings (if mode='onlyMembers')
- Third check: Workspace email account settings
- Final fallback: Workspace defaults

**Error handling:**
Returns 404 if the organization is not found or doesn't belong to the workspace.

**Note:** This endpoint requires the `Organizations.edit` permission. Organization settings provide fine-grained control over helpdesk behavior per organization.

<Operation source="api-reference" id="helpdeskcontroller-updateorganizationhelpdesksettings" />