---
title: "Bulk create stakeholders"
method: POST
path: "/stakeholder-comms/cloudId/{cloudId}/api/stakeholders/bulk"
tags: ["Stakeholder User management"]
---

# Bulk create stakeholders

`POST /stakeholder-comms/cloudId/{cloudId}/api/stakeholders/bulk`

Create multiple stakeholders in Stakeholder Comms.

## Request body

- StakeholderCommsStakeholderBulkCreateRequest — Request to create multiple stakeholders.
  - `stakeholders` Stakeholder[] — Stakeholders to create. — unresolved $ref
  - `joiningGroupId` string — Optional group ID to add all stakeholders to.

## Response `200`

Returned if the bulk operation is successfully processed.

- StakeholderCommsBulkStakeholderCreateResult — Result of a bulk stakeholder create operation.
  - `success` boolean — Whether the bulk create was successful.
  - `message` string — Summary message.
  - `totalCount` integer
  - `successCount` integer
  - `failureCount` integer
  - `successfulStakeholders` object[] — Details of successfully created stakeholders.
    - `stakeholder` StakeholderCommsStakeholder — A stakeholder in Stakeholder Comms.
      - `id` string — Unique identifier of the stakeholder.
      - `ari` string — Atlassian Resource Identifier for the stakeholder.
      - `aaid` string — Atlassian Account ID.
      - `stakeholderGroupId` string — Group the stakeholder belongs to.
      - `atlassianTeamId` string — Atlassian team ID.
      - `type` 'EXTERNAL' | 'INTERNAL' | 'GROUP' | 'TEAM' — Type of the stakeholder.
      - `skipConfirmation` boolean — Whether confirmation was skipped for this stakeholder.
      - `status` 'ACTIVE' | 'PENDING_IDENTITY_SETUP' | 'INVITED' | 'INVITED_PENDING_APPROVAL' | 'NOT_INVITED' | 'QUARANTINED' | 'DELETED' — Status of the stakeholder.
      - `notificationPreference` StakeholderCommsNotificationPreference — Notification preference details for a stakeholder.
        - `id` string — Identifier of the notification preference.
        - `emailId` string — Email address for notifications.
        - `phoneNumber` string — Phone number for SMS notifications.
        - `phoneCountry` string — Country code for the phone number.
        - `webhook` string — Webhook URL for notifications.
        - `preference` StakeholderCommsNotificationChannels — Per-channel notification enablement settings.
          - `email` object
            - `enabled` boolean
          - `sms` object
            - `enabled` boolean
          - `webhook` object
            - `enabled` boolean
        - `insertedAt` string, date-time — When the preference was created.
        - `updatedAt` string, date-time — When the preference was last updated.
      - `insertedAt` string, date-time — When the stakeholder was created.
      - `updatedAt` string, date-time — When the stakeholder was last updated.
      - `name` string — Display name of the stakeholder (from identity provider).
      - `avatar` string — Avatar URL for the stakeholder.
      - `groups` StakeholderCommsStakeholderGroupRef[] — Groups the stakeholder belongs to.
        - `id` string — Identifier of the group.
        - `name` string — Name of the group.
        - `avatar` string — Avatar URL for the group.
    - `assignment` StakeholderCommsAssignment — Assignment between a stakeholder and another entity in Stakeholder Comms.
      - `id` string — Identifier of the assignment.
      - `ari` string — Atlassian Resource Identifier for the assignment.
      - `assignmentType` 'INCIDENT' | 'SITE' | 'ORG' | 'PAGE' | 'PRODUCT' | 'ASSET' | 'SERVICES' — Type of the assignment.
      - `addedFrom` 'STATUSPAGE' | 'JSM' — Source from which the assignment was added.
      - `externalAssignmentId` string — Identifier in the external system.
      - `insertedAt` string, date-time — When the assignment was created.
      - `updatedAt` string, date-time — When the assignment was last updated.
    - `message` string
    - `error` string
  - `errors` object[] — Errors for failed stakeholder creates.
    - `index` integer
    - `error` string

## Other responses

- `400` — Returned if the request is invalid.
- `401` — Returned if the authentication credentials are incorrect.
- `403` — Returned if the user does not have permission to create the stakeholders.
- `500` — Returned if an internal server error occurs.

---

[API](https://skmtc.dev/atlassian/apis/jsm-operations-api.md) · [All operations](https://skmtc.dev/atlassian/apis/jsm-operations-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atlassian/jsm-operations-api/revisions/ed65f017bcb8/schema)