diff --git a/CHANGELOG.md b/CHANGELOG.md
index bfef0fda..2a10149b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,10 @@
 # Nylas Java SDK Changelog
 
+## [Unreleased]
+
+### Changed
+* Clarify that event `default` visibility is Google-only
+
 ## [v2.17.1] - Release 2026-06-25
 
 ### Fixed
diff --git a/src/main/kotlin/com/nylas/models/EventVisibility.kt b/src/main/kotlin/com/nylas/models/EventVisibility.kt
index c44fa762..a234bfbd 100644
--- a/src/main/kotlin/com/nylas/models/EventVisibility.kt
+++ b/src/main/kotlin/com/nylas/models/EventVisibility.kt
@@ -4,6 +4,10 @@ import com.squareup.moshi.Json
 
 /**
  * Enum representation of visibility of the event, if the event is private or public.
+ *
+ * [DEFAULT] is only valid for Google events, where it defers to the calendar's own sharing
+ * settings. Microsoft and EWS events only support [PUBLIC] and [PRIVATE]; sending `default`
+ * for these providers returns a 400 error.
  */
 enum class EventVisibility {
   @Json(name = "default")