[Feature] Granular Error Messages & Webhooks for Delegation Credential Issues

[linear]

Problem Statement

Customers integrating with Cal.com’s calendar functionality (Google & Microsoft) often encounter unclear or missing error messages when delegation credentials fail, typically due to user emails not being part of the organization’s directory or incomplete OAuth permissions.

This lack of transparency makes it difficult for partners to guide users, leading to repeated support escalations and poor scalability.

Proposed Solution

Adding webhooks for delegation credentials errors.

Additionally, update the integration documentation to explain delegation limitations (Google Workspace / Azure directory requirements) and proper OAuth scope setup. Acceptance Criteria

• Clear, contextual error messages are returned to integrators for all delegation credential issues (e.g., “User not found in directory,” “Missing calendar.read/write scope,” etc.)
• Webhooks are triggered for delegation credential errors, delivering structured payloads for partner platforms.
• Updated Google and Microsoft integration docs include troubleshooting steps and delegation limitations.

[linear]

CAL-6636

[shivvrat12]

can you re generate and send some screenshots or screenrecording?

[Ryukemeister]

should be fixed in #24871