Microsoft mailboxes

Use the Microsoft mailbox endpoints to connect Microsoft 365 mailboxes with Microsoft Graph app-only authentication. This workflow uses a Microsoft Entra ID app registration instead of mailbox passwords or user-based OAuth consent.

This method is designed for admin-managed or bulk mailbox connections. If a user only needs to connect their own mailbox, they can use the standard Microsoft OAuth connection flow in the Woodpecker app.

First, create a Microsoft Graph credential with the tenant ID, client ID, and client secret from your Microsoft app registration. At minimum, the app registration requires the following Microsoft Graph permissions: Mail.Read, Mail.ReadWrite, Mail.Send, and User.Read.

Then, use the credential to connect one or more Microsoft mailboxes in bulk. For Microsoft's setup steps, see Register an application with the Microsoft identity platform.

Available endpoints

Endpoint	Method and path	Use it to
List Microsoft Graph credentials	GET /rest/v2/mailboxes/microsoft/credentials	Retrieve saved Microsoft Graph app-only credentials.
Create a Microsoft Graph credential	POST /rest/v2/mailboxes/microsoft/credentials	Save tenant and app credentials for Microsoft Graph app-only access.
Update a Microsoft Graph credential	PATCH /rest/v2/mailboxes/microsoft/credentials/{credential_id}	Rename a credential or rotate its client secret.
Delete a Microsoft Graph credential	DELETE /rest/v2/mailboxes/microsoft/credentials/{credential_id}	Remove a credential that is not used by an active mailbox.
Add Microsoft mailboxes in bulk	POST /rest/v2/mailboxes/microsoft/bulk	Connect one or more Microsoft mailboxes with app-only authentication.