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. 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. |