---
title: "Get recipients for notification target config (getRecipientsForNotificationTargetConfig)"
method: POST
path: "/api/notification/target/recipients"
tags: ["notification-target-controller"]
---

# Get recipients for notification target config (getRecipientsForNotificationTargetConfig)

`POST /api/notification/target/recipients`

Returns the page of recipients for such notification target configuration.

Available for users with 'SYS_ADMIN' or 'TENANT_ADMIN' authority.

## Query parameters

- `pageSize` integer, required
- `page` integer, required

## Request body

- NotificationTarget
  - `id` NotificationTargetId
    - `id` string, uuid, required — ID of the entity, time-based UUID v1
    - `entityType` 'NOTIFICATION_TARGET', required — string
  - `createdTime` integer — Entity creation timestamp in milliseconds since Unix epoch
  - `tenantId` TenantId
    - `id` string, uuid, required — ID of the entity, time-based UUID v1
    - `entityType` 'TENANT', required — string
  - `name` string, required
  - `configuration` union, required
    - MicrosoftTeamsNotificationTargetConfig
      - `description` string
      - `type` string, required
      - `webhookUrl` string, required
      - `channelName` string, required
      - `useOldApi` boolean
      - `id` unknown
      - `title` string
      - `email` string
      - `firstName` string
      - `lastName` string
    - PlatformUsersNotificationTargetConfig
      - `description` string
      - `type` string, required
      - `usersFilter` union, required
        - AffectedTenantAdministratorsFilter
          - `type` string, required
        - AffectedUserFilter
          - `type` string, required
        - AllUsersFilter
          - `type` string, required
        - CustomerUsersFilter
          - `type` string, required
          - `customerId` string, uuid, required
        - OriginatorEntityOwnerUsersFilter
          - `type` string, required
        - SystemAdministratorsFilter
          - `type` string, required
        - TenantAdministratorsFilter
          - `type` string, required
          - `tenantsIds` string[]
          - `tenantProfilesIds` string[]
        - UserListFilter
          - `type` string, required
          - `usersIds` string[], required
    - SlackNotificationTargetConfig
      - `description` string
      - `type` string, required
      - `conversationType` 'DIRECT' | 'PUBLIC_CHANNEL' | 'PRIVATE_CHANNEL'
      - `conversation` SlackConversation, required
        - `type` 'DIRECT' | 'PUBLIC_CHANNEL' | 'PRIVATE_CHANNEL', required
        - `id` string, required
        - `name` string, required
        - `wholeName` string
        - `email` string
        - `title` string

## Response `200`

OK

- PageDataUser
  - `data` User[] — Array of the entities
    - `id` UserId
      - `id` string, uuid, required — ID of the entity, time-based UUID v1
      - `entityType` 'USER', required — string
    - `createdTime` integer — Timestamp of the user creation, in milliseconds
    - `tenantId` TenantId
      - `id` string, uuid, required — ID of the entity, time-based UUID v1
      - `entityType` 'TENANT', required — string
    - `customerId` CustomerId
      - `id` string, uuid, required — ID of the entity, time-based UUID v1
      - `entityType` 'CUSTOMER', required — string
    - `email` string, required — Email of the user
    - `authority` 'SYS_ADMIN' | 'TENANT_ADMIN' | 'CUSTOMER_USER' | 'REFRESH_TOKEN' | 'PRE_VERIFICATION_TOKEN' | 'MFA_CONFIGURATION_TOKEN', required — Authority
    - `firstName` string — First name of the user
    - `lastName` string — Last name of the user
    - `phone` string — Phone number of the user
    - `version` integer
    - `name` string — Duplicates the email of the user, readonly
    - `additionalInfo` unknown
  - `totalPages` integer — Total number of available pages. Calculated based on the 'pageSize' request parameter and total number of entities that match search criteria
  - `totalElements` integer — Total number of elements in all available pages
  - `hasNext` boolean — 'false' value indicates the end of the result set

---

[API](https://skmtc.net/thingsboard/apis/thingsboard-rest-api.md) · [All operations](https://skmtc.net/thingsboard/apis/thingsboard-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thingsboard/thingsboard-rest-api/revisions/40169ccdec5c/schema)