docs: Add Salesforce field mapping validation and error surfacing

[mintlify]

Summary

Adds documentation for the new Salesforce field mapping validation and sync error surfacing features shipped in calcom/cal#1445 by @syed Ali Shahbaz.

• Inline validation: Documents client-side checks that catch type mismatches when adding/editing field mappings (checkbox requires boolean, date requires valid reference, text fields require non-empty values).
• Save-time validation: Documents server-side validation against the Salesforce org schema on save — checks field existence, writability, type compatibility, picklist values, and field name casing.
• Sync error notifications: Documents the diagnostic error banner that appears on the Salesforce settings tab when a runtime sync failure occurs, showing error code, message, dropped fields, and timestamp.

What shipped

Cal.com now validates Salesforce field mappings both when you save event type settings and at runtime. Invalid configurations are caught early with clear error messages, and runtime sync failures surface as dismissible notification banners on the Salesforce settings tab.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
calcomhelp	🟢 Ready	View Preview	Apr 10, 2026, 7:24 PM