feat: Add bulk invitation creation support

CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## Next release
 
+- Add support for bulk invitation creation with the `invitation.BulkCreate` method.
+
 ## 2.1.1
 
 - Add `EmailAddressQuery`, `PhoneNumberQuery` and `UsernameQuery` to `user.ListParams`.

invitation.go

@@ -16,6 +16,11 @@ type Invitation struct {
 	UpdatedAt      int64           `json:"updated_at"`
 }
 
+type Invitations struct {
+	APIResource
+	Invitations []*Invitation `json:"data"`
+}
+
 type InvitationList struct {
 	APIResource
 	Invitations []*Invitation `json:"data"`

invitation/client.go

@@ -76,6 +76,41 @@ func (c *Client) Create(ctx context.Context, params *CreateParams) (*clerk.Invit
 	return invitation, err
 }
 
+type BulkCreateParams struct {
+	clerk.APIParams
+	Invitations []*CreateParams
+}
+
+func (b BulkCreateParams) MarshalJSON() ([]byte, error) {
+	return json.Marshal(b.Invitations)
+}
+
+type bulkCreateResponse struct {
+	clerk.APIResource
+	Invitations []*clerk.Invitation
+}
+
+func (b *bulkCreateResponse) UnmarshalJSON(data []byte) error {
+	return json.Unmarshal(data, &b.Invitations)
+}
+
+// BulkCreate creates multiple invitations.
+func (c *Client) BulkCreate(ctx context.Context, params *BulkCreateParams) (*clerk.Invitations, error) {
+	req := clerk.NewAPIRequest(http.MethodPost, fmt.Sprintf("%s/bulk", path))
+	req.SetParams(params)
+
+	res := &bulkCreateResponse{}
+	err := c.Backend.Call(ctx, req, res)
+	if err != nil {
+		return nil, err
+	}
+
+	return &clerk.Invitations{
+		APIResource: res.APIResource,
+		Invitations: res.Invitations,
+	}, nil
+}
+
 // Revoke revokes a pending invitation.
 func (c *Client) Revoke(ctx context.Context, id string) (*clerk.Invitation, error) {
 	path, err := clerk.JoinPath(path, id, "revoke")

invitation/invitation_test.go

@@ -162,6 +162,46 @@ func TestInvitationCreate_Error(t *testing.T) {
 	require.Equal(t, "create-error-code", apiErr.Errors[0].Code)
 }
 
+func TestBulkInvitationCreate(t *testing.T) {
+	emailAddresses := []string{"[email protected]", "[email protected]"}
+	ids := []string{"inv_123", "inv_456"}
+	invitations := []*clerk.Invitation{
+		{ID: ids[0], EmailAddress: emailAddresses[0]},
+		{ID: ids[1], EmailAddress: emailAddresses[1]},
+	}
+
+	clerk.SetBackend(clerk.NewBackend(&clerk.BackendConfig{
+		HTTPClient: &http.Client{
+			Transport: &clerktest.RoundTripper{
+				T:  t,
+				In: json.RawMessage(fmt.Sprintf(`[{"email_address":"%s"},{"email_address":"%s"}]`, emailAddresses[0], emailAddresses[1])),
+				Out: json.RawMessage(fmt.Sprintf(
+					`[{"id":"%s","email_address":"%s"},{"id":"%s","email_address":"%s"}]`,
+					ids[0], emailAddresses[0], ids[1], emailAddresses[1],
+				)),
+				Method: http.MethodPost,
+				Path:   "/v1/invitations/bulk",
+			},
+		},
+	}))
+
+	params := BulkCreateParams{
+		Invitations: []*CreateParams{
+			{EmailAddress: emailAddresses[0]},
+			{EmailAddress: emailAddresses[1]},
+		},
+	}
+
+	response, err := BulkCreate(context.Background(), &params)
+	require.NoError(t, err)
+	require.Len(t, invitations, 2)
+
+	for i, invitation := range response.Invitations {
+		require.Equal(t, ids[i], invitation.ID)
+		require.Equal(t, emailAddresses[i], invitation.EmailAddress)
+	}
+}
+
 func TestInvitationRevoke(t *testing.T) {
 	id := "inv_123"
 	clerk.SetBackend(clerk.NewBackend(&clerk.BackendConfig{