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

# Get an internal user's notification settings

> Retrieves an internal user's notification preferences: the global in-product
toggle, the global email delivery mode, and per-category opt-outs under
notifyAbout. Settings declared by the workspace's installed apps appear under
dynamic customApp:<appId>:<notificationSettingId> keys, using the app's declared
defaults until the user customizes them. Users who have never changed their
settings return the default preferences.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/internal-users/{id}/notification-settings
openapi: 3.0.0
info:
  contact: {}
  title: Assembly API
  version: 0.0.1
servers:
  - url: https://api.assembly.com
security: []
paths:
  /v1/internal-users/{id}/notification-settings:
    get:
      tags:
        - Internal Users
      summary: Get an internal user's notification settings
      description: >-
        Retrieves an internal user's notification preferences: the global
        in-product

        toggle, the global email delivery mode, and per-category opt-outs under

        notifyAbout. Settings declared by the workspace's installed apps appear
        under

        dynamic customApp:<appId>:<notificationSettingId> keys, using the app's
        declared

        defaults until the user customizes them. Users who have never changed
        their

        settings return the default preferences.
      operationId: retrieve-internal-user-notification-settings
      parameters:
        - description: ID of the internal user
          in: path
          name: id
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/notificationsettings.InternalUserNotificationSettings
          description: OK
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Missing or invalid API key
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: No internal user found with the given ID
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Unexpected server error
      security:
        - APIKeyHeader: []
components:
  schemas:
    notificationsettings.InternalUserNotificationSettings:
      properties:
        disableInProduct:
          description: >-
            DisableInProduct is true when the user has globally disabled
            in-product notifications;

            when true it overrides every per-category setting in notifyAbout.
          example: false
          type: boolean
        emailSettings:
          description: >-
            EmailSettings is the user's global email delivery preference:
            "always" sends every

            notification email, "not_active" only emails the user when they have
            no active session,

            and "no_emails" disables notification emails entirely.
          enum:
            - always
            - not_active
            - no_emails
          example: not_active
          type: string
        notifyAbout:
          additionalProperties:
            $ref: >-
              #/components/schemas/notificationsettings.InternalUserNotifyAboutSetting
          description: >-
            NotifyAbout maps a notification category to the user's per-channel
            opt-outs.

            First-party keys: newClientDirectSignup, newClientActivation,
            newMessages, paidInvoices,

            processingInvoices, paymentFailedInvoices, uploadedFiles,
            signedContracts,

            newFormResponses, newTeamMemberActivation, assistantMention. Every
            notification setting

            declared by the portal's installed apps appears under its camelCased
            label (the app's

            declared default when the user hasn't customized it), with appId and

            notificationSettingId identifying the app setting it belongs to.
          type: object
        object:
          example: internalUserNotificationSettings
          type: string
      type: object
    dispatcher.Error:
      properties:
        code:
          type: string
        data: {}
        message:
          type: string
      type: object
    notificationsettings.InternalUserNotifyAboutSetting:
      properties:
        appId:
          description: >-
            AppID is the ID of the installed app this setting belongs to.
            Present only for app-declared settings.
          type: string
        disableEmail:
          description: >-
            DisableEmail is true when email notifications for this category are
            off.
          example: true
          type: boolean
        disableInProduct:
          description: >-
            DisableInProduct is true when in-product notifications for this
            category are off.
          example: false
          type: boolean
        notificationSettingId:
          description: >-
            NotificationSettingID is the ID of the app's notification setting.
            Present only for app-declared settings.
          type: string
      type: object
  securitySchemes:
    APIKeyHeader:
      in: header
      name: X-API-KEY
      type: apiKey

````