{"openapi":"3.0.0","info":{"title":"Mail Webhooks","description":"The Zoom Mail webhooks allow developers to receive events for [Zoom Mail](https://developers.zoom.us/docs/zoom-mail/) features.","version":"1.0.0"},"paths":{"mail.history_event":{"post":{"tags":["WebHooks"],"summary":"mail.history_event","description":"The **Mail History Event** triggers whenever there is message related change in the mailbox.  For example, new message delivered, message moved between folders, message removed, and similar items.\n\n## Prerequisites\n* Account must have Workplace Business or higher license type.\n* Account must have enabled Zoom Mail Service and finished Mail Service Onboarding Flow.\n* Mail service End-To-End Encryption is disabled.\n* The requested mailbox has been provisioned.\n* Enabled **Event Subscriptions** for your [Marketplace app](https://marketplace.zoom.us/) with the following configurations:\n  * A valid **Event Notification Endpoint URL**.\n  * The **Mail History Event** subscription enabled under the **Mail** event.","operationId":"Mail.history_eventWebhook","requestBody":{"description":"Webhook payload for the `mail.history_event` event.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Mail.history_eventEvent"},"examples":{"default":{"summary":"Example mail.history_event event","value":{"event":"mail.history_event","event_ts":1732336289348,"payload":{"account_id":"iZudq0ta9dafad","operator":"john.doe@example.com","object":{"email":"john.doe@example.com","history_id":347658}}}}}}},"required":true},"responses":{"200":{"description":"Successfully received the webhook event."}},"deprecated":false}}},"components":{"schemas":{"Mail.history_eventEvent":{"required":["event","event_ts","payload"],"type":"object","properties":{"event":{"type":"string","description":"The name of the event."},"event_ts":{"type":"integer","description":"A timestamp at which the event occurred in echo milliseconds.","format":"int64"},"payload":{"required":["account_id","object","operator"],"type":"object","properties":{"account_id":{"type":"string","description":"The account ID of the user whose mailbox having the event."},"operator":{"type":"string","description":"The email of the user who triggered the event.  It could be the mailbox owner or the mailbox delegate user."},"object":{"required":["email","history_id"],"type":"object","properties":{"email":{"type":"string","description":"The mailbox email of which event is from."},"history_id":{"type":"integer","description":"History ID of the event that is generated from the message change."}},"additionalProperties":false,"description":"The information of the event."}},"additionalProperties":false}},"additionalProperties":false}}},"tags":[{"name":"WebHooks"}],"servers":[{"url":"https://{your-endpoint-url}"}]}