Introduce reference for createOrganizationInvitationBulk

Author: LauraBeatris

docs/manifest.json

@@ -1038,6 +1038,11 @@
                                 "wrap": false,
                                 "href": "/docs/references/backend/organization/create-organization-invitation"
                               },
+                              {
+                                "title": "`createOrganizationInvitationBulk()`",
+                                "wrap": false,
+                                "href": "/docs/references/backend/organization/create-organization-invitation-bulk"
+                              },
                               {
                                 "title": "`updateOrganization()`",
                                 "wrap": false,

docs/references/backend/organization/create-organization-invitation-bulk.mdx

@@ -0,0 +1,78 @@
+---
+title: '`createOrganizationInvitationBulk()`'
+description: Use Clerk's Backend SDK to create multiple invitations for new users to join an organization.
+---
+
+{/* clerk/javascript file: https://github.com/clerk/javascript/blob/main/packages/backend/src/api/endpoints/OrganizationApi.ts#L292-L303 */}
+
+Creates multiple [`OrganizationInvitation`](/docs/references/backend/types/backend-organization-invitation)s in bulk for new users to join an organization.
+
+```ts
+function createOrganizationInvitationBulk(
+  organizationId: string,
+  params: CreateBulkOrganizationInvitationParams,
+): Promise<OrganizationInvitation>
+```
+
+## `CreateBulkOrganizationInvitationParams`
+
+<Properties>
+  - `inviterUserId`
+  - `string | null`
+
+  The user ID of the user creating the invitation.
+
+  ---
+
+  - `emailAddress`
+  - `string`
+
+  The email address to send the invitation to.
+
+  ---
+
+  - `role`
+  - `string`
+
+  The [role](/docs/organizations/roles-permissions) to assign the invited user within the organization.
+
+  ---
+
+  - `redirectUrl?`
+  - `string`
+
+  The full URL or path where users will land once the organization invitation has been accepted.
+
+  ---
+
+  - `publicMetadata?`
+  - [`OrganizationInvitationPublicMetadata`](/docs/references/javascript/types/metadata#organization-invitation-public-metadata)
+
+  Metadata that can be read from both the Frontend API and [Backend API](/docs/reference/backend-api){{ target: '_blank' }}, but can be set only from the Backend API.
+</Properties>
+
+## Example
+
+<Include src="_partials/backend/usage" />
+
+```tsx
+const organizationId = 'org_123'
+const params = [
+  {
+    inviterUserId: 'user_1',
+    emailAddress: 'testclerk1@clerk.dev',
+    role: 'org:admin'
+  },
+    {
+    inviterUserId: 'user_2',
+    emailAddress: 'testclerk2@clerk.dev',
+    role: 'org:member'
+  }
+]
+
+const response = await clerkClient.organizations.createOrganizationInvitationBulk(organizationId, params)
+```
+
+## Backend API (BAPI) endpoint
+
+This method in the SDK is a wrapper around the BAPI endpoint `POST/organizations/{organization_id}/invitations/bulk`. See the [BAPI reference](/docs/reference/backend-api/tag/Organization-Invitations#operation/CreateOrganizationInvitationBulk){{ target: '_blank' }} for more information.