diff --git a/.firecrawl/mimecast-hold-docs.md b/.firecrawl/mimecast-hold-docs.md new file mode 100644 index 0000000..9134ae8 --- /dev/null +++ b/.firecrawl/mimecast-hold-docs.md @@ -0,0 +1,1074 @@ +[Mimecast](https://integrations.mimecast.com/) + +Getting started + + +[API 2.0 Overview](https://developer.services.mimecast.com/api-overview) [API 1.0 to 2.0 Migration Guide](https://developer.services.mimecast.com/api-1-0-to-2-0-migration-guide) [What's New](https://developer.services.mimecast.com/whats-new) + +API Documentation + + +[Action Usecase](https://developer.services.mimecast.com/action-usecase) [Alerting Usecase](https://developer.services.mimecast.com/alerting-usecase) [Analysis and Response API's](https://developer.services.mimecast.com/analysis-and-response-apis) [Building Search Queries](https://developer.services.mimecast.com/building-search-queries) [Configuration Backup Restore and Export APIs](https://developer.services.mimecast.com/configuration-backup-restore-and-export-apis) [Enrichment Usecase](https://developer.services.mimecast.com/enrichment-usecase) [Groups Usecase](https://developer.services.mimecast.com/groups-usecase) [Mimecast API In Power BI](https://developer.services.mimecast.com/mimecast-api-powerbi) [Secure Email Gateway](https://developer.services.mimecast.com/secure-email-gateway) [SIEM Tutorial CG](https://developer.services.mimecast.com/siem-tutorial-cg) [SIEM Tutorial CI](https://developer.services.mimecast.com/siem-tutorial-ci) [SIEM Batch CG Guidelines](https://developer.services.mimecast.com/siem-batch-guidelines) [SIEM Batch CI Guidelines](https://developer.services.mimecast.com/siem-batch-guidelines-ci) + +APIs + + +[API 2.0 Reference](https://developer.services.mimecast.com/apis) [API 1.0 Reference](https://integrations.mimecast.com/documentation/api-overview/) + +[Technology Partners](https://integrations.mimecast.com/tech-partners/) + +[Become a Partner](https://integrations.mimecast.com/become-a-technology-alliance-partner/) + +EN + + +[English](https://integrations.mimecast.com/) [Deutsch](https://integrations.mimecast.com/de/) [Français](https://integrations.mimecast.com/fr/) [Español](https://integrations.mimecast.com/es/) [Italiano](https://integrations.mimecast.com/it/) + +1. [Tech Connect](https://integrations.mimecast.com/) +2. [Documentation](https://integrations.mimecast.com/documentation/) +3. [API 1.0 Endpoint Reference](https://integrations.mimecast.com/documentation/endpoint-reference/) +4. [Message Queues](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/) +5. Get Hold Message List + +# Get Hold Message List + +[Documentation](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + +Documentation + +- API 2.0 Overview + +- API 2.0 Reference + +- API 1.0 Reference + +- What's New + +- API 1.0 Overview [Expand or Collapse API 1.0 Overview Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [API Concepts](https://integrations.mimecast.com/documentation/api-overview/api-concepts/) + + - [Authentication and Authorization](https://integrations.mimecast.com/documentation/api-overview/authentication-and-authorization/) + + - [Authentication (Scripts and Server Apps)](https://integrations.mimecast.com/documentation/api-overview/authentication-scripts-server-apps/) + + - [Authorization](https://integrations.mimecast.com/documentation/api-overview/authorization/) + + - [Response Codes](https://integrations.mimecast.com/documentation/api-overview/response-code/) + + - [API Call Restrictions](https://integrations.mimecast.com/documentation/api-overview/rate-limiting/) + + - [Global Base URLs](https://integrations.mimecast.com/documentation/api-overview/global-base-urls/) +- API 1.0 Tutorials [Expand or Collapse API 1.0 Tutorials Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Action Use Cases](https://integrations.mimecast.com/documentation/tutorials/action-use-cases/) + + - [Alerting Use Cases](https://integrations.mimecast.com/documentation/tutorials/alerting-use-cases/) + + - [Enrichment Use Cases](https://integrations.mimecast.com/documentation/tutorials/enrichment-use-cases/) + + - [Groups Use Cases](https://integrations.mimecast.com/documentation/tutorials/groups-use-cases/) + + - [Understanding SIEM Logs](https://integrations.mimecast.com/documentation/tutorials/understanding-siem-logs/) + + - [Downloading SIEM logs](https://integrations.mimecast.com/documentation/tutorials/downloading-siem-logs/) + + - [Building Search Queries](https://integrations.mimecast.com/documentation/tutorials/building-search-queries/) + + - [Mimecast API in Power BI](https://integrations.mimecast.com/documentation/tutorials/mimecast-api-in-power-bi/) + + - [Using Postman](https://integrations.mimecast.com/documentation/tutorials/using-postman/) +- API 1.0 Endpoint Reference [Expand or Collapse API 1.0 Endpoint Reference Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Event Streaming Service](https://integrations.mimecast.com/documentation/endpoint-reference/event-streaming-service/) [Expand or Collapse Event Streaming Service Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Get Events](https://integrations.mimecast.com/documentation/endpoint-reference/event-streaming-service/get-events/) + + - [Get Latest Token](https://integrations.mimecast.com/documentation/endpoint-reference/event-streaming-service/get-latest-token/) + + - [Web Security Logs](https://integrations.mimecast.com/documentation/endpoint-reference/event-streaming-service/web-security-logs/) [Expand or Collapse Web Security Logs Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [DNS Request Logs](https://integrations.mimecast.com/documentation/endpoint-reference/event-streaming-service/web-security-logs/dns-request-logs/) + + - [Proxy Event Logs](https://integrations.mimecast.com/documentation/endpoint-reference/event-streaming-service/web-security-logs/proxy-event-logs/) + - [Account](https://integrations.mimecast.com/documentation/endpoint-reference/account/) [Expand or Collapse Account Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Get Support Info](https://integrations.mimecast.com/documentation/endpoint-reference/account/get-support-info/) + + - [Get Products](https://integrations.mimecast.com/documentation/endpoint-reference/account/get-products/) + + - [Get Dashboard Notifications](https://integrations.mimecast.com/documentation/endpoint-reference/account/get-dashboard-notifications/) + + - [Get Account](https://integrations.mimecast.com/documentation/endpoint-reference/account/get-account/) + - [Archive](https://integrations.mimecast.com/documentation/endpoint-reference/archive/) [Expand or Collapse Archive Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Search](https://integrations.mimecast.com/documentation/endpoint-reference/archive/search/) + + - [Get Message Part](https://integrations.mimecast.com/documentation/endpoint-reference/archive/get-message-part/) + + - [Get Message List](https://integrations.mimecast.com/documentation/endpoint-reference/archive/get-message-list/) + + - [Get Message Detail](https://integrations.mimecast.com/documentation/endpoint-reference/archive/get-message-detail/) + + - [Get File](https://integrations.mimecast.com/documentation/endpoint-reference/archive/get-file/) + - [Awareness Training](https://integrations.mimecast.com/documentation/endpoint-reference/awareness-training/) [Expand or Collapse Awareness Training Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Get Campaigns](https://integrations.mimecast.com/documentation/endpoint-reference/awareness-training/get-campaigns/) + + - [Get Campaign User Data](https://integrations.mimecast.com/documentation/endpoint-reference/awareness-training/get-campaign-user-data/) + + - [Get Performance Details](https://integrations.mimecast.com/documentation/endpoint-reference/awareness-training/get-performance-details/) + + - [Get Performance Summary](https://integrations.mimecast.com/documentation/endpoint-reference/awareness-training/get-performance-summary/) + + - [Get Phishing Campaign](https://integrations.mimecast.com/documentation/endpoint-reference/awareness-training/get-phishing-campaign/) + + - [Get Phishing User Data](https://integrations.mimecast.com/documentation/endpoint-reference/awareness-training/get-phishing-user-data/) + + - [Get SAFE Score Details](https://integrations.mimecast.com/documentation/endpoint-reference/awareness-training/get-safe-score-details/) + + - [Get SAFE Score Summary](https://integrations.mimecast.com/documentation/endpoint-reference/awareness-training/get-safe-score-summary/) + + - [Get Training Queue](https://integrations.mimecast.com/documentation/endpoint-reference/awareness-training/get-training-queue/) + + - [Get Training Details](https://integrations.mimecast.com/documentation/endpoint-reference/awareness-training/get-training-details/) + + - [Get Watchlist Details](https://integrations.mimecast.com/documentation/endpoint-reference/awareness-training/get-watchlist-details/) + + - [Get Watchlist Summary](https://integrations.mimecast.com/documentation/endpoint-reference/awareness-training/get-watchlist-summary/) + - [Policies](https://integrations.mimecast.com/documentation/endpoint-reference/policies/) [Expand or Collapse Policies Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Address Alteration](https://integrations.mimecast.com/documentation/endpoint-reference/policies/address-alteration/) [Expand or Collapse Address Alteration Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Create Definition](https://integrations.mimecast.com/documentation/endpoint-reference/policies/address-alteration/create-definition/) + + - [Create Policy](https://integrations.mimecast.com/documentation/endpoint-reference/policies/address-alteration/create-policy/) + + - [Create Set](https://integrations.mimecast.com/documentation/endpoint-reference/policies/address-alteration/create-set/) + + - [Delete Definition](https://integrations.mimecast.com/documentation/endpoint-reference/policies/address-alteration/delete-definition/) + + - [Delete Policy](https://integrations.mimecast.com/documentation/endpoint-reference/policies/address-alteration/delete-policy/) + + - [Get Definition](https://integrations.mimecast.com/documentation/endpoint-reference/policies/address-alteration/get-definition/) + + - [Get Policy](https://integrations.mimecast.com/documentation/endpoint-reference/policies/address-alteration/get-policy/) + + - [Get Set](https://integrations.mimecast.com/documentation/endpoint-reference/policies/address-alteration/get-set/) + + - [Update Policy](https://integrations.mimecast.com/documentation/endpoint-reference/policies/address-alteration/update-policy/) + - [Anti-Spoofing SPF Bypass](https://integrations.mimecast.com/documentation/endpoint-reference/policies/antispoofing-spf-bypass/) [Expand or Collapse Anti-Spoofing SPF Bypass Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Create Policy](https://integrations.mimecast.com/documentation/endpoint-reference/policies/antispoofing-spf-bypass/create-policy/) + + - [Delete Policy](https://integrations.mimecast.com/documentation/endpoint-reference/policies/antispoofing-spf-bypass/delete-policy/) + + - [Get Policy](https://integrations.mimecast.com/documentation/endpoint-reference/policies/antispoofing-spf-bypass/get-policy/) + + - [Update Policy](https://integrations.mimecast.com/documentation/endpoint-reference/policies/antispoofing-spf-bypass/update-policy/) + - [Blocked Sender Policy](https://integrations.mimecast.com/documentation/endpoint-reference/policies/blocked-sender-policy/) [Expand or Collapse Blocked Sender Policy Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Get Policy](https://integrations.mimecast.com/documentation/endpoint-reference/policies/blocked-sender-policy/get-policy/) + + - [Create Policy](https://integrations.mimecast.com/documentation/endpoint-reference/policies/blocked-sender-policy/create-policy/) + - [Directory](https://integrations.mimecast.com/documentation/endpoint-reference/directory/) [Expand or Collapse Directory Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Create Group](https://integrations.mimecast.com/documentation/endpoint-reference/directory/create-group/) + + - [Update Group](https://integrations.mimecast.com/documentation/endpoint-reference/directory/update-group/) + + - [Delete Group](https://integrations.mimecast.com/documentation/endpoint-reference/directory/delete-group/) + + - [Remove Group Member](https://integrations.mimecast.com/documentation/endpoint-reference/directory/remove-group-member/) + + - [Get Group Members](https://integrations.mimecast.com/documentation/endpoint-reference/directory/get-group-members/) + + - [Find Groups](https://integrations.mimecast.com/documentation/endpoint-reference/directory/find-groups/) + + - [Add Group Member](https://integrations.mimecast.com/documentation/endpoint-reference/directory/add-group-member/) + - [Directory Sync](https://integrations.mimecast.com/documentation/endpoint-reference/directory-sync/) [Expand or Collapse Directory Sync Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Get Connection](https://integrations.mimecast.com/documentation/endpoint-reference/directory-sync/get-connection/) + + - [Execute Sync](https://integrations.mimecast.com/documentation/endpoint-reference/directory-sync/execute-sync/) + - [Domain](https://integrations.mimecast.com/documentation/endpoint-reference/domain/) [Expand or Collapse Domain Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Verify Domain](https://integrations.mimecast.com/documentation/endpoint-reference/domain/verify-domain/) + + - [Get Verification Code](https://integrations.mimecast.com/documentation/endpoint-reference/domain/get-verification-code/) + + - [Get Provision Status](https://integrations.mimecast.com/documentation/endpoint-reference/domain/get-provision-status/) + + - [Get Pending Domain](https://integrations.mimecast.com/documentation/endpoint-reference/domain/get-pending-domain/) + + - [Get Internal Domain](https://integrations.mimecast.com/documentation/endpoint-reference/domain/get-internal-domain/) + + - [Delete Pending Domain](https://integrations.mimecast.com/documentation/endpoint-reference/domain/delete-pending-domain/) + + - [Create Domain](https://integrations.mimecast.com/documentation/endpoint-reference/domain/create-domain/) + - [Email](https://integrations.mimecast.com/documentation/endpoint-reference/email/) [Expand or Collapse Email Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [File Upload](https://integrations.mimecast.com/documentation/endpoint-reference/email/file-upload/) + + - [Send Email](https://integrations.mimecast.com/documentation/endpoint-reference/email/send-email/) + - [Logs and Statistics](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/) [Expand or Collapse Logs and Statistics Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Get Archive Message View](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-archive-message-view-logs/) + + - [Get Archive Search Logs](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-archive-search-logs/) + + - [Get Audit Events](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-audit-events/) + + - [Get DLP Logs](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-dlp-logs/) + + - [Get Journal Service](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-journal-service/) + + - [Message Release Logs](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-message-release-logs/) + + - [Get Rejection Logs](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-rejection-logs/) + + - [Get Search Logs](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-search-logs/) + + - [Get SIEM Logs](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-siem-logs/) + + - [Get TTP Attachment Protection Logs](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-ttp-attachment-protection-logs/) + + - [Get TTP Impersonation Protect Logs](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-ttp-impersonation-protect-logs/) + + - [Get TTP URL Logs](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-ttp-url-logs/) + - [Managed Sender](https://integrations.mimecast.com/documentation/endpoint-reference/managed-sender/) [Expand or Collapse Managed Sender Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Permit or Block Sender](https://integrations.mimecast.com/documentation/endpoint-reference/managed-sender/permit-or-block-sender/) + - [Message Finder (formerly Tracking)](https://integrations.mimecast.com/documentation/endpoint-reference/message-finder-formerly-tracking/) [Expand or Collapse Message Finder (formerly Tracking) Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Search](https://integrations.mimecast.com/documentation/endpoint-reference/message-finder-formerly-tracking/search/) + + - [Get Message Info](https://integrations.mimecast.com/documentation/endpoint-reference/message-finder-formerly-tracking/get-message-info/) + - [Message Queues](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/) [Expand or Collapse Message Queues Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Find Processing Messages](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/find-processing-messages/) + + - [Get Hold Message List](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/) + + - [Get Message Detail](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-message-detail/) + + - [Get File](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-file/) + + - [Get Message Hold Summary List](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-summary-list/) + + - [Reject Message](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/reject-message/) + + - [Release Message](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/release-message/) + + - [Inbound & Outbound Queues](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/inbound-outbound-queues/) + - [Targeted Threat Protection URL Protect](https://integrations.mimecast.com/documentation/endpoint-reference/targeted-threat-protection-url-protect/) [Expand or Collapse Targeted Threat Protection URL Protect Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Get Managed URL](https://integrations.mimecast.com/documentation/endpoint-reference/targeted-threat-protection-url-protect/get-managed-url/) + + - [Delete Managed URL](https://integrations.mimecast.com/documentation/endpoint-reference/targeted-threat-protection-url-protect/delete-managed-url/) + + - [Decode URL](https://integrations.mimecast.com/documentation/endpoint-reference/targeted-threat-protection-url-protect/decode-url/) + + - [Create Managed URL](https://integrations.mimecast.com/documentation/endpoint-reference/targeted-threat-protection-url-protect/create-managed-url/) + - [Threat Intel](https://integrations.mimecast.com/documentation/endpoint-reference/threat-intel/) [Expand or Collapse Threat Intel Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Bring Your Own](https://integrations.mimecast.com/documentation/endpoint-reference/threat-intel/bring-your-own/) [Expand or Collapse Bring Your Own Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Create Batch](https://integrations.mimecast.com/documentation/endpoint-reference/threat-intel/bring-your-own/create-batch/) + + - [Get Batches](https://integrations.mimecast.com/documentation/endpoint-reference/threat-intel/bring-your-own/get-batches/) + + - [Delete Batch](https://integrations.mimecast.com/documentation/endpoint-reference/threat-intel/bring-your-own/delete-batch/) + + - [Get Quota](https://integrations.mimecast.com/documentation/endpoint-reference/threat-intel/bring-your-own/get-quota/) + - [Get Feed](https://integrations.mimecast.com/documentation/endpoint-reference/threat-intel/get-feed/) + + - [Search Hash](https://integrations.mimecast.com/documentation/endpoint-reference/threat-intel/search-hash/) + + - [Find Incidents](https://integrations.mimecast.com/documentation/endpoint-reference/threat-intel/find-incidents/) + + - [Get Incident](https://integrations.mimecast.com/documentation/endpoint-reference/threat-intel/get-incident/) + + - [Create Incident](https://integrations.mimecast.com/documentation/endpoint-reference/threat-intel/create-incident/) + + - [Create Incident v2](https://integrations.mimecast.com/documentation/endpoint-reference/threat-intel/create-incident-v2/) + - [Web Security](https://integrations.mimecast.com/documentation/endpoint-reference/web-security/) [Expand or Collapse Web Security Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Create Policy](https://integrations.mimecast.com/documentation/endpoint-reference/web-security/create-policy/) + + - [Get Policies](https://integrations.mimecast.com/documentation/endpoint-reference/web-security/get-policies/) + + - [Delete Policy](https://integrations.mimecast.com/documentation/endpoint-reference/web-security/delete-policy/) + + - [Update Policy](https://integrations.mimecast.com/documentation/endpoint-reference/web-security/update-policy/) + - [User](https://integrations.mimecast.com/documentation/endpoint-reference/user/) [Expand or Collapse User Children](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) + - [Update User](https://integrations.mimecast.com/documentation/endpoint-reference/user/update-user/) + + - [Update Attributes](https://integrations.mimecast.com/documentation/endpoint-reference/user/update-attributes/) + + - [Update Alias](https://integrations.mimecast.com/documentation/endpoint-reference/user/update-alias/) + + - [Remove Alias](https://integrations.mimecast.com/documentation/endpoint-reference/user/remove-alias/) + + - [Get Profile](https://integrations.mimecast.com/documentation/endpoint-reference/user/get-profile/) + + - [Get Most Used Contacts](https://integrations.mimecast.com/documentation/endpoint-reference/user/get-most-used-contacts/) + + - [Get Internal Users](https://integrations.mimecast.com/documentation/endpoint-reference/user/get-internal-users/) + + - [Remove Delegate User](https://integrations.mimecast.com/documentation/endpoint-reference/user/remove-delegate-user/) + + - [Add Delegate User](https://integrations.mimecast.com/documentation/endpoint-reference/user/add-delegate-user/) + + - [Find Delegate Users](https://integrations.mimecast.com/documentation/endpoint-reference/user/find-delegate-users/) + + - [Get Delegated Access](https://integrations.mimecast.com/documentation/endpoint-reference/user/get-delegated-access/) + + - [Get Attributes](https://integrations.mimecast.com/documentation/endpoint-reference/user/get-attributes/) + + - [Get Aliases](https://integrations.mimecast.com/documentation/endpoint-reference/user/get-aliases/) + + - [Create user](https://integrations.mimecast.com/documentation/endpoint-reference/user/create-user/) + + - [Import Users](https://integrations.mimecast.com/documentation/endpoint-reference/user/import-users/) + + - [Get User Import Status](https://integrations.mimecast.com/documentation/endpoint-reference/user/get-user-import-status/) + +**In this guide:** + +- [Description](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#description) +- [Pre-requisites](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#pre-requisites) +- [URI](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#uri) +- [Request Headers](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#request-headers) +- [Request Body](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#request-body) +- [Response](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#response) +- [Sample Code](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#sample-code) + +#### Description + +This API endpoint can be used to get information about held messages, including the reason, hold level, sender and recipients. The ID can be used to act on a message using the Release Message or Reject Message API endpoints. + +#### Pre-requisites + +- In order to successfully use this endpoint the logged in user must be a Mimecast administrator with at least the **Account \| Dashboard \| Read** permission. + +#### URI + +To use this endpoint you send a POST request to: + +- /api/gateway/get-hold-message-list + +#### Request Headers + +The following request headers must be included in your request: + +| **Field** | **Description** | +| --- | --- | +| Authorization | Please see the [Authorization](https://integrations.mimecast.com/documentation/api-overview/authorization/) guide for more information on building the Authorization header. | +| x-mc-req-id | A randomly generated GUID, for example,
```
8578FCFC-A305-4D9A-99CB-F4D5ECEFE297
``` | +| x-mc-app-id | The Application ID provided with your Registered API Application. | +| x-mc-date | The current date and time in the following format, for example,
```
Tue, 24 Nov 2015 12:50:11 UTC
``` | + +#### Request Body + +``` + +{ + + "data": [\ +\ + {\ +\ + "admin": true,\ +\ + "start": "2015-11-16T14:49:18+0000",\ +\ + "searchBy": {\ +\ + "fieldName": "String",\ +\ + "value": "String"\ +\ + },\ +\ + "end": "2015-11-16T14:49:18+0000"\ +\ + }\ +\ + ] + +} +``` + +##### data + +| **Field** | **Type** | **Required** | **Description** | +| --- | --- | --- | --- | +| admin | Boolean | Optional | Level of results to return. If false, only results for the currenlty authenticated user will be returned. If true, held messages for all recipients will be returned. The default value is false. | +| searchBy | Object | Optional | Object data used to filter results | +| start | Date String | Optional | The date and time of the earliest message to return, in the following format, 2011-12-03T10:15:30+0000 | +| end | Date String | Optional | The date and time of the latest message to return, in the following format, 2011-12-03T10:15:30+0000 | + +##### searchBy + +| **Field** | **Type** | **Required** | **Description** | +| --- | --- | --- | --- | +| value | String | Optional | The text used to filter results | +| fieldName | String | Optional | Message fields to filter based on. Possible values are: all, subject, sender, recipient, reason\_code | + +#### Response + +``` + +{ + + "fail": [], + + "meta": { + + "status": 200 + + }, + + "data": [\ +\ + {\ +\ + "dateReceived": "String",\ +\ + "reason": "String",\ +\ + "reasonCode": "String",\ +\ + "id": "String",\ +\ + "size": 1000,\ +\ + "from": {\ +\ + "displayableName": "String",\ +\ + "emailAddress": "String"\ +\ + },\ +\ + "hasAttachments": "true",\ +\ + "route": "String",\ +\ + "policyInfo": "String",\ +\ + "fromHeader": {\ +\ + "displayableName": "String",\ +\ + "emailAddress": "String"\ +\ + },\ +\ + "to": {\ +\ + "displayableName": "String",\ +\ + "emailAddress": "String"\ +\ + },\ +\ + "reasonId": "String",\ +\ + "subject": "String"\ +\ + }\ +\ + ] + +} +``` + +##### meta object + +| **Field** | **Type** | **Description** | +| --- | --- | --- | +| status | Number | The function level status of the request. | + +##### meta + +| **Field** | **Type** | **Description** | +| --- | --- | --- | +| status | Number | The function level status of the request. | + +##### data + +| **Field** | **Type** | **Description** | +| --- | --- | --- | +| id | String | The Mimecast secure ID for a message | +| reason | String | The summary reason for holding the message | +| reasonId | String | Mirrors the reason field, formatted without spaces. However, reasonCode should be used instead | +| reasonCode | String | Reason code for holding the message | +| from | Object | Contains the envelope sender information | +| fromHeader | Object | Contains the header sender information | +| to | Object | Contains the envelope recipient information | +| toHeader | Object | Contains the header recipient information | +| subject | String | The message subject | +| route | String | Direction of message being held. Possible values are: INBOUND, OUTBOUND, INTERNAL, EXTERNAL | +| hasAttachments | Boolean | Returns true if the message contains attachments. False indicates no attachments | +| size | Integer | The size of the message in bytes | +| dateReceived | Date String | The timestamp of the message transmission | +| policyInfo | String | Information or definition name triggering the message hold action | + +#### Sample Code + +Sample code is provided to demonstrate how to use the API and is not representative of a production application. To use the sample code; complete the required variables as described, populate the desired values in the request body, and execute in your favorite IDE.  Please see the [Global Base URL's](https://integrations.mimecast.com/documentation/api-overview/global-base-urls/) page to find the correct base URL to use for your account. + +HTTPPythonC#PowerShellJava + +``` + +POST {base_url}/api/gateway/get-hold-message-list + +Authorization: MC {accesskKey}:{Base64 encoded signed Data To Sign} + +x-mc-date: {dateTime} + +x-mc-req-id: {unique id} + +x-mc-app-id: {applicationId} + +Content-Type: application/json + +Accept: application/json + + + +{ + + "data":[\ +\ + {\ +\ + "data":[\ +\ + {\ +\ + "searchBy": {\ +\ + "value": "String",\ +\ + "fieldName": "String"\ +\ + },\ +\ + "start": "2015-11-16T14:49:18+0000",\ +\ + "admin": true,\ +\ + "end": "2015-11-16T14:49:18+0000"\ +\ + }\ +\ + ]\ +\ + }\ +\ + ] + +} +``` + +``` + +import base64 + +import hashlib + +import hmac + +import uuid + +import datetime + +import requests + + + +# Setup required variables + +base_url = "https://xx-api.mimecast.com" + +uri = "/api/gateway/get-hold-message-list" + +url = base_url + uri + +access_key = "YOUR ACCESS KEY" + +secret_key = "YOUR SECRET KEY" + +app_id = "YOUR APPLICATION ID" + +app_key = "YOUR APPLICATION KEY" + + + +# Generate request header values + +request_id = str(uuid.uuid4()) + +hdr_date = datetime.datetime.utcnow().strftime("%a, %d %b %Y %H:%M:%S") + " UTC" + + + +# DataToSign is used in hmac_sha1 + +dataToSign = ':'.join([hdr_date, request_id, uri, app_key]) + + + +# Create the HMAC SHA1 of the Base64 decoded secret key for the Authorization header + +hmac_sha1 = hmac.new(base64.b64decode(secret_key), dataToSign.encode(), digestmod=hashlib.sha1).digest() + + + +# Use the HMAC SHA1 value to sign the hdrDate + ":" requestId + ":" + URI + ":" + appkey + +sig = base64.b64encode(hmac_sha1).rstrip() + + + +# Create request headers + +headers = { + + 'Authorization': 'MC ' + access_key + ':' + sig.decode(), + + 'x-mc-app-id': app_id, + + 'x-mc-date': hdr_date, + + 'x-mc-req-id': request_id, + + 'Content-Type': 'application/json' + +} + + + +payload = { + + 'data': [\ +\ + {\ +\ + "searchBy": {\ +\ + "value": "String",\ +\ + "fieldName": "String"\ +\ + },\ +\ + "start": "2015-11-16T14:49:18+0000",\ +\ + "admin": true,\ +\ + "end": "2015-11-16T14:49:18+0000"\ +\ + }\ +\ + ] + + } + + + +r = requests.post(url=url, headers=headers, data=str(payload)) + + + +print(r.text) +``` + +``` + +static void Main(string[] args) + + { + + //Setup required variables + + string baseUrl = "https://xx-api.mimecast.com"; + + string uri = "/api/gateway/get-hold-message-list"; + + string accessKey = "YOUR ACCESS KEY"; + + string secretKey = "YOUR SECRET KEY"; + + string appId = "YOUR APPLICATION ID"; + + string appKey = "YOUR APPLICATION KEY"; + + + + //Generate request header values + + string hdrDate = System.DateTime.Now.ToUniversalTime().ToString("R"); + + string requestId = System.Guid.NewGuid().ToString(); + + + + //Create the HMAC SHA1 of the Base64 decoded secret key for the Authorization header + + System.Security.Cryptography.HMAC h = new System.Security.Cryptography.HMACSHA1(System.Convert.FromBase64String(secretKey)); + + + + //Use the HMAC SHA1 value to sign the hdrDate + ":" requestId + ":" + URI + ":" + appkey + + byte[] hash = h.ComputeHash(System.Text.Encoding.Default.GetBytes(hdrDate + ":" + requestId + ":" + uri + ":" + appKey)); + + + + //Build the signature to be included in the Authorization header in your request + + string signature = "MC " + accessKey + ":" + System.Convert.ToBase64String(hash); + + + + //Build Request + + System.Net.HttpWebRequest request = (System.Net.HttpWebRequest)System.Net.WebRequest.Create(baseUrl + uri); + + request.Method = "POST"; + + request.ContentType = "application/json"; + + + + //Add Headers + + request.Headers[System.Net.HttpRequestHeader.Authorization] = signature; + + request.Headers.Add("x-mc-date", hdrDate); + + request.Headers.Add("x-mc-req-id", requestId); + + request.Headers.Add("x-mc-app-id", appId); + + + + //Add request body + + //Create and write data to stream + + string postData = @"{ + + ""data"": [\ +\ + {\ +\ + ""searchBy"": {\ +\ + ""value"": ""String"",\ +\ + ""fieldName"": ""String""\ +\ + },\ +\ + ""start"": ""2015-11-16T14:49:18+0000"",\ +\ + ""admin"": true,\ +\ + ""end"": ""2015-11-16T14:49:18+0000""\ +\ + }\ +\ + ] + + }"; + + + + byte[] payload = System.Text.Encoding.UTF8.GetBytes(postData); + + + + System.IO.Stream stream = request.GetRequestStream(); + + stream.Write(payload, 0, payload.Length); + + stream.Close(); + + + + //Send Request + + System.Net.HttpWebResponse response = (System.Net.HttpWebResponse)request.GetResponse(); + + + + //Output response to console + + System.IO.StreamReader reader = new System.IO.StreamReader(response.GetResponseStream()); + + string responseBody = ""; + + string temp = null; + + while ((temp = reader.ReadLine()) != null) + + { + + responseBody += temp; + + }; + + System.Console.WriteLine(responseBody); + + System.Console.ReadLine(); + + } +``` + +``` + +#Setup required variables + +$baseUrl = "https://xx-api.mimecast.com" + +$uri = "/api/gateway/get-hold-message-list" + +$url = $baseUrl + $uri + +$accessKey = "YOUR ACCESS KEY" + +$secretKey = "YOUR SECRET KEY" + +$appId = "YOUR APPLICATION ID" + +$appKey = "YOUR APPLICATION KEY" + + + +#Generate request header values + +$hdrDate = (Get-Date).ToUniversalTime().ToString("ddd, dd MMM yyyy HH:mm:ss UTC") + +$requestId = [guid]::NewGuid().guid + + + +#Create the HMAC SHA1 of the Base64 decoded secret key for the Authorization header + +$sha = New-Object System.Security.Cryptography.HMACSHA1 + +$sha.key = [Convert]::FromBase64String($secretKey) + +$sig = $sha.ComputeHash([Text.Encoding]::UTF8.GetBytes($hdrDate + ":" + $requestId + ":" + $uri + ":" + $appKey)) + +$sig = [Convert]::ToBase64String($sig) + + + +#Create Headers + +$headers = @{"Authorization" = "MC " + $accessKey + ":" + $sig; + + "x-mc-date" = $hdrDate; + + "x-mc-app-id" = $appId; + + "x-mc-req-id" = $requestId; + + "Content-Type" = "application/json"} + + + +#Create post body + +$postBody = "{ + + ""data"": [\ +\ + {\ +\ + ""searchBy"": {\ +\ + ""value"": ""String"",\ +\ + ""fieldName"": ""String""\ +\ + },\ +\ + ""start"": ""2015-11-16T14:49:18+0000"",\ +\ + ""admin"": true,\ +\ + ""end"": ""2015-11-16T14:49:18+0000""\ +\ + }\ +\ + ] + + }" + + + +#Send Request + +$response = Invoke-RestMethod -Method Post -Headers $headers -Body $postBody -Uri $url + + + +#Print the response + +$response +``` + +``` + +public static void main(String[] args) throws java.io.IOException, java.security.NoSuchAlgorithmException, java.security.InvalidKeyException { + + + + //set up variables for request + + String baseUrl = "https://xx-api.mimecast.com"; + + String uri = "/api/gateway/get-hold-message-list"; + + String url = "https://" + baseUrl + uri; + + String accessKey = "YOUR ACCESS KEY"; + + String secretKey = "YOUR SECRET KEY"; + + String appId = "YOUR APPLICATION ID"; + + String appKey = "YOUR APPLICATION KEY"; + + + + //create URL object + + java.net.URL obj = new java.net.URL(url); + + + + // set guid for x-mc-req-id header + + String guid = java.util.UUID.randomUUID().toString(); + + + + // set date for x-mc-date header + + java.text.SimpleDateFormat sdf = new java.text.SimpleDateFormat("EEE, d MMM yyyy HH:mm:ss z"); + + sdf.setTimeZone(java.util.TimeZone.getTimeZone("UTC")); + + String date = sdf.format(new java.util.Date()); + + + + //create signature for the Authorization header + + String dataToSign = date + ":" + guid + ":" + uri + ":" + appKey; + + String hmacSHA1 = "HmacSHA1"; + + javax.crypto.spec.SecretKeySpec signingKey = new javax.crypto.spec.SecretKeySpec(org.apache.commons.codec.binary.Base64.decodeBase64(secretKey.getBytes()), hmacSHA1); + + javax.crypto.Mac mac = javax.crypto.Mac.getInstance(hmacSHA1); + + mac.init(signingKey); + + String sig = new String(org.apache.commons.codec.binary.Base64.encodeBase64(mac.doFinal(dataToSign.getBytes()))); + + + + // create request object + + javax.net.ssl.HttpsURLConnection con = (javax.net.ssl.HttpsURLConnection) obj.openConnection(); + + + + //set request type to POST + + con.setRequestMethod("POST"); + + con.setDoOutput(true); + + + + //add reuqest headers + + con.setRequestProperty("Authorization", "MC " + accessKey + ":" + sig); + + con.setRequestProperty("x-mc-req-id", guid); + + con.setRequestProperty("x-mc-app-id", appId); + + con.setRequestProperty("x-mc-date", date); + + con.setRequestProperty("Content-Type", "application/json"); + + con.setRequestProperty("Accept", "application/json"); + + + + //Add post body to the request + + String postBody = "{\n" + + + " \"data\": [\n" +\ +\ + " {\n" +\ +\ + " \"searchBy\": {\n" +\ +\ + " \"value\": \"String\",\n" +\ +\ + " \"fieldName\": \"String\"\n" +\ +\ + " }\n" +\ +\ + " \"start\": \"2015-11-16T14:49:18+0000\",\n" +\ +\ + " \"admin\": true,\n" +\ +\ + " \"end\": \"2015-11-16T14:49:18+0000\"\n" +\ +\ + " }\n" +\ +\ + " ]\n" + + + "}"; + + java.io.OutputStream os = con.getOutputStream(); + + os.write(postBody.getBytes("UTF-8")); + + os.close(); + + + + //process response + + java.io.BufferedReader in = new java.io.BufferedReader( + + new java.io.InputStreamReader(con.getInputStream())); + + String inputLine; + + StringBuffer response = new StringBuffer(); + + + + while ((inputLine = in.readLine()) != null) { + + response.append(inputLine); + + } + + in.close(); + + + + //return result + + java.lang.System.out.println(response.toString()); + + } +``` + +![Mimecast-White-Logo.png](https://assets.mimecast.com/api/public/content/9610786917994c9abf8bdbed75cc8f5a?v=890c9fbb) + +[Privacy Statement](https://www.mimecast.com/legal/privacy-statement/) + +[Legal](https://www.mimecast.com/legal/) + +[Privacy Preferences](https://www.mimecast.com/privacy-preferences/) + +[Responsible Disclosure](https://www.mimecast.com/responsible-disclosure/) + +© 2003 – 2026 Mimecast Services limited. + +[Back to Top](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#) \ No newline at end of file diff --git a/.firecrawl/mimecast-hold.json b/.firecrawl/mimecast-hold.json new file mode 100644 index 0000000..398f11f --- /dev/null +++ b/.firecrawl/mimecast-hold.json @@ -0,0 +1 @@ +{"success":true,"data":{"web":[{"url":"https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/","title":"Get Hold Message List - API and Integrations | Mimecast","description":"This API endpoint can be used to get information about held messages, including the reason, hold level, sender and recipients.","position":1,"markdown":"**In this guide:**\n\n- [Description](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#description)\n- [Pre-requisites](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#pre-requisites)\n- [URI](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#uri)\n- [Request Headers](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#request-headers)\n- [Request Body](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#request-body)\n- [Response](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#response)\n- [Sample Code](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#sample-code)\n\n#### Description\n\nThis API endpoint can be used to get information about held messages, including the reason, hold level, sender and recipients. The ID can be used to act on a message using the Release Message or Reject Message API endpoints.\n\n#### Pre-requisites\n\n- In order to successfully use this endpoint the logged in user must be a Mimecast administrator with at least the **Account \\| Dashboard \\| Read** permission.\n\n#### URI\n\nTo use this endpoint you send a POST request to:\n\n- /api/gateway/get-hold-message-list\n\n#### Request Headers\n\nThe following request headers must be included in your request:\n\n| **Field** | **Description** |\n| --- | --- |\n| Authorization | Please see the [Authorization](https://integrations.mimecast.com/documentation/api-overview/authorization/) guide for more information on building the Authorization header. |\n| x-mc-req-id | A randomly generated GUID, for example,
```
8578FCFC-A305-4D9A-99CB-F4D5ECEFE297
``` |\n| x-mc-app-id | The Application ID provided with your Registered API Application. |\n| x-mc-date | The current date and time in the following format, for example,
```
Tue, 24 Nov 2015 12:50:11 UTC
``` |\n\n#### Request Body\n\n```\n\n{\n\n \"data\": [\\\n\\\n {\\\n\\\n \"admin\": true,\\\n\\\n \"start\": \"2015-11-16T14:49:18+0000\",\\\n\\\n \"searchBy\": {\\\n\\\n \"fieldName\": \"String\",\\\n\\\n \"value\": \"String\"\\\n\\\n },\\\n\\\n \"end\": \"2015-11-16T14:49:18+0000\"\\\n\\\n }\\\n\\\n ]\n\n}\n```\n\n##### data\n\n| **Field** | **Type** | **Required** | **Description** |\n| --- | --- | --- | --- |\n| admin | Boolean | Optional | Level of results to return. If false, only results for the currenlty authenticated user will be returned. If true, held messages for all recipients will be returned. The default value is false. |\n| searchBy | Object | Optional | Object data used to filter results |\n| start | Date String | Optional | The date and time of the earliest message to return, in the following format, 2011-12-03T10:15:30+0000 |\n| end | Date String | Optional | The date and time of the latest message to return, in the following format, 2011-12-03T10:15:30+0000 |\n\n##### searchBy\n\n| **Field** | **Type** | **Required** | **Description** |\n| --- | --- | --- | --- |\n| value | String | Optional | The text used to filter results |\n| fieldName | String | Optional | Message fields to filter based on. Possible values are: all, subject, sender, recipient, reason\\_code |\n\n#### Response\n\n```\n\n{\n\n \"fail\": [],\n\n \"meta\": {\n\n \"status\": 200\n\n },\n\n \"data\": [\\\n\\\n {\\\n\\\n \"dateReceived\": \"String\",\\\n\\\n \"reason\": \"String\",\\\n\\\n \"reasonCode\": \"String\",\\\n\\\n \"id\": \"String\",\\\n\\\n \"size\": 1000,\\\n\\\n \"from\": {\\\n\\\n \"displayableName\": \"String\",\\\n\\\n \"emailAddress\": \"String\"\\\n\\\n },\\\n\\\n \"hasAttachments\": \"true\",\\\n\\\n \"route\": \"String\",\\\n\\\n \"policyInfo\": \"String\",\\\n\\\n \"fromHeader\": {\\\n\\\n \"displayableName\": \"String\",\\\n\\\n \"emailAddress\": \"String\"\\\n\\\n },\\\n\\\n \"to\": {\\\n\\\n \"displayableName\": \"String\",\\\n\\\n \"emailAddress\": \"String\"\\\n\\\n },\\\n\\\n \"reasonId\": \"String\",\\\n\\\n \"subject\": \"String\"\\\n\\\n }\\\n\\\n ]\n\n}\n```\n\n##### meta object\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| status | Number | The function level status of the request. |\n\n##### meta\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| status | Number | The function level status of the request. |\n\n##### data\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| id | String | The Mimecast secure ID for a message |\n| reason | String | The summary reason for holding the message |\n| reasonId | String | Mirrors the reason field, formatted without spaces. However, reasonCode should be used instead |\n| reasonCode | String | Reason code for holding the message |\n| from | Object | Contains the envelope sender information |\n| fromHeader | Object | Contains the header sender information |\n| to | Object | Contains the envelope recipient information |\n| toHeader | Object | Contains the header recipient information |\n| subject | String | The message subject |\n| route | String | Direction of message being held. Possible values are: INBOUND, OUTBOUND, INTERNAL, EXTERNAL |\n| hasAttachments | Boolean | Returns true if the message contains attachments. False indicates no attachments |\n| size | Integer | The size of the message in bytes |\n| dateReceived | Date String | The timestamp of the message transmission |\n| policyInfo | String | Information or definition name triggering the message hold action |\n\n#### Sample Code\n\nSample code is provided to demonstrate how to use the API and is not representative of a production application. To use the sample code; complete the required variables as described, populate the desired values in the request body, and execute in your favorite IDE.  Please see the [Global Base URL's](https://integrations.mimecast.com/documentation/api-overview/global-base-urls/) page to find the correct base URL to use for your account.\n\nHTTPPythonC#PowerShellJava\n\n```\n\nPOST {base_url}/api/gateway/get-hold-message-list\n\nAuthorization: MC {accesskKey}:{Base64 encoded signed Data To Sign}\n\nx-mc-date: {dateTime}\n\nx-mc-req-id: {unique id}\n\nx-mc-app-id: {applicationId}\n\nContent-Type: application/json\n\nAccept: application/json\n\n\n\n{\n\n \"data\":[\\\n\\\n {\\\n\\\n \"data\":[\\\n\\\n {\\\n\\\n \"searchBy\": {\\\n\\\n \"value\": \"String\",\\\n\\\n \"fieldName\": \"String\"\\\n\\\n },\\\n\\\n \"start\": \"2015-11-16T14:49:18+0000\",\\\n\\\n \"admin\": true,\\\n\\\n \"end\": \"2015-11-16T14:49:18+0000\"\\\n\\\n }\\\n\\\n ]\\\n\\\n }\\\n\\\n ]\n\n}\n```\n\n```\n\nimport base64\n\nimport hashlib\n\nimport hmac\n\nimport uuid\n\nimport datetime\n\nimport requests\n\n\n\n# Setup required variables\n\nbase_url = \"https://xx-api.mimecast.com\"\n\nuri = \"/api/gateway/get-hold-message-list\"\n\nurl = base_url + uri\n\naccess_key = \"YOUR ACCESS KEY\"\n\nsecret_key = \"YOUR SECRET KEY\"\n\napp_id = \"YOUR APPLICATION ID\"\n\napp_key = \"YOUR APPLICATION KEY\"\n\n\n\n# Generate request header values\n\nrequest_id = str(uuid.uuid4())\n\nhdr_date = datetime.datetime.utcnow().strftime(\"%a, %d %b %Y %H:%M:%S\") + \" UTC\"\n\n\n\n# DataToSign is used in hmac_sha1\n\ndataToSign = ':'.join([hdr_date, request_id, uri, app_key])\n\n\n\n# Create the HMAC SHA1 of the Base64 decoded secret key for the Authorization header\n\nhmac_sha1 = hmac.new(base64.b64decode(secret_key), dataToSign.encode(), digestmod=hashlib.sha1).digest()\n\n\n\n# Use the HMAC SHA1 value to sign the hdrDate + \":\" requestId + \":\" + URI + \":\" + appkey\n\nsig = base64.b64encode(hmac_sha1).rstrip()\n\n\n\n# Create request headers\n\nheaders = {\n\n 'Authorization': 'MC ' + access_key + ':' + sig.decode(),\n\n 'x-mc-app-id': app_id,\n\n 'x-mc-date': hdr_date,\n\n 'x-mc-req-id': request_id,\n\n 'Content-Type': 'application/json'\n\n}\n\n\n\npayload = {\n\n 'data': [\\\n\\\n {\\\n\\\n \"searchBy\": {\\\n\\\n \"value\": \"String\",\\\n\\\n \"fieldName\": \"String\"\\\n\\\n },\\\n\\\n \"start\": \"2015-11-16T14:49:18+0000\",\\\n\\\n \"admin\": true,\\\n\\\n \"end\": \"2015-11-16T14:49:18+0000\"\\\n\\\n }\\\n\\\n ]\n\n }\n\n\n\nr = requests.post(url=url, headers=headers, data=str(payload))\n\n\n\nprint(r.text)\n```\n\n```\n\nstatic void Main(string[] args)\n\n {\n\n //Setup required variables\n\n string baseUrl = \"https://xx-api.mimecast.com\";\n\n string uri = \"/api/gateway/get-hold-message-list\";\n\n string accessKey = \"YOUR ACCESS KEY\";\n\n string secretKey = \"YOUR SECRET KEY\";\n\n string appId = \"YOUR APPLICATION ID\";\n\n string appKey = \"YOUR APPLICATION KEY\";\n\n\n\n //Generate request header values\n\n string hdrDate = System.DateTime.Now.ToUniversalTime().ToString(\"R\");\n\n string requestId = System.Guid.NewGuid().ToString();\n\n\n\n //Create the HMAC SHA1 of the Base64 decoded secret key for the Authorization header\n\n System.Security.Cryptography.HMAC h = new System.Security.Cryptography.HMACSHA1(System.Convert.FromBase64String(secretKey));\n\n\n\n //Use the HMAC SHA1 value to sign the hdrDate + \":\" requestId + \":\" + URI + \":\" + appkey\n\n byte[] hash = h.ComputeHash(System.Text.Encoding.Default.GetBytes(hdrDate + \":\" + requestId + \":\" + uri + \":\" + appKey));\n\n\n\n //Build the signature to be included in the Authorization header in your request\n\n string signature = \"MC \" + accessKey + \":\" + System.Convert.ToBase64String(hash);\n\n\n\n //Build Request\n\n System.Net.HttpWebRequest request = (System.Net.HttpWebRequest)System.Net.WebRequest.Create(baseUrl + uri);\n\n request.Method = \"POST\";\n\n request.ContentType = \"application/json\";\n\n\n\n //Add Headers\n\n request.Headers[System.Net.HttpRequestHeader.Authorization] = signature;\n\n request.Headers.Add(\"x-mc-date\", hdrDate);\n\n request.Headers.Add(\"x-mc-req-id\", requestId);\n\n request.Headers.Add(\"x-mc-app-id\", appId);\n\n\n\n //Add request body\n\n //Create and write data to stream\n\n string postData = @\"{\n\n \"\"data\"\": [\\\n\\\n {\\\n\\\n \"\"searchBy\"\": {\\\n\\\n \"\"value\"\": \"\"String\"\",\\\n\\\n \"\"fieldName\"\": \"\"String\"\"\\\n\\\n },\\\n\\\n \"\"start\"\": \"\"2015-11-16T14:49:18+0000\"\",\\\n\\\n \"\"admin\"\": true,\\\n\\\n \"\"end\"\": \"\"2015-11-16T14:49:18+0000\"\"\\\n\\\n }\\\n\\\n ]\n\n }\";\n\n\n\n byte[] payload = System.Text.Encoding.UTF8.GetBytes(postData);\n\n\n\n System.IO.Stream stream = request.GetRequestStream();\n\n stream.Write(payload, 0, payload.Length);\n\n stream.Close();\n\n\n\n //Send Request\n\n System.Net.HttpWebResponse response = (System.Net.HttpWebResponse)request.GetResponse();\n\n\n\n //Output response to console\n\n System.IO.StreamReader reader = new System.IO.StreamReader(response.GetResponseStream());\n\n string responseBody = \"\";\n\n string temp = null;\n\n while ((temp = reader.ReadLine()) != null)\n\n {\n\n responseBody += temp;\n\n };\n\n System.Console.WriteLine(responseBody);\n\n System.Console.ReadLine();\n\n }\n```\n\n```\n\n#Setup required variables\n\n$baseUrl = \"https://xx-api.mimecast.com\"\n\n$uri = \"/api/gateway/get-hold-message-list\"\n\n$url = $baseUrl + $uri\n\n$accessKey = \"YOUR ACCESS KEY\"\n\n$secretKey = \"YOUR SECRET KEY\"\n\n$appId = \"YOUR APPLICATION ID\"\n\n$appKey = \"YOUR APPLICATION KEY\"\n\n\n\n#Generate request header values\n\n$hdrDate = (Get-Date).ToUniversalTime().ToString(\"ddd, dd MMM yyyy HH:mm:ss UTC\")\n\n$requestId = [guid]::NewGuid().guid\n\n\n\n#Create the HMAC SHA1 of the Base64 decoded secret key for the Authorization header\n\n$sha = New-Object System.Security.Cryptography.HMACSHA1\n\n$sha.key = [Convert]::FromBase64String($secretKey)\n\n$sig = $sha.ComputeHash([Text.Encoding]::UTF8.GetBytes($hdrDate + \":\" + $requestId + \":\" + $uri + \":\" + $appKey))\n\n$sig = [Convert]::ToBase64String($sig)\n\n\n\n#Create Headers\n\n$headers = @{\"Authorization\" = \"MC \" + $accessKey + \":\" + $sig;\n\n \"x-mc-date\" = $hdrDate;\n\n \"x-mc-app-id\" = $appId;\n\n \"x-mc-req-id\" = $requestId;\n\n \"Content-Type\" = \"application/json\"}\n\n\n\n#Create post body\n\n$postBody = \"{\n\n \"\"data\"\": [\\\n\\\n {\\\n\\\n \"\"searchBy\"\": {\\\n\\\n \"\"value\"\": \"\"String\"\",\\\n\\\n \"\"fieldName\"\": \"\"String\"\"\\\n\\\n },\\\n\\\n \"\"start\"\": \"\"2015-11-16T14:49:18+0000\"\",\\\n\\\n \"\"admin\"\": true,\\\n\\\n \"\"end\"\": \"\"2015-11-16T14:49:18+0000\"\"\\\n\\\n }\\\n\\\n ]\n\n }\"\n\n\n\n#Send Request\n\n$response = Invoke-RestMethod -Method Post -Headers $headers -Body $postBody -Uri $url\n\n\n\n#Print the response\n\n$response\n```\n\n```\n\npublic static void main(String[] args) throws java.io.IOException, java.security.NoSuchAlgorithmException, java.security.InvalidKeyException {\n\n\n\n //set up variables for request\n\n String baseUrl = \"https://xx-api.mimecast.com\";\n\n String uri = \"/api/gateway/get-hold-message-list\";\n\n String url = \"https://\" + baseUrl + uri;\n\n String accessKey = \"YOUR ACCESS KEY\";\n\n String secretKey = \"YOUR SECRET KEY\";\n\n String appId = \"YOUR APPLICATION ID\";\n\n String appKey = \"YOUR APPLICATION KEY\";\n\n\n\n //create URL object\n\n java.net.URL obj = new java.net.URL(url);\n\n\n\n // set guid for x-mc-req-id header\n\n String guid = java.util.UUID.randomUUID().toString();\n\n\n\n // set date for x-mc-date header\n\n java.text.SimpleDateFormat sdf = new java.text.SimpleDateFormat(\"EEE, d MMM yyyy HH:mm:ss z\");\n\n sdf.setTimeZone(java.util.TimeZone.getTimeZone(\"UTC\"));\n\n String date = sdf.format(new java.util.Date());\n\n\n\n //create signature for the Authorization header\n\n String dataToSign = date + \":\" + guid + \":\" + uri + \":\" + appKey;\n\n String hmacSHA1 = \"HmacSHA1\";\n\n javax.crypto.spec.SecretKeySpec signingKey = new javax.crypto.spec.SecretKeySpec(org.apache.commons.codec.binary.Base64.decodeBase64(secretKey.getBytes()), hmacSHA1);\n\n javax.crypto.Mac mac = javax.crypto.Mac.getInstance(hmacSHA1);\n\n mac.init(signingKey);\n\n String sig = new String(org.apache.commons.codec.binary.Base64.encodeBase64(mac.doFinal(dataToSign.getBytes())));\n\n\n\n // create request object\n\n javax.net.ssl.HttpsURLConnection con = (javax.net.ssl.HttpsURLConnection) obj.openConnection();\n\n\n\n //set request type to POST\n\n con.setRequestMethod(\"POST\");\n\n con.setDoOutput(true);\n\n\n\n //add reuqest headers\n\n con.setRequestProperty(\"Authorization\", \"MC \" + accessKey + \":\" + sig);\n\n con.setRequestProperty(\"x-mc-req-id\", guid);\n\n con.setRequestProperty(\"x-mc-app-id\", appId);\n\n con.setRequestProperty(\"x-mc-date\", date);\n\n con.setRequestProperty(\"Content-Type\", \"application/json\");\n\n con.setRequestProperty(\"Accept\", \"application/json\");\n\n\n\n //Add post body to the request\n\n String postBody = \"{\\n\" +\n\n \" \\\"data\\\": [\\n\" +\\\n\\\n \" {\\n\" +\\\n\\\n \" \\\"searchBy\\\": {\\n\" +\\\n\\\n \" \\\"value\\\": \\\"String\\\",\\n\" +\\\n\\\n \" \\\"fieldName\\\": \\\"String\\\"\\n\" +\\\n\\\n \" }\\n\" +\\\n\\\n \" \\\"start\\\": \\\"2015-11-16T14:49:18+0000\\\",\\n\" +\\\n\\\n \" \\\"admin\\\": true,\\n\" +\\\n\\\n \" \\\"end\\\": \\\"2015-11-16T14:49:18+0000\\\"\\n\" +\\\n\\\n \" }\\n\" +\\\n\\\n \" ]\\n\" +\n\n \"}\";\n\n java.io.OutputStream os = con.getOutputStream();\n\n os.write(postBody.getBytes(\"UTF-8\"));\n\n os.close();\n\n\n\n //process response\n\n java.io.BufferedReader in = new java.io.BufferedReader(\n\n new java.io.InputStreamReader(con.getInputStream()));\n\n String inputLine;\n\n StringBuffer response = new StringBuffer();\n\n\n\n while ((inputLine = in.readLine()) != null) {\n\n response.append(inputLine);\n\n }\n\n in.close();\n\n\n\n //return result\n\n java.lang.System.out.println(response.toString());\n\n }\n```\n\n[Back to Top](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/#)","metadata":{"og:url":"https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/","language":"en","ogUrl":"https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/","description":"Mimecast API Get Hold Message List","ogTitle":"Get Hold Message List","theme-color":"#ffffff","VIcurrentDateTime":["639106058921755078>","639106058921755120"],"VirtualFolder":["\\","/"],"author":"mimecast","ogDescription":"Mimecast API Get Hold Message List","title":"Get Hold Message List | Mimecast","viewport":"width=device-width, initial-scale=1, shrink-to-fit=no","og:title":"Get Hold Message List","ogSiteName":"Mimecast","og:description":"Mimecast API Get Hold Message List","twitter:card":"summary_large_image","og:site_name":"Mimecast","robots":"index, follow","favicon":"https://integrations.mimecast.com/sc-static/img/favicons/icons_m_192x192.png","scrapeId":"019d46c9-4df1-70ca-9269-b003b417d54f","sourceURL":"https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/","url":"https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/","statusCode":200,"contentType":"text/html; charset=utf-8","timezone":"America/New_York","proxyUsed":"basic","cacheState":"miss","indexId":"075cdec3-20a7-4ba3-8991-f5662657cd06","creditsUsed":1}},{"url":"https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420576659-API-Integrations-New-API-Endpoints-Sep-2024","title":"API & Integrations - New API Endpoints - Sep 2024 – Mimecast","description":"Mimecast is pleased to announce the general availability of Secure Email Gateway Restful API Endpoints that allow users to configure and manage User and Group ...","position":2,"markdown":"Service Updates!\n\nTo stay informed, please visit the [Service Updates](https://mimecastsupport.zendesk.com/hc/en-us/sections/36032561852563-Service-Updates) page and click the _**Follow**_ button. Thank you!\n\nClose\n\n[Skip to main content](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420576659-API-Integrations-New-API-Endpoints-Sep-2024#main-content)\n\nBrowse help topics\n\n- Application Downloads\n\n\n\n - Application Downloads\n\n\n- Knowledge Hubs\n\n\n\n - Core Security Products\n\n\n\n - Email Security - API\n\n\n\n - Onboarding\n\n - Guides\n\n - Analysis & Response\n\n - Human Risk Command Center\n\n - Archive\n\n - Services\n\n - Users & Groups\n\n\n\n - Authentication\n\n - Applications\n\n - Attributes\n\n - Directory Synchronization\n\n - Directories\n\n\n - Policies\n\n - Integrations\n\n - Account\n\n\n - Email Security - MX\n\n\n\n - Guides & Resources\n\n - Administration\n\n - Analysis & Response\n\n - Brand Indicators Message Identification (BIMI)\n\n - Connect Application\n\n - Connect Process\n\n - Content Examination\n\n - Continuity\n\n\n\n - Guides & Resources\n\n\n - Directory Synchronization\n\n - DNS-based Authentication of Named Entities (DANE)\n\n - Email Security Setup Wizard\n\n - Exchange\n\n - Journaling\n\n - Mail Flow\n\n - Message Routing\n\n - Mimecast Administration Console\n\n\n\n - Advanced Account Administration / Federated Account Administration\n\n - Message Center\n\n\n\n - Accepted Messages\n\n - Bounced Messages\n\n - Held Messages\n\n - Message Tracking\n\n - Rejected & Deferred Messages\n\n\n - Account\n\n\n\n - Account Settings\n\n - Audit Logs\n\n - Roles\n\n\n - Directories\n\n - Services\n\n\n\n - Applications\n\n - Authentication\n\n - Authentication Profiles\n\n - Secure Messages\n\n - SMS Dashboard\n\n\n - Notification Sets\n\n - Policies\n\n - Reporting\n\n\n\n - Mimecast Account Assessment Report\n\n\n - Spam / Phishing\n\n - Security & Efficacy\n\n - Service Monitor\n\n - Targeted Threat Protection\n\n\n\n - Attachment Protect\n\n\n\n - Guides & Resources\n\n\n - Impersonation Protect\n\n\n\n - Guides & Resources\n\n\n - Internal Email Protect\n\n - URL Protect\n\n\n\n - Guides & Resources\n\n\n - Threat Intelligence & Remediation\n\n\n - Email Security Cloud Integrated\n\n\n\n - Guides & Resources\n\n - Getting Started\n\n - Awareness Training\n\n - Configuration\n\n - User Management\n\n - Home\n\n - Detections\n\n - Mail Flow\n\n - Reporting & Analytics\n\n - Audit Logs\n\n - Advanced BEC\n\n - Engage\n\n - Collaboration Security\n\n\n\n - Protection for Sharepoint & OneDrive\n\n - Protection for Microsoft Teams\n\n\n - DMARC Analyzer\n\n - Sync & Recover\n\n - Targeted Threat Protection Attachment Protect\n\n\n - Security Add-Ons\n\n\n\n - DMARC Analyzer 2.0\n\n - Large File Send\n\n\n\n - Guides & Resources\n\n\n - Advanced BEC\n\n - Browser Isolation\n\n - Collaboration Security\n\n\n\n - Guides & Resources\n\n\n - Brand Exploit Protect\n\n\n\n - Guides & Resources\n\n\n - CyberGraph\n\n\n\n - Guides & Resources\n\n - Misaddressed Email Protect\n\n\n - DMARC Analyzer\n\n\n\n - Guides & Resources\n\n\n - Secure Messaging\n\n\n\n - Guides & Resources\n\n\n - Web Security\n\n\n\n - Guides & Resources\n\n - Overview\n\n - Configuration\n\n - Reporting\n\n - General\n\n - Mimecast Security Agent for iOS\n\n - Mimecast Security Agent for Mac\n\n - Mimecast Security Agent for Windows\n\n - Mimecast Security Agent for Windows Server\n\n - Troubleshooting\n\n\n - Human Risk Management\n\n\n\n - Human Risk Command Center\n\n - Incydr\n\n\n\n - Incydr administration\n\n\n\n - Incydr console reference\n\n - Configuring\n\n\n\n - SCIM provisioning\n\n - Identity management\n\n\n - Monitoring and managing\n\n\n\n - Roles resources\n\n - Incydr API resources\n\n - Incydr User Directory Sync resources\n\n - Device migration with the backup agent\n\n - Backup agent reporting\n\n\n - Planning and installing\n\n\n\n - Manage agent installations in your Incydr environment\n\n - Security hardening\n\n - Implement Incydr\n\n\n - Troubleshooting\n\n - Licenses\n\n\n - IRM Launchpad\n\n - Release notes\n\n\n\n - Incydr release notes\n\n - Previous version release notes\n\n\n - Terms and conditions\n\n\n\n - Platform support policy\n\n\n\n - Operating system support policy\n\n\n - Product lifecycle policy\n\n - Incydr customer support resources\n\n\n\n - Incydr product plans\n\n\n - Legal terms and conditions\n\n\n\n - Previous agreements\n\n\n - Compliance resources\n\n - Open source licenses\n\n\n - Announcements\n\n\n\n - Incydr announcements\n\n - Backup add-on announcements\n\n\n - Using the backup agent\n\n\n\n - Get started\n\n - Backup\n\n - Restore files\n\n - Configuring\n\n - Backup agent reference\n\n - Troubleshooting\n\n\n - API & Integrations\n\n\n\n - Guides & Resources\n\n\n - Awareness Training\n\n\n\n - Guides & Resources\n\n - Access & Overview\n\n - Settings & Configuration\n\n\n\n - Settings\n\n - Configuration\n\n - Rapid Deployment\n\n\n - Training Queues\n\n - Phishing Training\n\n - My Training Library\n\n - Reporting\n\n - Troubleshooting\n\n\n - Engage\n\n\n\n - Guides & Resources\n\n - Access and Overview\n\n - Settings & Configuration\n\n\n\n - Rapid Deployment\n\n - Configuration\n\n - Settings\n\n\n - Human Risk\n\n - Training Queues\n\n - Phishing Training\n\n - My Training Library\n\n - Reporting\n\n - Nudges\n\n - Scorecards\n\n - Troubleshooting\n\n\n - Data Governance, Compliance & Insights\n\n\n\n - Aware 2.0\n\n\n\n - Video How-to Tutorials\n\n\n\n - User Data Removal\n\n - Signal\n\n - Search & Discover\n\n - Retention\n\n - Data Hold\n\n\n - Risk Management Suite\n\n\n\n - Search & Discover\n\n - Data Hold\n\n - Retention\n\n\n - Platform Documentation\n\n - Platform Administrator Capabilities\n\n - Community Management & Insights\n\n\n\n - Spotlight\n\n - Signal\n\n - Example Use Cases\n\n\n - Archiving\n\n - Archive for Microsoft Teams\n\n\n\n - Guides & Resources\n\n\n - Case Review\n\n\n\n - Guides & Resources\n\n\n - eDiscovery\n\n - Mimecast Synchronization Engine\n\n - Aware\n\n\n\n - Community Management & Insights\n\n\n\n - Example Use Cases\n\n - Spotlight\n\n - Signal\n\n - Surveys\n\n\n - Risk Management Suite\n\n\n\n - User Data Removal\n\n - Retention\n\n - Data Hold\n\n - Search & Discover\n\n\n - Platform Administrator Capabilities\n\n - Platform Documentation\n\n - Video How-To Tutorials\n\n\n\n - Spotlight\n\n - Signal\n\n - Search & Discover\n\n - Data Hold\n\n - Retention\n\n - User Data Removal\n\n\n - Sync & Recover\n\n\n\n - Guides & Resources\n\n\n - Supervision\n\n\n\n - Guides & Resources\n\n\n - Simply Migrate\n\n\n\n - Guides & Resources\n\n\n - End User & Web Applications\n\n\n\n - User Portal\n\n - End User Assets\n\n - Mimecast Essentials for Outlook\n\n - Mimecast for Mac\n\n\n\n - Installation\n\n - Preferences & Settings\n\n - Using Your Mailboxes\n\n - Archive Folders\n\n - Managed Senders\n\n - Large File Send\n\n - Searching\n\n - Help & Feedback\n\n\n - Mimecast for Outlook\n\n - Mimecast Mobile\n\n\n\n - Installation\n\n - Using Mimecast Mobile\n\n - Configuration\n\n\n - Mimecast Personal Portal\n\n - Stationery\n\n\n - Mimecast Customer Care\n\n\n\n - Customer Alerts Notes\n\n - Mimecast University\n\n\n\n - Guides & Resources\n\n\n - Mimecast Partner\n\n\n\n - Jersey\n\n\n- Known Issues\n\n\n\n - API & Integrations\n\n - Awareness Training\n\n - Case Review\n\n - CyberGraph\n\n - Data Retention\n\n\n\n - Simply Migrate\n\n\n - DMARC Analyzer\n\n - Email Security Cloud Gateway\n\n - Email Security Cloud Integrated\n\n - End User Applications\n\n\n\n - Mimecast Essentials for Outlook\n\n - Mimecast for Mac\n\n - Mimecast Mobile\n\n - Mimecast for Outlook\n\n - Mimecast Personal Portal\n\n\n - Human Risk\n\n - Reporting\n\n - Sync & Recover\n\n - Targeted Threat Protection\n\n\n- Service Updates\n\n\n\n - Service Updates\n\n\n\n - [Engage - AI Phishing Template Generator - Mar 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/49615256488723-Engage-AI-Phishing-Template-Generator-Mar-2026)\n - [Email Security MX - Account Takeover - Mar 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/49854249918099-Email-Security-MX-Account-Takeover-Mar-2026)\n - [CyberGraph - Image Tracker EOL - Mar 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/49682723223443-CyberGraph-Image-Tracker-EOL-Mar-2026)\n - [Aware - Slack Canvas & List Ingestion - Mar 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/49856045983379-Aware-Slack-Canvas-List-Ingestion-Mar-2026)\n - [Email Security - API - Integration Updates - Mar 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/49578960145939-Email-Security-API-Integration-Updates-Mar-2026)\n - [API & Integrations - Partner Tiles - Mar 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/49477276604179-API-Integrations-Partner-Tiles-Mar-2026)\n - [API & Integrations - Threat Share Filtering Enhancement - Mar 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/49451073844499-API-Integrations-Threat-Share-Filtering-Enhancement-Mar-2026)\n - [User Portal - Open Beta - Mar 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/49448743876499-User-Portal-Open-Beta-Mar-2026)\n - [API & Integrations - Cisco XDR Integration - Mar 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/49159095637011-API-Integrations-Cisco-XDR-Integration-Mar-2026)\n - [API & Integrations - Event Push UI Update - Mar 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/49283209404563-API-Integrations-Event-Push-UI-Update-Mar-2026)\n - [Mimecast Customer Care - Scheduled Maintenance RSA Region - Feb 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/49448769794067-Mimecast-Customer-Care-Scheduled-Maintenance-RSA-Region-Feb-2026)\n - [Browser Isolation - Integration Changes - Feb 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/49244785207187-Browser-Isolation-Integration-Changes-Feb-2026)\n - [Analysis & Response - Enhanced Reported Emails Dashboard - Feb 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/49024123179795-Analysis-Response-Enhanced-Reported-Emails-Dashboard-Feb-2026)\n - [Archive Search - Time Picker Support - Feb 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/49056341987347-Archive-Search-Time-Picker-Support-Feb-2026)\n - [Awareness Training - Streamlined Navigation - Mar 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/48952358322835-Awareness-Training-Streamlined-Navigation-Mar-2026)\n - [Engage - Streamlined Navigation - Mar 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/48952237880083-Engage-Streamlined-Navigation-Mar-2026)\n - [Awareness Training - Phishing Simulation with Attachments - Feb 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/48841964996499-Awareness-Training-Phishing-Simulation-with-Attachments-Feb-2026)\n - [Engage - Phishing Simulation with Attachments - Feb 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/48841679709075-Engage-Phishing-Simulation-with-Attachments-Feb-2026)\n - [Archiving - Search & Discover Improvements - Feb 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/48839561896723-Archiving-Search-Discover-Improvements-Feb-2026)\n - [API & Integrations - CrowdStrike Threat Share URL Enhancements - Feb 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/48839342828563-API-Integrations-CrowdStrike-Threat-Share-URL-Enhancements-Feb-2026)\n - [Policies - RTF Attachment Blocking Update - Jan 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/48641956382355-Policies-RTF-Attachment-Blocking-Update-Jan-2026)\n - [DMARC Analyzer 2.0 - Jan 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/48569977349651-DMARC-Analyzer-2-0-Jan-2026)\n - [Mimecast Administration Console - Governance & Compliance Menu Update - Jan 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/48536561062803-Mimecast-Administration-Console-Governance-Compliance-Menu-Update-Jan-2026)\n - [Aware - Simplified User Onboarding - Jan 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/48395474801555-Aware-Simplified-User-Onboarding-Jan-2026)\n - [API & Integrations - Application Management - Jan 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/48328610333587-API-Integrations-Application-Management-Jan-2026)\n - [API & Integrations - Threat Share URL Sharing - Jan 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/48328580736147-API-Integrations-Threat-Share-URL-Sharing-Jan-2026)\n - [Human Risk Command Center - Watchlist Rules Manager - Jan 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/46199309567379-Human-Risk-Command-Center-Watchlist-Rules-Manager-Jan-2026)\n - [Multi-Vector Threat Protection - Availablity Update - Jan 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/48330834542099-Multi-Vector-Threat-Protection-Availablity-Update-Jan-2026)\n - [API & Integrations - Status Details - Jan 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/48327808925715-API-Integrations-Status-Details-Jan-2026)\n - [Email Security Cloud Gateway - Archive Search Upgrade - Jan 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/47500424529171-Email-Security-Cloud-Gateway-Archive-Search-Upgrade-Jan-2026)\n - [Mimecast Partner - Partner Admin Access to Email Security Onboarding Restored - Jan 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/48130179284883-Mimecast-Partner-Partner-Admin-Access-to-Email-Security-Onboarding-Restored-Jan-2026)\n - [Engage - URL Click False Positive Remediation - Jan 2026](https://mimecastsupport.zendesk.com/hc/en-us/articles/47189702455443-Engage-URL-Click-False-Positive-Remediation-Jan-2026)\n - [Awareness Training - Direct Message Injection Update - Dec 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/47480583403283-Awareness-Training-Direct-Message-Injection-Update-Dec-2025)\n - [Engage - Direct Message Injection Update - Dec 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/47227302154003-Engage-Direct-Message-Injection-Update-Dec-2025)\n - [Multi-Vector Threat Protection - Dec 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/46317566732435-Multi-Vector-Threat-Protection-Dec-2025)\n - [Onboarding - New Modular Onboarding - Dec 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/44129759309075-Onboarding-New-Modular-Onboarding-Dec-2025)\n - [Aware 2.0 - Google Chat Integration - Dec 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/47258309365907-Aware-2-0-Google-Chat-Integration-Dec-2025)\n - [Archiving - Search & Discover for Email - Dec 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/46625362130323-Archiving-Search-Discover-for-Email-Dec-2025)\n - [Archiving - Archive Search Reporting Updates - Dec 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/46985139455123-Archiving-Archive-Search-Reporting-Updates-Dec-2025)\n - [Engage - US Season 8 - Dec 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/47190912579987-Engage-US-Season-8-Dec-2025)\n - [Awareness Training - US Season 8 - Dec 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/47190276429971-Awareness-Training-US-Season-8-Dec-2025)\n - [Confirmation and Analyst Classification for CyberGraph Reports in MEIR - Dec 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/47079339078803-Confirmation-and-Analyst-Classification-for-CyberGraph-Reports-in-MEIR-Dec-2025)\n - [End User Applications - Message Reporting - Nov 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/46859003437331-End-User-Applications-Message-Reporting-Nov-2025)\n - [API & Integrations - Zscaler Threat Share Government Cloud Region Support - Nov 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/46856547937939-API-Integrations-Zscaler-Threat-Share-Government-Cloud-Region-Support-Nov-2025)\n - [Engage - Teams Nudges - Nov 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/46695143680915-Engage-Teams-Nudges-Nov-2025)\n - [API & Integrations - Event Push Integration - Nov 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/46464059376147-API-Integrations-Event-Push-Integration-Nov-2025)\n - [Engage - Human Risk Scorecards - Nov 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/43738449011987-Engage-Human-Risk-Scorecards-Nov-2025)\n - [Removal of Support for TLS Client-Initiated Renegotiation - Nov 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/46172400267155-Removal-of-Support-for-TLS-Client-Initiated-Renegotiation-Nov-2025)\n - [Mimecast Administration Console - Menu Update - Nov 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/46202087876243-Mimecast-Administration-Console-Menu-Update-Nov-2025)\n - [Engage - Multilingual Enhancements for Mentor Videos - Nov 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/46465652895763-Engage-Multilingual-Enhancements-for-Mentor-Videos-Nov-2025)\n - [Awareness Training - Multilingual Enhancements for Mentor Videos - Nov 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/46466770571795-Awareness-Training-Multilingual-Enhancements-for-Mentor-Videos-Nov-2025)\n - [Analysis & Response - Reported Emails Filtering Options - Nov 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/46270225227539-Analysis-Response-Reported-Emails-Filtering-Options-Nov-2025)\n - [Human Risk Command Center - Human Risk Score Reset - Nov 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/45499820369683-Human-Risk-Command-Center-Human-Risk-Score-Reset-Nov-2025)\n - [Engage - Okta Integration - Nov 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42418338097683-Engage-Okta-Integration-Nov-2025)\n - [Mimecast Administration Console - Menu Update - Oct 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/45467036112403-Mimecast-Administration-Console-Menu-Update-Oct-2025)\n - [Advanced BEC - Reporting Cases Through Zendesk - Oct 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/45568646781971-Advanced-BEC-Reporting-Cases-Through-Zendesk-Oct-2025)\n - [Mimecast Personal Portal - Outlook Add-in - Oct 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/44561800933011-Mimecast-Personal-Portal-Outlook-Add-in-Oct-2025)\n - [API & Integrations - Cisco Duo Integration - Oct 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/45594047574291-API-Integrations-Cisco-Duo-Integration-Oct-2025)\n - [Advanced BEC - Detection Summarization - Oct 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/44427154408467-Advanced-BEC-Detection-Summarization-Oct-2025)\n - [Email Security Cloud Gateway - Account Takeover - Oct 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/45171979474963-Email-Security-Cloud-Gateway-Account-Takeover-Oct-2025)\n - [API & Integrations - Splunk - Update to v.5.4.0 - Oct 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/45662914163475-API-Integrations-Splunk-Update-to-v-5-4-0-Oct-2025)\n - [Targeted Threat Protection - URL Pre-Delivery Action - Oct 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/43671505743123-Targeted-Threat-Protection-URL-Pre-Delivery-Action-Oct-2025)\n - [Engage - Direct Message Injection - Oct 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/44164393956883-Engage-Direct-Message-Injection-Oct-2025)\n - [Awareness Training - Direct Message Injection - Oct 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/44164315587091-Awareness-Training-Direct-Message-Injection-Oct-2025)\n - [Planned Maintenance - ZA Outage - Oct 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/45036561348115-Planned-Maintenance-ZA-Outage-Oct-2025)\n - [Engage - Multi-Language Phishing Templates - Oct 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/45400264241939-Engage-Multi-Language-Phishing-Templates-Oct-2025)\n - [Awareness Training - Multi-Language Phishing Templates - Oct 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/45399693651987-Awareness-Training-Multi-Language-Phishing-Templates-Oct-2025)\n - [API & integrations - KnowBe4 Outlook End User Reporting - Oct 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/44970598688787-API-integrations-KnowBe4-Outlook-End-User-Reporting-Oct-2025)\n - [API & Integrations - Availability of Integrations for Cloud Gateway Customers using Human Risk Command Center - Sep 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/44540599070611-API-Integrations-Availability-of-Integrations-for-Cloud-Gateway-Customers-using-Human-Risk-Command-Center-Sep-2025)\n - [Planned Maintenance - ZA Outage - Sep 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/43995582058771-Planned-Maintenance-ZA-Outage-Sep-2025)\n - [API & Integrations - Changes to Admin IP Restrictions - Sep 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/44764533235347-API-Integrations-Changes-to-Admin-IP-Restrictions-Sep-2025)\n - [Engage - Indicators of Phishing Landing Page - Sep 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/44198891887251-Engage-Indicators-of-Phishing-Landing-Page-Sep-2025)\n - [Awareness Training - Indicators of Phishing Landing Page - Sep 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/43004554261267-Awareness-Training-Indicators-of-Phishing-Landing-Page-Sep-2025)\n - [Mimecast Administration Console - New Menu Opt out Phase - Sep 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42841549775507-Mimecast-Administration-Console-New-Menu-Opt-out-Phase-Sep-2025)\n - [API & Integrations - Palo Alto Networks Cortex XDR - Sep 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/44162718690195-API-Integrations-Palo-Alto-Networks-Cortex-XDR-Sep-2025)\n - [CyberGraph - Banner Search Enhancements - Sep 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/43251786925843-CyberGraph-Banner-Search-Enhancements-Sep-2025)\n - [CyberGraph - Administrator Activity Log Entries - Sep 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/43220251803411-CyberGraph-Administrator-Activity-Log-Entries-Sep-2025)\n - [Administration Console - New Menu Search and Favorites - Aug 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/43831507613715-Administration-Console-New-Menu-Search-and-Favorites-Aug-2025)\n - [Case Review - Display additional message info and block senders - Aug 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/43476049848595-Case-Review-Display-additional-message-info-and-block-senders-Aug-2025)\n - [Mimecast Human Risk Insights (MHRI) Report - Aug 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/43861231883667-Mimecast-Human-Risk-Insights-MHRI-Report-Aug-2025)\n - [API & Integrations - Analysis & Response Details API – August 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/43374297764371-API-Integrations-Analysis-Response-Details-API-August-2025)\n - [API & Integrations - Microsoft Defender for Endpoint Threat Share - Aug 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/43832038963987-API-Integrations-Microsoft-Defender-for-Endpoint-Threat-Share-Aug-2025)\n - [URL Protect - Enhanced Attachment Scanning for QR Codes - Aug 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/43099658664211-URL-Protect-Enhanced-Attachment-Scanning-for-QR-Codes-Aug-2025)\n - [Engage - Microsoft Attack Simulation Integration - Aug 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/43602850773779-Engage-Microsoft-Attack-Simulation-Integration-Aug-2025)\n - [API & Integrations - API 1.0 End-of-Life Project Extension - Aug 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/43572890309651-API-Integrations-API-1-0-End-of-Life-Project-Extension-Aug-2025)\n - [API & Integrations - Engage Sophos Integration - Aug 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/43010501339283-API-Integrations-Engage-Sophos-Integration-Aug-2025)\n - [Human Risk Command Center - Aug 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41193705355923-Human-Risk-Command-Center-Aug-2025)\n - [Mimecast Administration Console - Workspace Favorites - Jul 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/43222253211155-Mimecast-Administration-Console-Workspace-Favorites-Jul-2025)\n - [URL Protect - Microsoft Teams Update Action Required - Jul 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/43382552280083-URL-Protect-Microsoft-Teams-Update-Action-Required-Jul-2025)\n - [Engage - Nudge Video Player Language Support - Jul 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/43004679684243-Engage-Nudge-Video-Player-Language-Support-Jul-2025)\n - [Mimecast Personal Portal - Branding Support - Jul 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42773588791059-Mimecast-Personal-Portal-Branding-Support-Jul-2025)\n - [Email Security Cloud Integrated – Display Message Content for All Threat Types - Jul 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42813631445523-Email-Security-Cloud-Integrated-Display-Message-Content-for-All-Threat-Types-Jul-2025)\n - [Engage - Tracking Reported Phishing Emails After User Clicks or Submits Data - Jul 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42880342562835-Engage-Tracking-Reported-Phishing-Emails-After-User-Clicks-or-Submits-Data-Jul-2025)\n - [Awareness Training - Tracking Reported Phishing Emails After User Clicks or Submits Data - Jul 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42904080484755-Awareness-Training-Tracking-Reported-Phishing-Emails-After-User-Clicks-or-Submits-Data-Jul-2025)\n - [Case Review - Retention Adjustments & Message Actions - Jul 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42044439269523-Case-Review-Retention-Adjustments-Message-Actions-Jul-2025)\n - [Engage - Test Campaigns - Jul 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42714963870227-Engage-Test-Campaigns-Jul-2025)\n - [Awareness Training - Test Campaigns - Jul 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42842308680595-Awareness-Training-Test-Campaigns-Jul-2025)\n - [Engage - Mapping Difficulty Level to Phishing Templates - Jul 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42879739494291-Engage-Mapping-Difficulty-Level-to-Phishing-Templates-Jul-2025)\n - [Awareness Training - Mapping Difficulty Level to Phishing Templates - Jul 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42878909932947-Awareness-Training-Mapping-Difficulty-Level-to-Phishing-Templates-Jul-2025)\n - [Engage - Multi Group Phishing Campaigns - Jul 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42841559526803-Engage-Multi-Group-Phishing-Campaigns-Jul-2025)\n - [Awareness Training - Multi Group Phishing Campaigns - Jul 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42844561375635-Awareness-Training-Multi-Group-Phishing-Campaigns-Jul-2025)\n - [Engage - UK Season 3 - Jul 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42690161344787-Engage-UK-Season-3-Jul-2025)\n - [Awareness Training - UK Season 3 - Jul 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42690648247187-Awareness-Training-UK-Season-3-Jul-2025)\n - [CyberGraph - Audit Log Changes - Jul 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42074933192979-CyberGraph-Audit-Log-Changes-Jul-2025)\n - [Mimecast Customer Care - Global Support Zoom Contact Center - Jun 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41898170019091-Mimecast-Customer-Care-Global-Support-Zoom-Contact-Center-Jun-2025)\n - [Mimecast Personal Portal - New UI - June 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42076860644499-Mimecast-Personal-Portal-New-UI-June-2025)\n - [API & Integrations - Blocked Senders Policy Management and User Group Endpoints - Jun 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41899112734355-API-Integrations-Blocked-Senders-Policy-Management-and-User-Group-Endpoints-Jun-2025)\n - [Engage - Sensitive Data Handling Nudges - Jun 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42043191102867-Engage-Sensitive-Data-Handling-Nudges-Jun-2025)\n - [CyberGraph - Message Blocking - Jun 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42075149393299-CyberGraph-Message-Blocking-Jun-2025)\n - [Brand Exploit Protect - Integration With Mimecast API 2.0 - Jun 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41618725541779-Brand-Exploit-Protect-Integration-With-Mimecast-API-2-0-Jun-2025)\n - [CyberGraph - Language Support - Jun 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41194448904979-CyberGraph-Language-Support-Jun-2025)\n - [Email Security Cloud Integrated - Advanced Business Email Compromise Policies - Jun 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/40586322475539-Email-Security-Cloud-Integrated-Advanced-Business-Email-Compromise-Policies-Jun-2025)\n - [API & Integrations - Microsoft Entra ID Protection - Jun 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41810471603987-API-Integrations-Microsoft-Entra-ID-Protection-Jun-2025)\n - [Engage - Teams Nudges - June 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41097271601683-Engage-Teams-Nudges-June-2025)\n - [Mimecast Essentials for Outlook - Nested Application Authentication - Jun 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41615510582803-Mimecast-Essentials-for-Outlook-Nested-Application-Authentication-Jun-2025)\n - [API & Integrations - Enhancing API Gateway Resilience - Jun 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41019270938643-API-Integrations-Enhancing-API-Gateway-Resilience-Jun-2025)\n - [Mimecast Partner - Partner Onboarding - Jun 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/39991339578643-Mimecast-Partner-Partner-Onboarding-Jun-2025)\n - [API & Integrations - CrowdStrike Falcon Threat Share Integration v2 - May 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41592150635411-API-Integrations-CrowdStrike-Falcon-Threat-Share-Integration-v2-May-2025)\n - [Case Review - Export Cases List - May 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41236340727827-Case-Review-Export-Cases-List-May-2025)\n - [Case Review - Delete Saved Search - May 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41233950328083-Case-Review-Delete-Saved-Search-May-2025)\n - [Email Security Cloud Integrated - QR Code Scanning - May 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41453446595731-Email-Security-Cloud-Integrated-QR-Code-Scanning-May-2025)\n - [Email Security Cloud Gateway - QR Code Scanning - May 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41446085539475-Email-Security-Cloud-Gateway-QR-Code-Scanning-May-2025)\n - [Sync & Recover Progress Reporting Revamp - May 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/40657122505235-Sync-Recover-Progress-Reporting-Revamp-May-2025)\n - [Policies - Block Dangerous File Types - May 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41194884365203-Policies-Block-Dangerous-File-Types-May-2025)\n - [Engage - SentinelOne Integration - May 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41051134288403-Engage-SentinelOne-Integration-May-2025)\n - [Case Review - Export Mailbox Holds - May 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41199329276179-Case-Review-Export-Mailbox-Holds-May-2025)\n - [Case Review - Export Selected Messages - May 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41157028621971-Case-Review-Export-Selected-Messages-May-2025)\n - [Case Review - Search on Smart Tags - May 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41015031716883-Case-Review-Search-on-Smart-Tags-May-2025)\n - [API & Integrations - Zscaler Threat Share - Service Update - May 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/40621982206739-API-Integrations-Zscaler-Threat-Share-Service-Update-May-2025)\n - [Engage - Localization for Customizable Correct Answers and Safety Tips - May 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/40401341306515-Engage-Localization-for-Customizable-Correct-Answers-and-Safety-Tips-May-2025)\n - [Awareness Training - Localization for Customizable Correct Answers and Safety Tips - May 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/40361824425491-Awareness-Training-Localization-for-Customizable-Correct-Answers-and-Safety-Tips-May-2025)\n - [Email Security Cloud Integrated - Application Consent for Single Sign-On - May 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/39056854413971-Email-Security-Cloud-Integrated-Application-Consent-for-Single-Sign-On-May-2025)\n - [Mimecast Administration Console - Navigation - Apr 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/39527974034835-Mimecast-Administration-Console-Navigation-Apr-2025)\n - [Engage - Slack Nudges - Apr 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/39668429154195-Engage-Slack-Nudges-Apr-2025)\n - [DMARC Analyzer - Microsoft Changes - April 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/41524217732243-DMARC-Analyzer-Microsoft-Changes-April-2025)\n - [Engage - Netskope DLP for Human Risk - Apr 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/40395226376851-Engage-Netskope-DLP-for-Human-Risk-Apr-2025)\n - [Engage - Customizable Nudges - Apr 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/40245209049875-Engage-Customizable-Nudges-Apr-2025)\n - [API & Integrations - New API Endpoints - Apr 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/39919006829715-API-Integrations-New-API-Endpoints-Apr-2025)\n - [Engage - Program Overview Page Enhancements - Apr 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/40354179802771-Engage-Program-Overview-Page-Enhancements-Apr-2025)\n - [Engage - Mentor Series - Apr 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/40205960215571-Engage-Mentor-Series-Apr-2025)\n - [Awareness Training - Mentor Series - Apr 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/40210101738131-Awareness-Training-Mentor-Series-Apr-2025)\n - [Engage - Human Risk Platform Maintenance - Apr 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/40424986728979-Engage-Human-Risk-Platform-Maintenance-Apr-2025)\n - [Email Security Cloud Integrated - Enhanced Audit Logs - Apr 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/40171335595411-Email-Security-Cloud-Integrated-Enhanced-Audit-Logs-Apr-2025)\n - [Case Review - Update to Case Review Exports - Apr 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/39917900028435-Case-Review-Update-to-Case-Review-Exports-Apr-2025)\n - [API & Integrations - The Integrations Hub - Apr 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/39248014333587-API-Integrations-The-Integrations-Hub-Apr-2025)\n - [Engage - Microsoft Purview Integration - Email Security Cloud Gateway - Apr 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/40137472794387-Engage-Microsoft-Purview-Integration-Email-Security-Cloud-Gateway-Apr-2025)\n - [Engage - Microsoft Purview Integration - Email Security Cloud Integrated - Apr 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/40137477958675-Engage-Microsoft-Purview-Integration-Email-Security-Cloud-Integrated-Apr-2025)\n - [Email Security Cloud Integrated - Home Page and Reporting Enhancements - Apr 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/39455015583763-Email-Security-Cloud-Integrated-Home-Page-and-Reporting-Enhancements-Apr-2025)\n - [Email Security Cloud Integrated - Mimecast Support Access - Apr 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/39058814050067-Email-Security-Cloud-Integrated-Mimecast-Support-Access-Apr-2025)\n - [Mimecast Administration Console - Workspace - Apr 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/38697492187667-Mimecast-Administration-Console-Workspace-Apr-2025)\n - [API & Integrations - API 1.0 End of Life - Mar 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/39704312201235-API-Integrations-API-1-0-End-of-Life-Mar-2025)\n - [Engage - Microsoft Defender for Office 365 Integration - Email Security Cloud Gateway - March 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/39674615141907-Engage-Microsoft-Defender-for-Office-365-Integration-Email-Security-Cloud-Gateway-March-2025)\n - [Engage - Microsoft Defender for Office 365 Integration - Email Security Cloud Integrated - Mar 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/39702859676691-Engage-Microsoft-Defender-for-Office-365-Integration-Email-Security-Cloud-Integrated-Mar-2025)\n - [Engage - Season 7 - Mar 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/39702809417491-Engage-Season-7-Mar-2025)\n - [Awareness Training - Season 7 - Mar 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/39564521941907-Awareness-Training-Season-7-Mar-2025)\n - [Email Security Cloud Integrated - Additional Re-write Settings - Mar 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/39391552973843-Email-Security-Cloud-Integrated-Additional-Re-write-Settings-Mar-2025)\n - [One Mimecast - Partner Portal Enhancement - Mar 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/39243481704339-One-Mimecast-Partner-Portal-Enhancement-Mar-2025)\n - [Email Security Cloud Integrated - Localization Settings - Mar 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/38878778683667-Email-Security-Cloud-Integrated-Localization-Settings-Mar-2025)\n - [Engage - Incydr Integration for Email Security Cloud Gateway - Mar 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/39459978202131-Engage-Incydr-Integration-for-Email-Security-Cloud-Gateway-Mar-2025)\n - [Engage - Incydr Integration for Email Security Cloud Integrated - Mar 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/39385262314771-Engage-Incydr-Integration-for-Email-Security-Cloud-Integrated-Mar-2025)\n - [Engage - Malware Nudges - Mar 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/38672179063443-Engage-Malware-Nudges-Mar-2025)\n - [Email Security Cloud Integrated - Event Timeline - Feb 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/38698948217619-Email-Security-Cloud-Integrated-Event-Timeline-Feb-2025)\n - [Audit Logs - Date Range - Feb 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/38639484609171-Audit-Logs-Date-Range-Feb-2025)\n - [Email Security Cloud Gateway - DANE - Feb 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/38401562665491-Email-Security-Cloud-Gateway-DANE-Feb-2025)\n - [Email Security Cloud Integrated - Restore Remediated Messages - Feb 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/37881191589779-Email-Security-Cloud-Integrated-Restore-Remediated-Messages-Feb-2025)\n - [Sync & Recover - Sort , Search & Filter - Feb 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/37978066980627-Sync-Recover-Sort-Search-Filter-Feb-2025)\n - [Mimecast Essentials for Outlook - Authentication Changes - Feb 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/38502546375571-Mimecast-Essentials-for-Outlook-Authentication-Changes-Feb-2025)\n - [Mimecast Synchronization Engine - Release 4.5.0.525 - Feb 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/38327930699411-Mimecast-Synchronization-Engine-Release-4-5-0-525-Feb-2025)\n - [DNS Authentication - Inbound Notification - Feb 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/38180509103891-DNS-Authentication-Inbound-Notification-Feb-2025)\n - [Enhanced Security Efficacy Improvements - Feb 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/38217399792787-Enhanced-Security-Efficacy-Improvements-Feb-2025)\n - [CyberGraph 2.0 - Banners in Older Messages - Feb 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/36394066711443-CyberGraph-2-0-Banners-in-Older-Messages-Feb-2025)\n - [Email Security Cloud Integrated - Detections Sub-categories - Jan 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/37934686562451-Email-Security-Cloud-Integrated-Detections-Sub-categories-Jan-2025)\n - [Email Security Cloud Integrated - Delete from Quarantine - Jan 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/37435416109587-Email-Security-Cloud-Integrated-Delete-from-Quarantine-Jan-2025)\n - [Collaboration Security - Protection for Microsoft Teams SharePoint & OneDrive - Jan 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/37300366000275-Collaboration-Security-Protection-for-Microsoft-Teams-SharePoint-OneDrive-Jan-2025)\n - [End User Applications - Ability to Print - Jan 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/36992322029587-End-User-Applications-Ability-to-Print-Jan-2025)\n - [Case Review - Exports - Jan 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/37056186760211-Case-Review-Exports-Jan-2025)\n - [End User Applications - Mimecast Mobile Android Support - Dec 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/36506883790611-End-User-Applications-Mimecast-Mobile-Android-Support-Dec-2024)\n - [Email Security Cloud Integrated - Policy Filter in Detection Search - Dec 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/36582208328339-Email-Security-Cloud-Integrated-Policy-Filter-in-Detection-Search-Dec-2024)\n - [Email Security Cloud Integrated - Graymail Filtering Options - Dec 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/36580706428691-Email-Security-Cloud-Integrated-Graymail-Filtering-Options-Dec-2024)\n - [Email Security Cloud Integrated - Browser Isolation - Dec 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/36345336555795-Email-Security-Cloud-Integrated-Browser-Isolation-Dec-2024)\n - [API & Integrations - Engage CrowdStrike Integration CG - Dec 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/36347457125651-API-Integrations-Engage-CrowdStrike-Integration-CG-Dec-2024)\n - [API & Integrations - Engage CrowdStrike Integration CI - Dec 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/36347416369939-API-Integrations-Engage-CrowdStrike-Integration-CI-Dec-2024)\n - [Policies - Custom Header - Dec 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/36264807183507-Policies-Custom-Header-Dec-2024)\n - [Mimecast Education - Course Player - Dec 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/36583572355347-Mimecast-Education-Course-Player-Dec-2024)\n - [Email Security Cloud Integrated - Streamlined Allow & Block Sender Actions - Dec 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/36145352944915-Email-Security-Cloud-Integrated-Streamlined-Allow-Block-Sender-Actions-Dec-2024)\n - [API & Integrations - API 1.0 End of Life - Dec 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/36581892192659-API-Integrations-API-1-0-End-of-Life-Dec-2024)\n - [Email Security Cloud Integrated - Weekly Reports - Dec 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/36142265483795-Email-Security-Cloud-Integrated-Weekly-Reports-Dec-2024)\n - [Engage - Phishing Simulation Usability Enhancements - Nov 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/35173308491923-Engage-Phishing-Simulation-Usability-Enhancements-Nov-2024)\n - [Awareness Training - Phishing Simulation Usability Enhancements - Nov 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/35173309892115-Awareness-Training-Phishing-Simulation-Usability-Enhancements-Nov-2024)\n - [Mimecast Customer Care - Support Experience Pilot Program Conclusion - Nov 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/35611277067667-Mimecast-Customer-Care-Support-Experience-Pilot-Program-Conclusion-Nov-2024)\n - [Email Security Cloud Gateway - Captcha Abuse Detection - Nov 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/35170883311763-Email-Security-Cloud-Gateway-Captcha-Abuse-Detection-Nov-2024)\n - [Email Security Cloud Integrated - Captcha Abuse Detection - Nov 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/35403685398547-Email-Security-Cloud-Integrated-Captcha-Abuse-Detection-Nov-2024)\n - [Email Security Cloud Integrated - Alerts for Malware and Phishing Quarantine - Nov 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/35172204962451-Email-Security-Cloud-Integrated-Alerts-for-Malware-and-Phishing-Quarantine-Nov-2024)\n - [API & Integrations - IBM QRadar (SIEM v3) - Nov 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/38031222665491-API-Integrations-IBM-QRadar-SIEM-v3-Nov-2024)\n - [Mimecast Customer Care - Support Experience and Mimecaster Central - Oct 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34194735094803-Mimecast-Customer-Care-Support-Experience-and-Mimecaster-Central-Oct-2024)\n - [Attachment Protect - Monitoring Attachments - Oct 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000866920595-Attachment-Protect-Monitoring-Attachments-Oct-2024)\n - [API & Integrations - CrowdStrike Incydr Flow Integration - Oct 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34371480239891-API-Integrations-CrowdStrike-Incydr-Flow-Integration-Oct-2024)\n - [API & Integrations - Mailock Integration - Oct 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34294880417811-API-Integrations-Mailock-Integration-Oct-2024)\n - [API & Integrations - Alpha Mountain - Oct 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34301130576915-API-Integrations-Alpha-Mountain-Oct-2024)\n - [API & Integrations - Splunk - Upgraded Python Library - Oct 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34294566122259-API-Integrations-Splunk-Upgraded-Python-Library-Oct-2024)\n - [API & Integrations - Cribl - Oct 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34294536310291-API-Integrations-Cribl-Oct-2024)\n - [API & Integrations - CrowdStrike Foundry Integration - Oct 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34294444329235-API-Integrations-CrowdStrike-Foundry-Integration-Oct-2024)\n - [API & Integrations - LevelBlue USM Anywhere - Oct 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34294533339667-API-Integrations-LevelBlue-USM-Anywhere-Oct-2024)\n - [Analysis & Response - Detection Details Enhancement - Jun 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/42040831027091-Analysis-Response-Detection-Details-Enhancement-Jun-2025)\n - [Mimecast Customer Care - Mimecast Community and Knowledge - Feb 2025](https://mimecastsupport.zendesk.com/hc/en-us/articles/38223061622803-Mimecast-Customer-Care-Mimecast-Community-and-Knowledge-Feb-2025)\n - [Email Security Cloud Gateway - Advanced Business Email Compromise Protection - Oct 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000811334419-Email-Security-Cloud-Gateway-Advanced-Business-Email-Compromise-Protection-Oct-2024)\n - [Email Security Cloud Integrated - Advanced Business Email Compromise Protection - Oct 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000435491219-Email-Security-Cloud-Integrated-Advanced-Business-Email-Compromise-Protection-Oct-2024)\n - [Email Security Cloud Integration - Enhanced Detection Insights - Service Update - Oct 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34486226171539-Email-Security-Cloud-Integration-Enhanced-Detection-Insights-Service-Update-Oct-2024)\n - [URL Protect - QR Codes Update & Image Analysis - Sep 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000394302995-URL-Protect-QR-Codes-Update-Image-Analysis-Sep-2024)\n - [API & Integrations - New API Endpoints - Sep 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420576659-API-Integrations-New-API-Endpoints-Sep-2024)\n - [Reporting – MEIR & Outlook End-User Reporting - Sep 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000395409043-Reporting-MEIR-Outlook-End-User-Reporting-Sep-2024)\n - [Case Review - Mailbox Holds Listing - Sep 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000448279059-Case-Review-Mailbox-Holds-Listing-Sep-2024)\n - [Mimecast Synchronization Engine - Release 4.5.0.499 - Sep 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000463735315-Mimecast-Synchronization-Engine-Release-4-5-0-499-Sep-2024)\n - [CyberGraph 2.0 - Upgrade - Aug 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000392999059-CyberGraph-2-0-Upgrade-Aug-2024)\n - [Email Security Cloud Integrated - Enhanced Detections Page & Bulk Detection Management - Aug 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000419306515-Email-Security-Cloud-Integrated-Enhanced-Detections-Page-Bulk-Detection-Management-Aug-2024)\n - [Email Security Cloud Integrated - Threat Scan - Aug 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000493863571-Email-Security-Cloud-Integrated-Threat-Scan-Aug-2024)\n - [Attachment Protect - Decryption Portal - Aug 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000503243539-Attachment-Protect-Decryption-Portal-Aug-2024)\n - [Email Security Cloud Integrated - Customize Notification Recipients - Aug 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000494288275-Email-Security-Cloud-Integrated-Customize-Notification-Recipients-Aug-2024)\n - [Email Security Cloud Integrated - Sync & Recover - Jul 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000520299795-Email-Security-Cloud-Integrated-Sync-Recover-Jul-2024)\n - [Spam / Phishing - Auto Allow Spam Scanning Enhancements - Jul 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000538331027-Spam-Phishing-Auto-Allow-Spam-Scanning-Enhancements-Jul-2024)\n - [Analysis and Response - New APIs - Jul 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000580727187-Analysis-and-Response-New-APIs-Jul-2024)\n - [Email Security Cloud Integrated - Allow/Block Rule - Jul 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000538535827-Email-Security-Cloud-Integrated-Allow-Block-Rule-Jul-2024)\n - [Reporting - Outlook End-User Reporting - Jul 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000543146387-Reporting-Outlook-End-User-Reporting-Jul-2024)\n - [Email Security Cloud Integrated - Connector Configuration Improvements - Jun 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000556442003-Email-Security-Cloud-Integrated-Connector-Configuration-Improvements-Jun-2024)\n - [Threat Dashboard - Removal - Jun 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420397843-Threat-Dashboard-Removal-Jun-2024)\n - [Brand Exploit Protect - Key Rotation​ - Jun 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000393899539-Brand-Exploit-Protect-Key-Rotation-Jun-2024)\n - [Mimecast for Outlook - Incompatibility with New Outlook - Jun 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000402700563-Mimecast-for-Outlook-Incompatibility-with-New-Outlook-Jun-2024)\n - [Mimecast Synchronization Engine - Release 4.5.0.498 - Jun 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420289555-Mimecast-Synchronization-Engine-Release-4-5-0-498-Jun-2024)\n - [Email Security Cloud Integrated - Subject URL Rewriting - Jun 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000402302739-Email-Security-Cloud-Integrated-Subject-URL-Rewriting-Jun-2024)\n - [Attachment Protect - Enhancements for Cryptographic Message Syntax – Jun 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000561061395-Attachment-Protect-Enhancements-for-Cryptographic-Message-Syntax-Jun-2024)\n - [CyberGraph 1.0 - Legacy On-Premises MTA End of Life - May 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/37315193865619-CyberGraph-1-0-Legacy-On-Premises-MTA-End-of-Life-May-2024)\n - [Directory Synchronization - Microsoft Azure Directory Synchronization Connectors - May 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000394614419-Directory-Synchronization-Microsoft-Azure-Directory-Synchronization-Connectors-May-2024)\n - [Awareness Training - Weekly Reminders - May 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420763155-Awareness-Training-Weekly-Reminders-May-2024)\n - [Email Security Cloud Integrated - Troubleshooting Installation - May 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000613678739-Email-Security-Cloud-Integrated-Troubleshooting-Installation-May-2024)\n - [Analysis and Response - Launch - May 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000614756755-Analysis-and-Response-Launch-May-2024)\n - [Awareness Training - Module Limit End of Life - May 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000597304211-Awareness-Training-Module-Limit-End-of-Life-May-2024)\n - [CyberGraph 2.0 - Single Sign-On (SSO) - May 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000615051411-CyberGraph-2-0-Single-Sign-On-SSO-May-2024)\n - [Mimecast Administration Console - App Switcher Retirement - May 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000529773331-Mimecast-Administration-Console-App-Switcher-Retirement-May-2024)\n - [API & Integrations - API 2.0 Portal Usability Enhancements - May 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000614980755-API-Integrations-API-2-0-Portal-Usability-Enhancements-May-2024)\n - [Email Security Cloud Integrated - Sync & Recover - May 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000615471379-Email-Security-Cloud-Integrated-Sync-Recover-May-2024)\n - [Message Routing - Security Enhancements for TNEF Encapsulated Items - May 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000408563475-Message-Routing-Security-Enhancements-for-TNEF-Encapsulated-Items-May-2024)\n - [Email Security Cloud Integrated - Threat Scan - April 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000394883219-Email-Security-Cloud-Integrated-Threat-Scan-April-2024)\n - [Email Security Cloud Integrated - Home Page Enhancements - Apr 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000447883667-Email-Security-Cloud-Integrated-Home-Page-Enhancements-Apr-2024)\n - [Email Security Cloud Integrated - User Synchronization Enhancements - Apr 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000422075539-Email-Security-Cloud-Integrated-User-Synchronization-Enhancements-Apr-2024)\n - [API & Integrations - Restful API Endpoints - Apr 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000435558547-API-Integrations-Restful-API-Endpoints-Apr-2024)\n - [API & Integrations - New API Endpoints - Apr 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000363282963-API-Integrations-New-API-Endpoints-Apr-2024)\n - [Notification Sets - Custom Notifications - Mar 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000309352339-Notification-Sets-Custom-Notifications-Mar-2024)\n - [Attachment Protect - Attachment Protect Decryption Portal - Mar 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000320773651-Attachment-Protect-Attachment-Protect-Decryption-Portal-Mar-2024)\n - [Policies - Custom Header Feature - Mar 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000309269651-Policies-Custom-Header-Feature-Mar-2024)\n - [Awareness Training - Navigation Changes - Mar 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000337765907-Awareness-Training-Navigation-Changes-Mar-2024)\n - [Email Security Cloud Integrated - QR Code Scanning - Mar 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000363028499-Email-Security-Cloud-Integrated-QR-Code-Scanning-Mar-2024)\n - [Mimecast Customer Care - Support Phone Service Improvements - Mar 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000323041299-Mimecast-Customer-Care-Support-Phone-Service-Improvements-Mar-2024)\n - [Email Security Cloud Integrated - Policy Detection Engine Settings - Mar 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000450339859-Email-Security-Cloud-Integrated-Policy-Detection-Engine-Settings-Mar-2024)\n - [Email Security Cloud Integrated - Trusted ARC Sealer - Mar 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000321250579-Email-Security-Cloud-Integrated-Trusted-ARC-Sealer-Mar-2024)\n - [Email Security Cloud Integrated - Microsoft SharePoint & OneDrive - Mar 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000322422547-Email-Security-Cloud-Integrated-Microsoft-SharePoint-OneDrive-Mar-2024)\n - [Mimecast Email Incident Response - Remediation Reporting Change - Mar 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34003067854739-Mimecast-Email-Incident-Response-Remediation-Reporting-Change-Mar-2024)\n - [Email Security Cloud Integrated - In-App Chat Support Pilot - Feb 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000408508307-Email-Security-Cloud-Integrated-In-App-Chat-Support-Pilot-Feb-2024)\n - [DMARC Analyzer - Application Dashboard Improvements - Feb 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000322690323-DMARC-Analyzer-Application-Dashboard-Improvements-Feb-2024)\n - [Roles - Protected Content Administrator Elevations - Feb 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000339517459-Roles-Protected-Content-Administrator-Elevations-Feb-2024)\n - [Sync & Recover - Email Download - Feb 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000349343379-Sync-Recover-Email-Download-Feb-2024)\n - [Awareness Training - Efficacy Report Release Two - Feb 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000466652435-Awareness-Training-Efficacy-Report-Release-Two-Feb-2024)\n - [Targeted Threat Protection - Domain Update - Feb 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000364820371-Targeted-Threat-Protection-Domain-Update-Feb-2024)\n - [DMARC Analyzer - Email Security Cloud Integrated - Feb 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000455276179-DMARC-Analyzer-Email-Security-Cloud-Integrated-Feb-2024)\n - [DMARC Analyzer - Google & Yahoo Authentication Changes - Feb 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34003059933075-DMARC-Analyzer-Google-Yahoo-Authentication-Changes-Feb-2024)\n - [Connect Application - EOL Notice - Jan 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000351575827-Connect-Application-EOL-Notice-Jan-2024)\n - [Targeted Threat Protection - QR Code Scanning - Jan 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000340391443-Targeted-Threat-Protection-QR-Code-Scanning-Jan-2024)\n - [Email Security Cloud Integrated - Sync & Recover - Jan 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000354102035-Email-Security-Cloud-Integrated-Sync-Recover-Jan-2024)\n - [Email Security Cloud Gateway - SMS Services New Number for South Africa - Jan 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34003074398483-Email-Security-Cloud-Gateway-SMS-Services-New-Number-for-South-Africa-Jan-2024)\n - [CyberGraph 2.0 - New Microsoft Outlook Client - Jan 2024](https://mimecastsupport.zendesk.com/hc/en-us/articles/34003061551507-CyberGraph-2-0-New-Microsoft-Outlook-Client-Jan-2024)\n - [Targeted Threat Protection - HTML Attachment Deep Scanning - Dec 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000325292307-Targeted-Threat-Protection-HTML-Attachment-Deep-Scanning-Dec-2023)\n - [Email Security Cloud Integrated - Enhanced Detections Search - Dec 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000367927827-Email-Security-Cloud-Integrated-Enhanced-Detections-Search-Dec-2023)\n - [Awareness Training - Efficacy Report Release One - Dec 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000342751123-Awareness-Training-Efficacy-Report-Release-One-Dec-2023)\n - [Attachment Protect - Attachment Protect Definitions - Dec 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000455934611-Attachment-Protect-Attachment-Protect-Definitions-Dec-2023)\n - [Mimecast Administration Console - Menu Enhancements - Nov 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000456107539-Mimecast-Administration-Console-Menu-Enhancements-Nov-2023)\n - [Email Security Cloud Integrated - Microsoft Native Reporting - Nov 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000456239379-Email-Security-Cloud-Integrated-Microsoft-Native-Reporting-Nov-2023)\n - [Policies - Wildcards Update - Nov 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000442932243-Policies-Wildcards-Update-Nov-2023)\n - [Mimecast Customer Care - Support Case Routing - Oct 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000352877075-Mimecast-Customer-Care-Support-Case-Routing-Oct-2023)\n - [Email Security Cloud Integrated - Allow/Block List Improvements - Oct 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000381794579-Email-Security-Cloud-Integrated-Allow-Block-List-Improvements-Oct-2023)\n - [Awareness Training - Compliance & Risk Center Summary Boards - Oct 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000355857939-Awareness-Training-Compliance-Risk-Center-Summary-Boards-Oct-2023)\n - [Awareness Training - Enhancements to Reporting - Oct 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000353020307-Awareness-Training-Enhancements-to-Reporting-Oct-2023)\n - [Mimecast Synchronization Engine - Release 4.5.0.491 - Oct 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000368397587-Mimecast-Synchronization-Engine-Release-4-5-0-491-Oct-2023)\n - [DMARC Analyzer - DMARC Standard / Credit Card EOL - Sep 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000308888083-DMARC-Analyzer-DMARC-Standard-Credit-Card-EOL-Sep-2023)\n - [API & Integrations - Manage API 2.0 Credentials - Sep 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000443713427-API-Integrations-Manage-API-2-0-Credentials-Sep-2023)\n - [Email Security Cloud Integrated - Re-installation - Sep 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000444189587-Email-Security-Cloud-Integrated-Re-installation-Sep-2023)\n - [Directory Synchronization – Azure Directory Synchronization Integrations – Sep 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000471634835-Directory-Synchronization-Azure-Directory-Synchronization-Integrations-Sep-2023)\n - [Email Security Cloud Integrated - Detection Engine Enhancements - Aug 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000428137491-Email-Security-Cloud-Integrated-Detection-Engine-Enhancements-Aug-2023)\n - [API & Integrations - ServiceNow v1.3.2 Integration - Aug 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000384440723-API-Integrations-ServiceNow-v1-3-2-Integration-Aug-2023)\n - [API & Integrations - Profile Group Backup, Restore & Export API Endpoints - Aug 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000395920019-API-Integrations-Profile-Group-Backup-Restore-Export-API-Endpoints-Aug-2023)\n - [Email Security Cloud Integrated - More Mimecast Products - Aug 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000396146707-Email-Security-Cloud-Integrated-More-Mimecast-Products-Aug-2023)\n - [Email Security Cloud Integrated - Threats, Security Events & Data API Endpoints - Aug 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000396263955-Email-Security-Cloud-Integrated-Threats-Security-Events-Data-API-Endpoints-Aug-2023)\n - [Mimecast Administration Console - User Interface Enhancements - Jul 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000414043027-Mimecast-Administration-Console-User-Interface-Enhancements-Jul-2023)\n - [API & Integrations - API Endpoints for Large File Payload - July 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000359474451-API-Integrations-API-Endpoints-for-Large-File-Payload-July-2023)\n - [API & Integrations - Threat and Security Statistics APIs for Mimecast API 2.0 - Jul 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000414274579-API-Integrations-Threat-and-Security-Statistics-APIs-for-Mimecast-API-2-0-Jul-2023)\n - [API & Integrations - SIEM API Endpoints - Jul 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000373976083-API-Integrations-SIEM-API-Endpoints-Jul-2023)\n - [Mimecast Administration Console - Navigation Update - Jun 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000396492179-Mimecast-Administration-Console-Navigation-Update-Jun-2023)\n - [Mimecast Administration Console - Navigation Enhancements - Jun 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000444514835-Mimecast-Administration-Console-Navigation-Enhancements-Jun-2023)\n - [Policies - Support for MTA-STS - Jun 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000414937491-Policies-Support-for-MTA-STS-Jun-2023)\n - [Attachment Protect - Sandbox Enhancement - Jun 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000428234643-Attachment-Protect-Sandbox-Enhancement-Jun-2023)\n - [Mimecast Synchronization Engine - Release 4.5.0.489 - Jun 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000444600467-Mimecast-Synchronization-Engine-Release-4-5-0-489-Jun-2023)\n - [API & Integrations - Configuration, Backup & Export API - Jun 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000374825235-API-Integrations-Configuration-Backup-Export-API-Jun-2023)\n - [Connectors - GCC HIGH Cloud Service Provider - Jun 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000375015315-Connectors-GCC-HIGH-Cloud-Service-Provider-Jun-2023)\n - [Mimecast Email Incident Response - End User Feedback Updates - Jun 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000397348115-Mimecast-Email-Incident-Response-End-User-Feedback-Updates-Jun-2023)\n - [Email Security Cloud Integrated - Expanded Protection - Jun 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000386317075-Email-Security-Cloud-Integrated-Expanded-Protection-Jun-2023)\n - [Email Security Cloud Integrated - Mailflow Repair Installation - Jun 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000389008275-Email-Security-Cloud-Integrated-Mailflow-Repair-Installation-Jun-2023)\n - [API & Integrations - Mimecast API 2.0 - Jun 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000397477011-API-Integrations-Mimecast-API-2-0-Jun-2023)\n - [URL Protect - URL Reporting Enhancement - May 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000397669395-URL-Protect-URL-Reporting-Enhancement-May-2023)\n - [Policies - Permitted Senders - May 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000416256659-Policies-Permitted-Senders-May-2023)\n - [Mimecast Synchronization Engine - Release 4.5.0.463 - Apr 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000595615507-Mimecast-Synchronization-Engine-Release-4-5-0-463-Apr-2023)\n - [API & Integrations - Add API Applications Button Removal - Mar 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000639107603-API-Integrations-Add-API-Applications-Button-Removal-Mar-2023)\n - [Polcies - Auto Allow Spam Scanning - Mar 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000630679059-Polcies-Auto-Allow-Spam-Scanning-Mar-2023)\n - [Mimecast Synchronization Engine - Release 4.5.0.462 - Feb 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000658424211-Mimecast-Synchronization-Engine-Release-4-5-0-462-Feb-2023)\n - [Directory Synchronization - Security Enhancements for Azure AD Sync Integrations - Feb 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000618060307-Directory-Synchronization-Security-Enhancements-for-Azure-AD-Sync-Integrations-Feb-2023)\n - [Directory Synchronization - On-Premises Directory Integration Connectivity - Feb 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000664944531-Directory-Synchronization-On-Premises-Directory-Integration-Connectivity-Feb-2023)\n - [Directory Synchronization - Using a Connector - Jan 2023](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000650088979-Directory-Synchronization-Using-a-Connector-Jan-2023)\n - [DMARC Analyzer - Reporting - Nov 2022](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000320242707-DMARC-Analyzer-Reporting-Nov-2022)\n - [Authentication - SMTP Authentication Restrictions - Oct 2022](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000605257491-Authentication-SMTP-Authentication-Restrictions-Oct-2022)\n - [Journaling - Non-Secure POP3 Connections - Oct 2022](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000665405459-Journaling-Non-Secure-POP3-Connections-Oct-2022)\n - [Directory Synchronization - Console Refresh - Oct 2022](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000619896083-Directory-Synchronization-Console-Refresh-Oct-2022)\n - [Attachment Protect - Sandbox Timeout - Oct 2022](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000697737491-Attachment-Protect-Sandbox-Timeout-Oct-2022)\n - [Contact Export Wizard - EOL - Jul 2022](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000637480595-Contact-Export-Wizard-EOL-Jul-2022)\n - [URL Protection - Machine Learning Detection - Jul 2022](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000415807507-URL-Protection-Machine-Learning-Detection-Jul-2022)\n - [API & Integrations - Legacy TLS End Of Life - Jun 2022](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000578790291-API-Integrations-Legacy-TLS-End-Of-Life-Jun-2022)\n - [API & Integrations - Migration To MS Graph - Jun 2022](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000659169171-API-Integrations-Migration-To-MS-Graph-Jun-2022)\n - [Mimecast for Outlook - v7.10 R1 - Jun 2022](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420615315-Mimecast-for-Outlook-v7-10-R1-Jun-2022)\n - [Authentication - Domain Authentication for Microsoft Exchange Online EOL - May 2022](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000840753555-Authentication-Domain-Authentication-for-Microsoft-Exchange-Online-EOL-May-2022)\n - [Mimecast Mobile - Improvements - Apr 2022](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000837566739-Mimecast-Mobile-Improvements-Apr-2022)\n - [Message Tracking - Time Zone - Apr 2022](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000798049427-Message-Tracking-Time-Zone-Apr-2022)\n - [Mimecast Mobile - Improvements - Mar 2022](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000810085651-Mimecast-Mobile-Improvements-Mar-2022)\n - [DMARC Analyzer - v2.40.0 Release Notes - Mar 2022](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000797314323-DMARC-Analyzer-v2-40-0-Release-Notes-Mar-2022)\n - [Mimecast Administration Console - Alias Accounts - Feb 2022](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000578001171-Mimecast-Administration-Console-Alias-Accounts-Feb-2022)\n - [API & Integrations - Mimecast For LogRhythm Integration Update - Feb 2022](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000838844307-API-Integrations-Mimecast-For-LogRhythm-Integration-Update-Feb-2022)\n - [Supervision - Reporting - Jan 2022](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000840803987-Supervision-Reporting-Jan-2022)\n - [DMARC Analyzer - v2.39.0 Release Notes - Dec 2021](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000810462611-DMARC-Analyzer-v2-39-0-Release-Notes-Dec-2021)\n - [Brand Exploit Protect - Version Update - Aug 2021](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000811386259-Brand-Exploit-Protect-Version-Update-Aug-2021)\n - [DMARC Analyzer - v2.38.0 Release Notes - Aug 2021](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000665516179-DMARC-Analyzer-v2-38-0-Release-Notes-Aug-2021)\n - [Policies - Address Alteration Policies - Aug 2021](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000826372883-Policies-Address-Alteration-Policies-Aug-2021)\n - [Mimecast Essentials For Outlook - Held Messages - Jul 2021](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000840937107-Mimecast-Essentials-For-Outlook-Held-Messages-Jul-2021)\n - [DMARC Analyzer - v2.37.0 - Jul 2021](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000837870355-DMARC-Analyzer-v2-37-0-Jul-2021)\n - [Connectors - Server Connections - Jun 2021](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000689179155-Connectors-Server-Connections-Jun-2021)\n - [DMARC Analyzer - Release Notes - Apr 2021](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000624166163-DMARC-Analyzer-Release-Notes-Apr-2021)\n - [Awareness Training - Season 5 - Apr 2021](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000841723155-Awareness-Training-Season-5-Apr-2021)\n - [API & Integrations - ServiceNow Integration - Jul 2020](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000655966611-API-Integrations-ServiceNow-Integration-Jul-2020)\n - [Awareness Training - End User Naming and German Language Updates - May 2020](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000837448979-Awareness-Training-End-User-Naming-and-German-Language-Updates-May-2020)\n - [Impersonation Protect - Display Names - Mar 2020](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000392488467-Impersonation-Protect-Display-Names-Mar-2020)\n - [Connectors - Microsoft LDAP Hardening - Jan 2020](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000805343123-Connectors-Microsoft-LDAP-Hardening-Jan-2020)\n - [Email Security Cloud Gateway - Administration Console 4.1.2 - Nov 2019](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000723824531-Email-Security-Cloud-Gateway-Administration-Console-4-1-2-Nov-2019)\n - [Mimecast Administration Console - version 4.1.1 - Nov 2019](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000765554195-Mimecast-Administration-Console-version-4-1-1-Nov-2019)\n\n# Service Update\n\n| | |\n| --- | --- |\n| **Availability** | September 10th, 2024 |\n| **Product(s)** | Email Security Cloud Gateway (CG) |\n| **Who's affected** | Email Security Cloud Gateway (CG), Administrators |\n\n## Overview\n\nMimecast is pleased to announce the general availability of _**Secure Email Gateway Restful API Endpoints**_ that allow users to configure and manage _**User and Group Management**_, _**Connectors**_, _**Policy Management**_, _**Email Security Cloud Gateway**_, and _**Domain Management**_ using Mimecast APIs.\n\nThese endpoints can be used to create, manage, and verify the below capabilities:\n\n- Directory integrations such as creating connectors, testing connectivity and initiating directory sync.\n- Grey listing policies.\n- Delivery Route policies.\n- DNS Outbound policies.\n- Anti-spoofing and Anti-spoofing bypass policies.\n- Get Email Statistics.\n- Journaling Service.\n- User Group Management, such as managing group members.\n- Inbound MX Record.\n\nAdditionally, these endpoints can also be used for onboarding to _**Mimecast Cloud Gateway**_ services. Please refer to following tutorial for guidance on using these endpoints for onboarding purposes: [Secure Email Gateway - Onboarding with REST APIs](https://developer.services.mimecast.com/secure-email-gateway \"https://developer.services.mimecast.com/secure-email-gateway\").\n\n## What's changing\n\nThe following _**Restful API Endpoints**_ will be made available on _**API Gateway**_:\n\n### Directory Integration\n\n- Get all directory integrations.\n- Create directory integration \\[Active Directory\\].\n- Create directory integration \\[M365\\].\n- Create directory integration \\[Google\\].\n- Get directory integration \\[Active Directory\\].\n- Get directory integration \\[M365\\].\n- Get directory integration \\[Google\\].\n- Update directory integration \\[Active Directory\\].\n- Update directory integration \\[M365\\].\n- Update directory integration \\[Google\\].\n- Delete directory integration \\[Active Directory\\].\n- Delete directory integration \\[M365\\].\n- Delete directory integration \\[Google\\].\n- Test-connectivity directory connection \\[Active Directory\\].\n- Test-egress-connectivity directory connection \\[Active Directory\\].\n- Test-authentication directory connection \\[Active Directory\\].\n- Test-validation directory connection \\[Active Directory\\].\n- Test-certificates directory connection \\[Active Directory\\].\n- Test-email directory connection \\[Active Directory\\].\n- Test-connectivity directory connection \\[M365\\].\n- Test-authentication directory connection \\[M365\\].\n- Test-authorisation directory connection \\[M365\\].\n- Test-connector directory connection \\[M365\\].\n- Test-email directory connection \\[M365\\].\n- Test-connectivity directory connection \\[Google\\].\n- Test-authentication directory connection \\[Google\\].\n- Test-authorisation directory connection \\[Google\\].\n- Test-email directory connection \\[Google\\].\n- Request directory sync.\n\n### Connectors\n\n- Create Directory Connector \\[M365\\].\n- Update Directory Connector \\[M365\\].\n- Delete Directory Connector \\[M365\\].\n- Get Directory Connector \\[M365\\].\n\n### Policy Management\n\n- Get all greylisting policies.\n- Get greylisting policy.\n- Create greylisting policy.\n- Update greylisting policy.\n- Delete greylisting policy.\n- Get all delivery route definitions.\n- Get delivery route definition.\n- Create delivery route definition.\n- Update delivery route definition.\n- Delete delivery route definition.\n- Get all delivery route policies.\n- Get delivery route policy.\n- Create delivery route policy.\n- Update delivery route policy.\n- Delete delivery route policy.\n- Verify delivery route (action).\n- Get all DNS Authentication - Outbound definitions.\n- Get DNS Authentication - Outbound definition.\n- Create DNS Authentication - Outbound definition.\n- Update DNS Authentication - Outbound definition.\n- Delete DNS Authentication - Outbound definition.\n- Get all DNS Authentication - Outbound policies.\n- Get DNS Authentication - Outbound policy.\n- Create DNS Authentication - Outbound policy.\n- Update DNS Authentication - Outbound policy.\n- Delete DNS Authentication - Outbound policy.\n- Get all anti-spoofing policies.\n- Get anti-spoofing policy.\n- Create anti-spoofing policy.\n- Update anti-spoofing policy.\n- Delete anti-spoofing policy.\n- Get all anti-spoofing bypass policies.\n- Get anti-spoofing bypass policy.\n- Create anti-spoofing bypass policy.\n- Update anti-spoofing bypass policy.\n- Delete anti-spoofing bypass policy.\n\n### Email Security Cloud Gateway\n\n- Get email statistics.\n- Create Journaling Service.\n- Get all Journaling Services.\n- Get Journaling Service.\n- Update Journaling Service.\n- Delete Journaling Service.\n\n### User and Group Management\n\n- Find groups.\n- Get group.\n- Get group members.\n- Add group members.\n- Remove group members.\n\n### Domain Management\n\n- Verify inbound MX (action).\n\n## Recommended actions\n\nFamiliarize yourself with:\n\n- [Mimecast API capabilities](https://developer.services.mimecast.com/apis \"https://developer.services.mimecast.com/apis\")\n- [Mimecast Alliance Partners](https://integrations.mimecast.com/tech-partners/?_gl=1*rllq74*_ga*MTM5NTc0NDcxMy4xNzA4MDY4MzEx*_ga_2RRJFGC554*MTcxMDQxNzczMC45Ni4xLjE3MTA0MTg3NDguNTkuMC4w)\n\n## See Also...\n\n- [API 2.0 Overview](https://developer.services.mimecast.com/api-overview \"https://developer.services.mimecast.com/api-overview\")\n- [API 2.0 What's New](https://developer.services.mimecast.com/whats-new)\n\n#### Related to\n\n- [API & Integrations](https://mimecastsupport.zendesk.com/hc/en-us/search?content_tags=01JCK4N0EPJF6KTPT3MABR16T9&utf8=%E2%9C%93 \"Search results\")\n- [Email Security - MX](https://mimecastsupport.zendesk.com/hc/en-us/search?content_tags=01KHKDGGTJ2C9RGD5GZ7PXX7M0&utf8=%E2%9C%93 \"Search results\")\n\nPlease [sign in](https://mimecastsupport.zendesk.com/access?locale=en-us&brand_id=28063027612179&return_to=https%3A%2F%2Fmimecastsupport.zendesk.com%2Fhc%2Fen-us%2Farticles%2F34000420576659-API-Integrations-New-API-Endpoints-Sep-2024) to leave a comment.\n\n#### Table of contents\n\nOverview\n\n- [Overview](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420576659-API-Integrations-New-API-Endpoints-Sep-2024#h_01K06VEV6M8MCJ1S05BCQ92XSB)\n- [What's changing](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420576659-API-Integrations-New-API-Endpoints-Sep-2024#h_01JPQ8DZS2WD7ZYP5K0JZE3XTB)\n- [Directory Integration](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420576659-API-Integrations-New-API-Endpoints-Sep-2024#h_01JDW74XKPZ663N2S4R4GT29GQ)\n- [Connectors](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420576659-API-Integrations-New-API-Endpoints-Sep-2024#h_01JDW74XKP41D59TP5B78FM57Q)\n- [Policy Management](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420576659-API-Integrations-New-API-Endpoints-Sep-2024#h_01JDW74XKPVW0VSWKZZHV4R18T)\n- [Email Security Cloud Gateway](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420576659-API-Integrations-New-API-Endpoints-Sep-2024#h_01JDW74XKPA8WXJ00N2VZRWF9P)\n- [User and Group Management](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420576659-API-Integrations-New-API-Endpoints-Sep-2024#h_01JDW74XKP4HZ8JFX9Y5ZYGBQR)\n- [Domain Management](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420576659-API-Integrations-New-API-Endpoints-Sep-2024#h_01JDW74XKPCTPZHSBZBY83HBXX)\n- [Recommended actions](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420576659-API-Integrations-New-API-Endpoints-Sep-2024#h_01JDW74XKP9X4VHZZ3HVC602KY)\n- [See Also...](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420576659-API-Integrations-New-API-Endpoints-Sep-2024#h_01JDW74XKP67F7V11XGSH7V39H)\n- [Related to](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420576659-API-Integrations-New-API-Endpoints-Sep-2024#related-to-10)\n\nReturn to top\n\n\ninstallation, branding, customization","metadata":{"og:description":"Service Update\n \n \n \n Availability\n \n September 10th, 2024\n \n \n \n Product(s)\n \n Email Security Cloud Gateway (CG)\n ...","ogUrl":"https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420576659-API-Integrations-New-API-Endpoints-Sep-2024","og:image":"https://mimecastsupport.zendesk.com/hc/theming_assets/01JDW0MS8H4Q6FHWQV5JKA1XPB","ogImage":"https://mimecastsupport.zendesk.com/hc/theming_assets/01JDW0MS8H4Q6FHWQV5JKA1XPB","title":"API & Integrations - New API Endpoints - Sep 2024 – Mimecast","description":"Service Update Availability September 10th, 2024 ...","og:url":"https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420576659-API-Integrations-New-API-Endpoints-Sep-2024","language":"en-US","ogDescription":"Service Update\n \n \n \n Availability\n \n September 10th, 2024\n \n \n \n Product(s)\n \n Email Security Cloud Gateway (CG)\n ...","og:site_name":"Mimecast","ogTitle":"API & Integrations - New API Endpoints - Sep 2024","og:type":"website","og:title":"API & Integrations - New API Endpoints - Sep 2024","ogSiteName":"Mimecast","viewport":"width=device-width, initial-scale=1.0","favicon":"https://mimecastsupport.zendesk.com/hc/theming_assets/01JZ0NAR4QXDPSW25VSVN5Y2WC","scrapeId":"019d46c9-4df1-70ca-9269-b608cbea272e","sourceURL":"https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420576659-API-Integrations-New-API-Endpoints-Sep-2024","url":"https://mimecastsupport.zendesk.com/hc/en-us/articles/34000420576659-API-Integrations-New-API-Endpoints-Sep-2024","statusCode":200,"contentType":"text/html; charset=utf-8","proxyUsed":"basic","cacheState":"hit","cachedAt":"2026-03-30T08:49:20.782Z","creditsUsed":1}},{"url":"https://integrations.mimecast.com/de/documentation/endpoint-reference/message-queues/get-hold-summary-list/","title":"Get Message Hold Summary List - API and Integrations | Mimecast","description":"Description. This API endpoint can be used to get counts of currenlty held messages for each hold reason. Hold reasons can reference policy ...","position":3,"markdown":"**In this guide:**\n\n- [Description](https://integrations.mimecast.com/de/documentation/endpoint-reference/message-queues/get-hold-summary-list/#description)\n- [Pre-requisites](https://integrations.mimecast.com/de/documentation/endpoint-reference/message-queues/get-hold-summary-list/#pre-requisites)\n- [URI](https://integrations.mimecast.com/de/documentation/endpoint-reference/message-queues/get-hold-summary-list/#uri)\n- [Request Headers](https://integrations.mimecast.com/de/documentation/endpoint-reference/message-queues/get-hold-summary-list/#request-headers)\n- [Request Body](https://integrations.mimecast.com/de/documentation/endpoint-reference/message-queues/get-hold-summary-list/#request-body)\n- [Response](https://integrations.mimecast.com/de/documentation/endpoint-reference/message-queues/get-hold-summary-list/#response)\n- [Sample Code](https://integrations.mimecast.com/de/documentation/endpoint-reference/message-queues/get-hold-summary-list/#sample-code)\n\n#### Description\n\nThis API endpoint can be used to get counts of currenlty held messages for each hold reason. Hold reasons can reference policy actions or definition names.\n\n#### Pre-requisites\n\n- In order to successfully use this endpoint the logged in user must be a Mimecast administrator with at least the **Account \\| Monitoring \\| Held Summary \\| Read** permission.\n\n#### URI\n\nTo use this endpoint you send a POST request to:\n\n- /api/gateway/get-hold-summary-list\n\n#### Request Headers\n\nThe following request headers must be included in your request:\n\n| **Field** | **Description** |\n| --- | --- |\n| Authorization | Please see the [Authorization](https://integrations.mimecast.com/de/documentation/api-overview/authorization/) guide for more information on building the Authorization header. |\n| x-mc-req-id | A randomly generated GUID, for example,
```
8578FCFC-A305-4D9A-99CB-F4D5ECEFE297
``` |\n| x-mc-app-id | The Application ID provided with your Registered API Application. |\n| x-mc-date | The current date and time in the following format, for example,
```
Tue, 24 Nov 2015 12:50:11 UTC
``` |\n\n#### Request Body\n\n```\n\n{\n\n \"data\": []\n\n}\n```\n\n##### data\n\n| **Field** | **Type** | **Required** | **Description** |\n| --- | --- | --- | --- |\n\n#### Response\n\n```\n\n{\n\n \"fail\": [],\n\n \"meta\": {\n\n \"status\": 200\n\n },\n\n \"data\": [\\\n\\\n {\\\n\\\n \"policyInfo\": \"String\",\\\n\\\n \"numberOfItems\": \"Number\"\\\n\\\n }\\\n\\\n ]\n\n}\n```\n\n##### meta object\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| status | Number | The function level status of the request. |\n\n##### meta\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| status | Number | The function level status of the request. |\n\n##### data\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| policyInfo | String | The name of the policy or definition that held a message |\n| numberOfItems | Number | The number of messages currently held for this reason |\n\n#### Sample Code\n\nSample code is provided to demonstrate how to use the API and is not representative of a production application. To use the sample code; complete the required variables as described, populate the desired values in the request body, and execute in your favorite IDE.  Please see the [Global Base URL's](https://integrations.mimecast.com/de/documentation/api-overview/global-base-urls/) page to find the correct base URL to use for your account.\n\nHTTPPythonC#PowerShellJava\n\n```\n\nPOST {base_url}/api/gateway/get-hold-summary-list\n\nAuthorization: MC {accesskKey}:{Base64 encoded signed Data To Sign}\n\nx-mc-date: {dateTime}\n\nx-mc-req-id: {unique id}\n\nx-mc-app-id: {applicationId}\n\nContent-Type: application/json\n\nAccept: application/json\n\n\n\n{\n\n \"data\":[\\\n\\\n {\\\n\\\n \"data\":[]\\\n\\\n }\\\n\\\n ]\n\n}\n```\n\n```\n\nimport base64\n\nimport hashlib\n\nimport hmac\n\nimport uuid\n\nimport datetime\n\nimport requests\n\n\n\n# Setup required variables\n\nbase_url = \"https://xx-api.mimecast.com\"\n\nuri = \"/api/gateway/get-hold-summary-list\"\n\nurl = base_url + uri\n\naccess_key = \"YOUR ACCESS KEY\"\n\nsecret_key = \"YOUR SECRET KEY\"\n\napp_id = \"YOUR APPLICATION ID\"\n\napp_key = \"YOUR APPLICATION KEY\"\n\n\n\n# Generate request header values\n\nrequest_id = str(uuid.uuid4())\n\nhdr_date = datetime.datetime.utcnow().strftime(\"%a, %d %b %Y %H:%M:%S\") + \" UTC\"\n\n\n\n# DataToSign is used in hmac_sha1\n\ndataToSign = ':'.join([hdr_date, request_id, uri, app_key])\n\n\n\n# Create the HMAC SHA1 of the Base64 decoded secret key for the Authorization header\n\nhmac_sha1 = hmac.new(base64.b64decode(secret_key), dataToSign.encode(), digestmod=hashlib.sha1).digest()\n\n\n\n# Use the HMAC SHA1 value to sign the hdrDate + \":\" requestId + \":\" + URI + \":\" + appkey\n\nsig = base64.b64encode(hmac_sha1).rstrip()\n\n\n\n# Create request headers\n\nheaders = {\n\n 'Authorization': 'MC ' + access_key + ':' + sig.decode(),\n\n 'x-mc-app-id': app_id,\n\n 'x-mc-date': hdr_date,\n\n 'x-mc-req-id': request_id,\n\n 'Content-Type': 'application/json'\n\n}\n\n\n\npayload = {\n\n 'data': []\n\n }\n\n\n\nr = requests.post(url=url, headers=headers, data=str(payload))\n\n\n\nprint(r.text)\n```\n\n```\n\nstatic void Main(string[] args)\n\n {\n\n //Setup required variables\n\n string baseUrl = \"https://xx-api.mimecast.com\";\n\n string uri = \"/api/gateway/get-hold-summary-list\";\n\n string accessKey = \"YOUR ACCESS KEY\";\n\n string secretKey = \"YOUR SECRET KEY\";\n\n string appId = \"YOUR APPLICATION ID\";\n\n string appKey = \"YOUR APPLICATION KEY\";\n\n\n\n //Generate request header values\n\n string hdrDate = System.DateTime.Now.ToUniversalTime().ToString(\"R\");\n\n string requestId = System.Guid.NewGuid().ToString();\n\n\n\n //Create the HMAC SHA1 of the Base64 decoded secret key for the Authorization header\n\n System.Security.Cryptography.HMAC h = new System.Security.Cryptography.HMACSHA1(System.Convert.FromBase64String(secretKey));\n\n\n\n //Use the HMAC SHA1 value to sign the hdrDate + \":\" requestId + \":\" + URI + \":\" + appkey\n\n byte[] hash = h.ComputeHash(System.Text.Encoding.Default.GetBytes(hdrDate + \":\" + requestId + \":\" + uri + \":\" + appKey));\n\n\n\n //Build the signature to be included in the Authorization header in your request\n\n string signature = \"MC \" + accessKey + \":\" + System.Convert.ToBase64String(hash);\n\n\n\n //Build Request\n\n System.Net.HttpWebRequest request = (System.Net.HttpWebRequest)System.Net.WebRequest.Create(baseUrl + uri);\n\n request.Method = \"POST\";\n\n request.ContentType = \"application/json\";\n\n\n\n //Add Headers\n\n request.Headers[System.Net.HttpRequestHeader.Authorization] = signature;\n\n request.Headers.Add(\"x-mc-date\", hdrDate);\n\n request.Headers.Add(\"x-mc-req-id\", requestId);\n\n request.Headers.Add(\"x-mc-app-id\", appId);\n\n\n\n //Add request body\n\n //Create and write data to stream\n\n string postData = @\"{\n\n \"\"data\"\": []\n\n }\";\n\n\n\n byte[] payload = System.Text.Encoding.UTF8.GetBytes(postData);\n\n\n\n System.IO.Stream stream = request.GetRequestStream();\n\n stream.Write(payload, 0, payload.Length);\n\n stream.Close();\n\n\n\n //Send Request\n\n System.Net.HttpWebResponse response = (System.Net.HttpWebResponse)request.GetResponse();\n\n\n\n //Output response to console\n\n System.IO.StreamReader reader = new System.IO.StreamReader(response.GetResponseStream());\n\n string responseBody = \"\";\n\n string temp = null;\n\n while ((temp = reader.ReadLine()) != null)\n\n {\n\n responseBody += temp;\n\n };\n\n System.Console.WriteLine(responseBody);\n\n System.Console.ReadLine();\n\n }\n```\n\n```\n\n#Setup required variables\n\n$baseUrl = \"https://xx-api.mimecast.com\"\n\n$uri = \"/api/gateway/get-hold-summary-list\"\n\n$url = $baseUrl + $uri\n\n$accessKey = \"YOUR ACCESS KEY\"\n\n$secretKey = \"YOUR SECRET KEY\"\n\n$appId = \"YOUR APPLICATION ID\"\n\n$appKey = \"YOUR APPLICATION KEY\"\n\n\n\n#Generate request header values\n\n$hdrDate = (Get-Date).ToUniversalTime().ToString(\"ddd, dd MMM yyyy HH:mm:ss UTC\")\n\n$requestId = [guid]::NewGuid().guid\n\n\n\n#Create the HMAC SHA1 of the Base64 decoded secret key for the Authorization header\n\n$sha = New-Object System.Security.Cryptography.HMACSHA1\n\n$sha.key = [Convert]::FromBase64String($secretKey)\n\n$sig = $sha.ComputeHash([Text.Encoding]::UTF8.GetBytes($hdrDate + \":\" + $requestId + \":\" + $uri + \":\" + $appKey))\n\n$sig = [Convert]::ToBase64String($sig)\n\n\n\n#Create Headers\n\n$headers = @{\"Authorization\" = \"MC \" + $accessKey + \":\" + $sig;\n\n \"x-mc-date\" = $hdrDate;\n\n \"x-mc-app-id\" = $appId;\n\n \"x-mc-req-id\" = $requestId;\n\n \"Content-Type\" = \"application/json\"}\n\n\n\n#Create post body\n\n$postBody = \"{\n\n \"\"data\"\": []\n\n }\"\n\n\n\n#Send Request\n\n$response = Invoke-RestMethod -Method Post -Headers $headers -Body $postBody -Uri $url\n\n\n\n#Print the response\n\n$response\n```\n\n```\n\npublic static void main(String[] args) throws java.io.IOException, java.security.NoSuchAlgorithmException, java.security.InvalidKeyException {\n\n\n\n //set up variables for request\n\n String baseUrl = \"https://xx-api.mimecast.com\";\n\n String uri = \"/api/gateway/get-hold-summary-list\";\n\n String url = \"https://\" + baseUrl + uri;\n\n String accessKey = \"YOUR ACCESS KEY\";\n\n String secretKey = \"YOUR SECRET KEY\";\n\n String appId = \"YOUR APPLICATION ID\";\n\n String appKey = \"YOUR APPLICATION KEY\";\n\n\n\n //create URL object\n\n java.net.URL obj = new java.net.URL(url);\n\n\n\n // set guid for x-mc-req-id header\n\n String guid = java.util.UUID.randomUUID().toString();\n\n\n\n // set date for x-mc-date header\n\n java.text.SimpleDateFormat sdf = new java.text.SimpleDateFormat(\"EEE, d MMM yyyy HH:mm:ss z\");\n\n sdf.setTimeZone(java.util.TimeZone.getTimeZone(\"UTC\"));\n\n String date = sdf.format(new java.util.Date());\n\n\n\n //create signature for the Authorization header\n\n String dataToSign = date + \":\" + guid + \":\" + uri + \":\" + appKey;\n\n String hmacSHA1 = \"HmacSHA1\";\n\n javax.crypto.spec.SecretKeySpec signingKey = new javax.crypto.spec.SecretKeySpec(org.apache.commons.codec.binary.Base64.decodeBase64(secretKey.getBytes()), hmacSHA1);\n\n javax.crypto.Mac mac = javax.crypto.Mac.getInstance(hmacSHA1);\n\n mac.init(signingKey);\n\n String sig = new String(org.apache.commons.codec.binary.Base64.encodeBase64(mac.doFinal(dataToSign.getBytes())));\n\n\n\n // create request object\n\n javax.net.ssl.HttpsURLConnection con = (javax.net.ssl.HttpsURLConnection) obj.openConnection();\n\n\n\n //set request type to POST\n\n con.setRequestMethod(\"POST\");\n\n con.setDoOutput(true);\n\n\n\n //add reuqest headers\n\n con.setRequestProperty(\"Authorization\", \"MC \" + accessKey + \":\" + sig);\n\n con.setRequestProperty(\"x-mc-req-id\", guid);\n\n con.setRequestProperty(\"x-mc-app-id\", appId);\n\n con.setRequestProperty(\"x-mc-date\", date);\n\n con.setRequestProperty(\"Content-Type\", \"application/json\");\n\n con.setRequestProperty(\"Accept\", \"application/json\");\n\n\n\n //Add post body to the request\n\n String postBody = \"{\\n\" +\n\n \" \\\"data\\\": []\\n\" +\n\n \"}\";\n\n java.io.OutputStream os = con.getOutputStream();\n\n os.write(postBody.getBytes(\"UTF-8\"));\n\n os.close();\n\n\n\n //process response\n\n java.io.BufferedReader in = new java.io.BufferedReader(\n\n new java.io.InputStreamReader(con.getInputStream()));\n\n String inputLine;\n\n StringBuffer response = new StringBuffer();\n\n\n\n while ((inputLine = in.readLine()) != null) {\n\n response.append(inputLine);\n\n }\n\n in.close();\n\n\n\n //return result\n\n java.lang.System.out.println(response.toString());\n\n }\n```\n\n[Zurück zum Anfang](https://integrations.mimecast.com/de/documentation/endpoint-reference/message-queues/get-hold-summary-list/#)","metadata":{"robots":"index, follow","og:site_name":"Mimecast","ogLocale":"de_DE","ogUrl":"https://integrations.mimecast.com/de/documentation/endpoint-reference/message-queues/get-hold-summary-list/","VIcurrentDateTime":["639106058917231207>","639106058917231265"],"viewport":"width=device-width, initial-scale=1, shrink-to-fit=no","title":"Get Message Hold Summary List | Mimecast","og:title":"Get Message Hold Summary List","og:description":"Mimecast API Get Message Hold Summary List","description":"Mimecast API Get Message Hold Summary List","ogTitle":"Get Message Hold Summary List","ogDescription":"Mimecast API Get Message Hold Summary List","og:locale":"de_DE","author":"mimecast","theme-color":"#ffffff","og:url":"https://integrations.mimecast.com/de/documentation/endpoint-reference/message-queues/get-hold-summary-list/","ogSiteName":"Mimecast","VirtualFolder":["\\","/"],"language":"de","favicon":"https://integrations.mimecast.com/sc-static/img/favicons/icons_m_192x192.png","scrapeId":"019d46c9-4df1-70ca-9269-b95fe8f2940a","sourceURL":"https://integrations.mimecast.com/de/documentation/endpoint-reference/message-queues/get-hold-summary-list/","url":"https://integrations.mimecast.com/de/documentation/endpoint-reference/message-queues/get-hold-summary-list/","statusCode":200,"contentType":"text/html; charset=utf-8","timezone":"America/New_York","proxyUsed":"basic","cacheState":"miss","indexId":"83b025d4-3c68-4e7d-828c-79e7f9bc0c8f","creditsUsed":1}},{"url":"https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/release-message/","title":"Release Message - API and Integrations | Mimecast","description":"This API endpoint can be used to release a currently held message based on the Find Held Messages API endpoint.","position":4,"markdown":"**In this guide:**\n\n- [Description](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/release-message/#description)\n- [Pre-requisites](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/release-message/#pre-requisites)\n- [URI](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/release-message/#uri)\n- [Request Headers](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/release-message/#request-headers)\n- [Request Body](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/release-message/#request-body)\n- [Response](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/release-message/#response)\n- [Sample Code](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/release-message/#sample-code)\n\n#### Description\n\nThis API endpoint can be used to release a currently held message based on the Find Held Messages API endpoint\n\n#### Pre-requisites\n\n- In order to successfully use this endpoint the logged in user must be a Mimecast administrator with at least the **Account \\| Monitoring \\| Held \\| Edit** permission.\n\n#### URI\n\nTo use this endpoint you send a POST request to:\n\n- /api/gateway/hold-release\n\n#### Request Headers\n\nThe following request headers must be included in your request:\n\n| **Field** | **Description** |\n| --- | --- |\n| Authorization | Please see the [Authorization](https://integrations.mimecast.com/documentation/api-overview/authorization/) guide for more information on building the Authorization header. |\n| x-mc-req-id | A randomly generated GUID, for example,
```
8578FCFC-A305-4D9A-99CB-F4D5ECEFE297
``` |\n| x-mc-app-id | The Application ID provided with your Registered API Application. |\n| x-mc-date | The current date and time in the following format, for example,
```
Tue, 24 Nov 2015 12:50:11 UTC
``` |\n\n#### Request Body\n\n```\n\n{\n\n \"data\": [\\\n\\\n {\\\n\\\n \"id\": \"String\"\\\n\\\n }\\\n\\\n ]\n\n}\n```\n\n##### data\n\n| **Field** | **Type** | **Required** | **Description** |\n| --- | --- | --- | --- |\n| id | String | Required | The Mimecast secure id of a message, which can be found using the Find Held Messages API endpoint |\n\n#### Response\n\n```\n\n{\n\n \"fail\": [],\n\n \"meta\": {\n\n \"status\": 200\n\n },\n\n \"data\": [\\\n\\\n {\\\n\\\n \"release\": \"Boolean\",\\\n\\\n \"id\": \"String\"\\\n\\\n }\\\n\\\n ]\n\n}\n```\n\n##### meta object\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| status | Number | The function level status of the request. |\n\n##### meta\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| status | Number | The function level status of the request. |\n\n##### data\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| release | Boolean | Returns true if the message was released |\n| id | String | The Mimecast secure id of the message hold |\n\n#### Sample Code\n\nSample code is provided to demonstrate how to use the API and is not representative of a production application. To use the sample code; complete the required variables as described, populate the desired values in the request body, and execute in your favorite IDE.  Please see the [Global Base URL's](https://integrations.mimecast.com/documentation/api-overview/global-base-urls/) page to find the correct base URL to use for your account.\n\nHTTPPythonC#PowerShellJava\n\n```\n\nPOST {base_url}/api/gateway/hold-release\n\nAuthorization: MC {accesskKey}:{Base64 encoded signed Data To Sign}\n\nx-mc-date: {dateTime}\n\nx-mc-req-id: {unique id}\n\nx-mc-app-id: {applicationId}\n\nContent-Type: application/json\n\nAccept: application/json\n\n\n\n{\n\n \"data\":[\\\n\\\n {\\\n\\\n \"id\": \"String\"\\\n\\\n }\\\n\\\n ]\n\n}\n```\n\n```\n\nimport base64\n\nimport hashlib\n\nimport hmac\n\nimport uuid\n\nimport datetime\n\nimport requests\n\n\n\n# Setup required variables\n\nbase_url = \"https://xx-api.mimecast.com\"\n\nuri = \"/api/gateway/hold-release\"\n\nurl = base_url + uri\n\naccess_key = \"YOUR ACCESS KEY\"\n\nsecret_key = \"YOUR SECRET KEY\"\n\napp_id = \"YOUR APPLICATION ID\"\n\napp_key = \"YOUR APPLICATION KEY\"\n\n\n\n# Generate request header values\n\nrequest_id = str(uuid.uuid4())\n\nhdr_date = datetime.datetime.utcnow().strftime(\"%a, %d %b %Y %H:%M:%S\") + \" UTC\"\n\n\n\n# DataToSign is used in hmac_sha1\n\ndataToSign = ':'.join([hdr_date, request_id, uri, app_key])\n\n\n\n# Create the HMAC SHA1 of the Base64 decoded secret key for the Authorization header\n\nhmac_sha1 = hmac.new(base64.b64decode(secret_key), dataToSign.encode(), digestmod=hashlib.sha1).digest()\n\n\n\n# Use the HMAC SHA1 value to sign the hdrDate + \":\" requestId + \":\" + URI + \":\" + appkey\n\nsig = base64.b64encode(hmac_sha1).rstrip()\n\n\n\n# Create request headers\n\nheaders = {\n\n 'Authorization': 'MC ' + access_key + ':' + sig.decode(),\n\n 'x-mc-app-id': app_id,\n\n 'x-mc-date': hdr_date,\n\n 'x-mc-req-id': request_id,\n\n 'Content-Type': 'application/json'\n\n}\n\n\n\npayload = {\n\n 'data': [\\\n\\\n {\\\n\\\n \"id\": \"String\"\\\n\\\n }\\\n\\\n ]\n\n }\n\n\n\nr = requests.post(url=url, headers=headers, data=str(payload))\n\n\n\nprint(r.text)\n```\n\n```\n\nstatic void Main(string[] args)\n\n {\n\n //Setup required variables\n\n string baseUrl = \"https://xx-api.mimecast.com\";\n\n string uri = \"/api/gateway/hold-release\";\n\n string accessKey = \"YOUR ACCESS KEY\";\n\n string secretKey = \"YOUR SECRET KEY\";\n\n string appId = \"YOUR APPLICATION ID\";\n\n string appKey = \"YOUR APPLICATION KEY\";\n\n\n\n //Generate request header values\n\n string hdrDate = System.DateTime.Now.ToUniversalTime().ToString(\"R\");\n\n string requestId = System.Guid.NewGuid().ToString();\n\n\n\n //Create the HMAC SHA1 of the Base64 decoded secret key for the Authorization header\n\n System.Security.Cryptography.HMAC h = new System.Security.Cryptography.HMACSHA1(System.Convert.FromBase64String(secretKey));\n\n\n\n //Use the HMAC SHA1 value to sign the hdrDate + \":\" requestId + \":\" + URI + \":\" + appkey\n\n byte[] hash = h.ComputeHash(System.Text.Encoding.Default.GetBytes(hdrDate + \":\" + requestId + \":\" + uri + \":\" + appKey));\n\n\n\n //Build the signature to be included in the Authorization header in your request\n\n string signature = \"MC \" + accessKey + \":\" + System.Convert.ToBase64String(hash);\n\n\n\n //Build Request\n\n System.Net.HttpWebRequest request = (System.Net.HttpWebRequest)System.Net.WebRequest.Create(baseUrl + uri);\n\n request.Method = \"POST\";\n\n request.ContentType = \"application/json\";\n\n\n\n //Add Headers\n\n request.Headers[System.Net.HttpRequestHeader.Authorization] = signature;\n\n request.Headers.Add(\"x-mc-date\", hdrDate);\n\n request.Headers.Add(\"x-mc-req-id\", requestId);\n\n request.Headers.Add(\"x-mc-app-id\", appId);\n\n\n\n //Add request body\n\n //Create and write data to stream\n\n string postData = @\"{\n\n \"\"data\"\": [\\\n\\\n {\\\n\\\n \"\"id\"\": \"\"String\"\"\\\n\\\n }\\\n\\\n ]\n\n }\";\n\n\n\n byte[] payload = System.Text.Encoding.UTF8.GetBytes(postData);\n\n\n\n System.IO.Stream stream = request.GetRequestStream();\n\n stream.Write(payload, 0, payload.Length);\n\n stream.Close();\n\n\n\n //Send Request\n\n System.Net.HttpWebResponse response = (System.Net.HttpWebResponse)request.GetResponse();\n\n\n\n //Output response to console\n\n System.IO.StreamReader reader = new System.IO.StreamReader(response.GetResponseStream());\n\n string responseBody = \"\";\n\n string temp = null;\n\n while ((temp = reader.ReadLine()) != null)\n\n {\n\n responseBody += temp;\n\n };\n\n System.Console.WriteLine(responseBody);\n\n System.Console.ReadLine();\n\n }\n```\n\n```\n\n#Setup required variables\n\n$baseUrl = \"https://xx-api.mimecast.com\"\n\n$uri = \"/api/gateway/hold-release\"\n\n$url = $baseUrl + $uri\n\n$accessKey = \"YOUR ACCESS KEY\"\n\n$secretKey = \"YOUR SECRET KEY\"\n\n$appId = \"YOUR APPLICATION ID\"\n\n$appKey = \"YOUR APPLICATION KEY\"\n\n\n\n#Generate request header values\n\n$hdrDate = (Get-Date).ToUniversalTime().ToString(\"ddd, dd MMM yyyy HH:mm:ss UTC\")\n\n$requestId = [guid]::NewGuid().guid\n\n\n\n#Create the HMAC SHA1 of the Base64 decoded secret key for the Authorization header\n\n$sha = New-Object System.Security.Cryptography.HMACSHA1\n\n$sha.key = [Convert]::FromBase64String($secretKey)\n\n$sig = $sha.ComputeHash([Text.Encoding]::UTF8.GetBytes($hdrDate + \":\" + $requestId + \":\" + $uri + \":\" + $appKey))\n\n$sig = [Convert]::ToBase64String($sig)\n\n\n\n#Create Headers\n\n$headers = @{\"Authorization\" = \"MC \" + $accessKey + \":\" + $sig;\n\n \"x-mc-date\" = $hdrDate;\n\n \"x-mc-app-id\" = $appId;\n\n \"x-mc-req-id\" = $requestId;\n\n \"Content-Type\" = \"application/json\"}\n\n\n\n#Create post body\n\n$postBody = \"{\n\n \"\"data\"\": [\\\n\\\n {\\\n\\\n \"\"id\"\": \"\"String\"\"\\\n\\\n }\\\n\\\n ]\n\n }\"\n\n\n\n#Send Request\n\n$response = Invoke-RestMethod -Method Post -Headers $headers -Body $postBody -Uri $url\n\n\n\n#Print the response\n\n$response\n```\n\n```\n\npublic static void main(String[] args) throws java.io.IOException, java.security.NoSuchAlgorithmException, java.security.InvalidKeyException {\n\n\n\n //set up variables for request\n\n String baseUrl = \"https://xx-api.mimecast.com\";\n\n String uri = \"/api/gateway/hold-release\";\n\n String url = \"https://\" + baseUrl + uri;\n\n String accessKey = \"YOUR ACCESS KEY\";\n\n String secretKey = \"YOUR SECRET KEY\";\n\n String appId = \"YOUR APPLICATION ID\";\n\n String appKey = \"YOUR APPLICATION KEY\";\n\n\n\n //create URL object\n\n java.net.URL obj = new java.net.URL(url);\n\n\n\n // set guid for x-mc-req-id header\n\n String guid = java.util.UUID.randomUUID().toString();\n\n\n\n // set date for x-mc-date header\n\n java.text.SimpleDateFormat sdf = new java.text.SimpleDateFormat(\"EEE, d MMM yyyy HH:mm:ss z\");\n\n sdf.setTimeZone(java.util.TimeZone.getTimeZone(\"UTC\"));\n\n String date = sdf.format(new java.util.Date());\n\n\n\n //create signature for the Authorization header\n\n String dataToSign = date + \":\" + guid + \":\" + uri + \":\" + appKey;\n\n String hmacSHA1 = \"HmacSHA1\";\n\n javax.crypto.spec.SecretKeySpec signingKey = new javax.crypto.spec.SecretKeySpec(org.apache.commons.codec.binary.Base64.decodeBase64(secretKey.getBytes()), hmacSHA1);\n\n javax.crypto.Mac mac = javax.crypto.Mac.getInstance(hmacSHA1);\n\n mac.init(signingKey);\n\n String sig = new String(org.apache.commons.codec.binary.Base64.encodeBase64(mac.doFinal(dataToSign.getBytes())));\n\n\n\n // create request object\n\n javax.net.ssl.HttpsURLConnection con = (javax.net.ssl.HttpsURLConnection) obj.openConnection();\n\n\n\n //set request type to POST\n\n con.setRequestMethod(\"POST\");\n\n con.setDoOutput(true);\n\n\n\n //add reuqest headers\n\n con.setRequestProperty(\"Authorization\", \"MC \" + accessKey + \":\" + sig);\n\n con.setRequestProperty(\"x-mc-req-id\", guid);\n\n con.setRequestProperty(\"x-mc-app-id\", appId);\n\n con.setRequestProperty(\"x-mc-date\", date);\n\n con.setRequestProperty(\"Content-Type\", \"application/json\");\n\n con.setRequestProperty(\"Accept\", \"application/json\");\n\n\n\n //Add post body to the request\n\n String postBody = \"{\\n\" +\n\n \" \\\"data\\\": [\\n\" +\\\n\\\n \" {\\n\" +\\\n\\\n \" \\\"id\\\": \\\"String\\\" +\\\n\\\n \" }\\n\" +\\\n\\\n \" ]\\n\" +\n\n \"}\";\n\n java.io.OutputStream os = con.getOutputStream();\n\n os.write(postBody.getBytes(\"UTF-8\"));\n\n os.close();\n\n\n\n //process response\n\n java.io.BufferedReader in = new java.io.BufferedReader(\n\n new java.io.InputStreamReader(con.getInputStream()));\n\n String inputLine;\n\n StringBuffer response = new StringBuffer();\n\n\n\n while ((inputLine = in.readLine()) != null) {\n\n response.append(inputLine);\n\n }\n\n in.close();\n\n\n\n //return result\n\n java.lang.System.out.println(response.toString());\n\n }\n```\n\n[Back to Top](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/release-message/#)","metadata":{"twitter:card":"summary_large_image","ogUrl":"https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/release-message/","ogDescription":"Mimecast API Release Message","author":"mimecast","VIcurrentDateTime":["639106058916228777>","639106058916228844"],"ogSiteName":"Mimecast","ogTitle":"Release Message","VirtualFolder":["\\","/"],"viewport":"width=device-width, initial-scale=1, shrink-to-fit=no","og:description":"Mimecast API Release Message","language":"en","title":"Release Message | Mimecast","theme-color":"#ffffff","og:title":"Release Message","og:site_name":"Mimecast","robots":"index, follow","og:url":"https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/release-message/","description":"Mimecast API Release Message","favicon":"https://integrations.mimecast.com/sc-static/img/favicons/icons_m_192x192.png","scrapeId":"019d46c9-4df1-70ca-9269-be886ca04ee5","sourceURL":"https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/release-message/","url":"https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/release-message/","statusCode":200,"contentType":"text/html; charset=utf-8","timezone":"America/New_York","proxyUsed":"basic","cacheState":"miss","indexId":"956772c5-e758-43fd-b66b-7be8939a6533","creditsUsed":1}},{"url":"https://mimecastsupport.zendesk.com/hc/en-us/articles/34000360548755-API-Integrations-Managing-API-2-0-for-Cloud-Gateway","title":"API & Integrations - Managing API 2.0 for Cloud Gateway – Mimecast","description":"This article contains information on managing API 2.0 applications during Mimecast's migration to the Integrations Hub, including creation, ...","position":5,"markdown":"Service Updates!\n\nTo stay informed, please visit the [Service Updates](https://mimecastsupport.zendesk.com/hc/en-us/sections/36032561852563-Service-Updates) page and click the _**Follow**_ button. Thank you!\n\nClose\n\n[Skip to main content](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000360548755-API-Integrations-Managing-API-2-0-for-Cloud-Gateway#main-content)\n\nBrowse help topics\n\n- Application Downloads\n\n\n\n - Application Downloads\n\n\n- Knowledge Hubs\n\n\n\n - Core Security Products\n\n\n\n - Email Security - API\n\n\n\n - Onboarding\n\n - Guides\n\n - Analysis & Response\n\n - Human Risk Command Center\n\n - Archive\n\n - Services\n\n - Users & Groups\n\n\n\n - Authentication\n\n - Applications\n\n - Attributes\n\n - Directory Synchronization\n\n - Directories\n\n\n - Policies\n\n - Integrations\n\n - Account\n\n\n - Email Security - MX\n\n\n\n - Guides & Resources\n\n - Administration\n\n - Analysis & Response\n\n - Brand Indicators Message Identification (BIMI)\n\n - Connect Application\n\n - Connect Process\n\n - Content Examination\n\n - Continuity\n\n\n\n - Guides & Resources\n\n\n - Directory Synchronization\n\n - DNS-based Authentication of Named Entities (DANE)\n\n - Email Security Setup Wizard\n\n - Exchange\n\n - Journaling\n\n - Mail Flow\n\n - Message Routing\n\n - Mimecast Administration Console\n\n\n\n - Advanced Account Administration / Federated Account Administration\n\n - Message Center\n\n\n\n - Accepted Messages\n\n - Bounced Messages\n\n - Held Messages\n\n - Message Tracking\n\n - Rejected & Deferred Messages\n\n\n - Account\n\n\n\n - Account Settings\n\n - Audit Logs\n\n - Roles\n\n\n - Directories\n\n - Services\n\n\n\n - Applications\n\n - Authentication\n\n - Authentication Profiles\n\n - Secure Messages\n\n - SMS Dashboard\n\n\n - Notification Sets\n\n - Policies\n\n - Reporting\n\n\n\n - Mimecast Account Assessment Report\n\n\n - Spam / Phishing\n\n - Security & Efficacy\n\n - Service Monitor\n\n - Targeted Threat Protection\n\n\n\n - Attachment Protect\n\n\n\n - Guides & Resources\n\n\n - Impersonation Protect\n\n\n\n - Guides & Resources\n\n\n - Internal Email Protect\n\n - URL Protect\n\n\n\n - Guides & Resources\n\n\n - Threat Intelligence & Remediation\n\n\n - Email Security Cloud Integrated\n\n\n\n - Guides & Resources\n\n - Getting Started\n\n - Awareness Training\n\n - Configuration\n\n - User Management\n\n - Home\n\n - Detections\n\n - Mail Flow\n\n - Reporting & Analytics\n\n - Audit Logs\n\n - Advanced BEC\n\n - Engage\n\n - Collaboration Security\n\n\n\n - Protection for Sharepoint & OneDrive\n\n - Protection for Microsoft Teams\n\n\n - DMARC Analyzer\n\n - Sync & Recover\n\n - Targeted Threat Protection Attachment Protect\n\n\n - Security Add-Ons\n\n\n\n - DMARC Analyzer 2.0\n\n - Large File Send\n\n\n\n - Guides & Resources\n\n\n - Advanced BEC\n\n - Browser Isolation\n\n - Collaboration Security\n\n\n\n - Guides & Resources\n\n\n - Brand Exploit Protect\n\n\n\n - Guides & Resources\n\n\n - CyberGraph\n\n\n\n - Guides & Resources\n\n - Misaddressed Email Protect\n\n\n - DMARC Analyzer\n\n\n\n - Guides & Resources\n\n\n - Secure Messaging\n\n\n\n - Guides & Resources\n\n\n - Web Security\n\n\n\n - Guides & Resources\n\n - Overview\n\n - Configuration\n\n - Reporting\n\n - General\n\n - Mimecast Security Agent for iOS\n\n - Mimecast Security Agent for Mac\n\n - Mimecast Security Agent for Windows\n\n - Mimecast Security Agent for Windows Server\n\n - Troubleshooting\n\n\n - Human Risk Management\n\n\n\n - Human Risk Command Center\n\n - Incydr\n\n\n\n - Incydr administration\n\n\n\n - Incydr console reference\n\n - Configuring\n\n\n\n - SCIM provisioning\n\n - Identity management\n\n\n - Monitoring and managing\n\n\n\n - Roles resources\n\n - Incydr API resources\n\n - Incydr User Directory Sync resources\n\n - Device migration with the backup agent\n\n - Backup agent reporting\n\n\n - Planning and installing\n\n\n\n - Manage agent installations in your Incydr environment\n\n - Security hardening\n\n - Implement Incydr\n\n\n - Troubleshooting\n\n - Licenses\n\n\n - IRM Launchpad\n\n - Release notes\n\n\n\n - Incydr release notes\n\n - Previous version release notes\n\n\n - Terms and conditions\n\n\n\n - Platform support policy\n\n\n\n - Operating system support policy\n\n\n - Product lifecycle policy\n\n - Incydr customer support resources\n\n\n\n - Incydr product plans\n\n\n - Legal terms and conditions\n\n\n\n - Previous agreements\n\n\n - Compliance resources\n\n - Open source licenses\n\n\n - Announcements\n\n\n\n - Incydr announcements\n\n - Backup add-on announcements\n\n\n - Using the backup agent\n\n\n\n - Get started\n\n - Backup\n\n - Restore files\n\n - Configuring\n\n - Backup agent reference\n\n - Troubleshooting\n\n\n - API & Integrations\n\n\n\n - Guides & Resources\n\n\n - Awareness Training\n\n\n\n - Guides & Resources\n\n - Access & Overview\n\n - Settings & Configuration\n\n\n\n - Settings\n\n - Configuration\n\n - Rapid Deployment\n\n\n - Training Queues\n\n - Phishing Training\n\n - My Training Library\n\n - Reporting\n\n - Troubleshooting\n\n\n - Engage\n\n\n\n - Guides & Resources\n\n - Access and Overview\n\n - Settings & Configuration\n\n\n\n - Rapid Deployment\n\n - Configuration\n\n - Settings\n\n\n - Human Risk\n\n - Training Queues\n\n - Phishing Training\n\n - My Training Library\n\n - Reporting\n\n - Nudges\n\n - Scorecards\n\n - Troubleshooting\n\n\n - Data Governance, Compliance & Insights\n\n\n\n - Aware 2.0\n\n\n\n - Video How-to Tutorials\n\n\n\n - User Data Removal\n\n - Signal\n\n - Search & Discover\n\n - Retention\n\n - Data Hold\n\n\n - Risk Management Suite\n\n\n\n - Search & Discover\n\n - Data Hold\n\n - Retention\n\n\n - Platform Documentation\n\n - Platform Administrator Capabilities\n\n - Community Management & Insights\n\n\n\n - Spotlight\n\n - Signal\n\n - Example Use Cases\n\n\n - Archiving\n\n - Archive for Microsoft Teams\n\n\n\n - Guides & Resources\n\n\n - Case Review\n\n\n\n - Guides & Resources\n\n\n - eDiscovery\n\n - Mimecast Synchronization Engine\n\n - Aware\n\n\n\n - Community Management & Insights\n\n\n\n - Example Use Cases\n\n - Spotlight\n\n - Signal\n\n - Surveys\n\n\n - Risk Management Suite\n\n\n\n - User Data Removal\n\n - Retention\n\n - Data Hold\n\n - Search & Discover\n\n\n - Platform Administrator Capabilities\n\n - Platform Documentation\n\n - Video How-To Tutorials\n\n\n\n - Spotlight\n\n - Signal\n\n - Search & Discover\n\n - Data Hold\n\n - Retention\n\n - User Data Removal\n\n\n - Sync & Recover\n\n\n\n - Guides & Resources\n\n\n - Supervision\n\n\n\n - Guides & Resources\n\n\n - Simply Migrate\n\n\n\n - Guides & Resources\n\n\n - End User & Web Applications\n\n\n\n - User Portal\n\n - End User Assets\n\n - Mimecast Essentials for Outlook\n\n - Mimecast for Mac\n\n\n\n - Installation\n\n - Preferences & Settings\n\n - Using Your Mailboxes\n\n - Archive Folders\n\n - Managed Senders\n\n - Large File Send\n\n - Searching\n\n - Help & Feedback\n\n\n - Mimecast for Outlook\n\n - Mimecast Mobile\n\n\n\n - Installation\n\n - Using Mimecast Mobile\n\n - Configuration\n\n\n - Mimecast Personal Portal\n\n - Stationery\n\n\n - Mimecast Customer Care\n\n\n\n - Customer Alerts Notes\n\n - Mimecast University\n\n\n\n - Guides & Resources\n\n\n - Mimecast Partner\n\n\n\n - Jersey\n\n\n- Known Issues\n\n\n\n - API & Integrations\n\n - Awareness Training\n\n - Case Review\n\n - CyberGraph\n\n - Data Retention\n\n\n\n - Simply Migrate\n\n\n - DMARC Analyzer\n\n - Email Security Cloud Gateway\n\n - Email Security Cloud Integrated\n\n - End User Applications\n\n\n\n - Mimecast Essentials for Outlook\n\n - Mimecast for Mac\n\n - Mimecast Mobile\n\n - Mimecast for Outlook\n\n - Mimecast Personal Portal\n\n\n - Human Risk\n\n - Reporting\n\n - Sync & Recover\n\n - Targeted Threat Protection\n\n\n- Service Updates\n\n\n\n - Service Updates\n\n\nThis article contains information on managing API 2.0 applications during Mimecast’s migration to the _**Integrations Hub**_, including creation, updates, deletion, and key regeneration.\n\n## Migration to the Integrations Hub\n\nMimecast is in the process of moving management of all API 2.0 applications from the _**API and Platform Integrations**_ page to the _**Integrations Hub**_. During this process, older apps may still be managed on the _**API and Platform Integrations**_ page, and all newly created apps should be managed from the _**Integrations Hub**_.\n\n## Prerequisites\n\nThe designated administrator must be assigned a Role with the following criteria.\n\n- _**Read**_ and _**Edit**_ API Application Permissions under the Service Menu.\n- _**Security Permissions**_ setting must permit the Management of Application Roles.\n\nCustom roles should be created for each API 2.0 Application with the _**least required privileges applied.**_\n\n## Creating an API 2.0 Application\n\nTo create an API 2.0 Application, follow the steps below:\n\n1. Log in to _**Mimecast Administration Console**_.\n2. Navigate to _**Integrations \\| Integrations Hub**_.\n3. If you haven't accepted before, you may see a popup asking you to accept our _**API Terms and Conditions**_. Review and accept these terms before creating any API applications.\n4. Locate the following _**Mimecast API 2.0**_ tile and click _**Configure New.**_\n\n![](https://mimecastsupport.zendesk.com/hc/article_attachments/48635264544275)\n\n5. Under _**Details**_, populate the following fields:\n\n![](https://mimecastsupport.zendesk.com/hc/article_attachments/48635233772691)\n\n- _**Application Name**_: A name to uniquely identify this application. Once saved, this value cannot be changed.\n- _**Products**_: The API products that will be used, which are categories of API endpoints. The products are a one-to-one mapping with the tiles on our API documentation. Once saved, the products cannot be modified.\n- _**Application Role**_: The administrative role to scope what this API application is allowed to do. Roles can be managed under _**Account**_ \\| _**Admin Roles**_.\n- _**Description**_: A free-form text field that can be used to described the application and its purpose. This can be modified after the app has been created.\n\n6. Under _**Notification Settings**_, populate the following fields:\n\n\n![](https://mimecastsupport.zendesk.com/hc/article_attachments/48635233773331)\n\n- _**Technical Point of Contact**_: The name of the person or team that should be notified if we need to reach out about the specific application.\n- _**Email**_: The email address of the person to be contacted, if needed. This can be a user or a group address.\n\n7. Click _**Save**_.\n8. A popup will appear with a masked _**Client ID**_ and _**Client Secret**_. Copy these to a secure location, as the secret will not be shown again.\n\n![](https://mimecastsupport.zendesk.com/hc/article_attachments/48635233773843)\n\n9. Once saved, click _**Close**_.\n\n## Updating an API 2.0 Application\n\n1. Log into the _**Mimecast Administration Console**_.\n2. Navigate to _**Integrations**_ \\| _**Integrations Hub**_.\n3. Locate the _**API 2.0**_ tile and click _**View**_.\n\n![](https://mimecastsupport.zendesk.com/hc/article_attachments/48635264548115)\n\n4. Find and click on the application that you wish to modify.\n\n![](https://mimecastsupport.zendesk.com/hc/article_attachments/48635264548627)\n\nThis action can also be accessed by clicking on the meatball icon.\n\n![](https://mimecastsupport.zendesk.com/hc/article_attachments/48635264549139)\n\n5. Change the fields as needed.\n\n![](https://mimecastsupport.zendesk.com/hc/article_attachments/48635233776147)\n\n6. Click _**Save**_.\n\n## Deleting an API 2.0 Application\n\nTo delete an API application, follow these steps:\n\n1. Log into the _**Mimecast Administration Console.**_\n2. Navigate to _**Integrations**_ \\| _**Integrations Hub.**_\n3. Locate the _**API 2.0**_ tile and click _**View**_.\n\n![](https://mimecastsupport.zendesk.com/hc/article_attachments/48635233776787)\n\n4. Find and click on the application you want to delete.\n\n![](https://mimecastsupport.zendesk.com/hc/article_attachments/48635233777299)\n\nThis action can also be accessed by clicking on the meatball icon.\n\n![](https://mimecastsupport.zendesk.com/hc/article_attachments/48635264552595)\n\n5. Click _**Delete**_.\n\n![](https://mimecastsupport.zendesk.com/hc/article_attachments/48635264553107)\n\n6. Confirm that you want to delete the application by clicking _**Delete**_.\n\n![](https://mimecastsupport.zendesk.com/hc/article_attachments/48635264553747)\n\nCredentials for this API Application will no longer be valid from this point forward.\n\n## Regenerating Keys\n\nTo generate a new, fresh Client ID and Secret Keys, follow these steps:\n\n1. Log into the _**Mimecast Administration Console.**_\n2. Navigate to _**Integrations**_ \\| _**Integrations Hub.**_\n3. Locate the _**API 2.0**_ tile and click _**View**_.\n\n![](https://mimecastsupport.zendesk.com/hc/article_attachments/48635233778835)\n\n4. Find and click on the application for which you want to generate new keys.\n\n![](https://mimecastsupport.zendesk.com/hc/article_attachments/48635264554899)\n\n5. Click _**Reset Keys**_.\n\n![](https://mimecastsupport.zendesk.com/hc/article_attachments/48635233779859)\n\n6. Click _**Regenerate**_ to confirm you want to obtain a new set of keys.\n\n![](https://mimecastsupport.zendesk.com/hc/article_attachments/48635264555795)\n\n7. A popup will appear with a masked _**Client ID**_ and _**Client Secret**_. Copy these to a secure location, as the secret will not be shown again.\n\n![](https://mimecastsupport.zendesk.com/hc/article_attachments/48635264556691)\n\n8. Once saved, click _**Close**_.\n\n## Legacy Keys Generated Under API and Platforms Integrations\n\nIf you've previously an API 2.0 application on the API and Platform Integrations section of the Administration Console, those will continue to be managed on that page at this time. In future, we will automatically move these to the Integrations Hub.\n\nNew applications will only be managed on the Integrations Hub.\n\n### Steps to manage an older application\n\n1. Log into the _**Mimecast Administration Console**_.\n2. Navigate to _**Integrations**_ \\| _**API and Platform Integrations**_.\n3. Click on the _**API 2.0 Applications**_ tab.\n4. Click on the application you wish to manage.\n5. Select an action flyout:\n\n- _**Edit**_: Modify information about the application, products, roles and notification contact information.\n- _**Manage API 2.0 Credentials**_: This will generate a new set of API keys for this app.\n- _**Delete**_: Remove this integration and its associated API keys if no longer needed.\n\nThis page uses an older management experience, where sections are selected on the left (Disclaimer, Details, Notifications).\n\n## See Also...\n\n- [Mimecast Developer](https://developer.services.mimecast.com/)\n- [API & Integrations - Managing API Applications](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000389337491)\n\n#### Related to\n\n- [Article](https://mimecastsupport.zendesk.com/hc/en-us/search?content_tags=01JCDB7FXFCB9A9493TVJ90GS6&utf8=%E2%9C%93 \"Search results\")\n- [API & Integrations](https://mimecastsupport.zendesk.com/hc/en-us/search?content_tags=01JCK4N0EPJF6KTPT3MABR16T9&utf8=%E2%9C%93 \"Search results\")\n- [Email Security - MX](https://mimecastsupport.zendesk.com/hc/en-us/search?content_tags=01KHKDGGTJ2C9RGD5GZ7PXX7M0&utf8=%E2%9C%93 \"Search results\")\n\nPlease [sign in](https://mimecastsupport.zendesk.com/access?locale=en-us&brand_id=28063027612179&return_to=https%3A%2F%2Fmimecastsupport.zendesk.com%2Fhc%2Fen-us%2Farticles%2F34000360548755-API-Integrations-Managing-API-2-0-for-Cloud-Gateway) to leave a comment.\n\n#### Table of contents\n\nMigration to the Integrations Hub\n\n- [Migration to the Integrations Hub](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000360548755-API-Integrations-Managing-API-2-0-for-Cloud-Gateway#h_01KFBA474MS5X46Z6H5XRNKPJR)\n- [Prerequisites](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000360548755-API-Integrations-Managing-API-2-0-for-Cloud-Gateway#h_01JK62GWQ91FX2VPS7EWE3M9RX)\n- [Creating an API 2.0 Application](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000360548755-API-Integrations-Managing-API-2-0-for-Cloud-Gateway#h_01JK62GWQ9AE524DJTXZM30MCC)\n- [Updating an API 2.0 Application](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000360548755-API-Integrations-Managing-API-2-0-for-Cloud-Gateway#h_01KFB81FD9RT5KE806VVBRP38C)\n- [Deleting an API 2.0 Application](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000360548755-API-Integrations-Managing-API-2-0-for-Cloud-Gateway#h_01JK62N126BMPMR6VN571TRCFB)\n- [Regenerating Keys](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000360548755-API-Integrations-Managing-API-2-0-for-Cloud-Gateway#h_01JK62N126DCHAZMSTQKKTC586)\n- [Legacy Keys Generated Under API and Platforms Integrations](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000360548755-API-Integrations-Managing-API-2-0-for-Cloud-Gateway#h_01KFB9ED2D21SH2EFQ0VYF59EA)\n- [Steps to manage an older application](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000360548755-API-Integrations-Managing-API-2-0-for-Cloud-Gateway#h_01KFB9PBYSNVX9HXFCMH8D213N)\n- [See Also...](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000360548755-API-Integrations-Managing-API-2-0-for-Cloud-Gateway#h_01KFBA1T43EM1SW3B1B6EA3K2T)\n- [Related to](https://mimecastsupport.zendesk.com/hc/en-us/articles/34000360548755-API-Integrations-Managing-API-2-0-for-Cloud-Gateway#related-to-9)\n\nReturn to top\n\n\ninstallation, branding, customization","metadata":{"og:url":"https://mimecastsupport.zendesk.com/hc/en-us/articles/34000360548755-API-Integrations-Managing-API-2-0-for-Cloud-Gateway","og:type":"website","og:description":"This article contains information on managing API 2.0 applications during Mimecast’s migration to the Integrations Hub, including creation, updates, deletion, and key regeneration.Migration to the ...","viewport":"width=device-width, initial-scale=1.0","og:title":"API & Integrations - Managing API 2.0 for Cloud Gateway","title":"API & Integrations - Managing API 2.0 for Cloud Gateway – Mimecast","language":"en-US","ogImage":"https://mimecastsupport.zendesk.com/hc/theming_assets/01JDW0MS8H4Q6FHWQV5JKA1XPB","ogSiteName":"Mimecast","description":"This article contains information on managing API 2.0 applications during Mimecast’s migration to the Integrations Hub, including...","ogTitle":"API & Integrations - Managing API 2.0 for Cloud Gateway","og:image":"https://mimecastsupport.zendesk.com/hc/theming_assets/01JDW0MS8H4Q6FHWQV5JKA1XPB","og:site_name":"Mimecast","ogUrl":"https://mimecastsupport.zendesk.com/hc/en-us/articles/34000360548755-API-Integrations-Managing-API-2-0-for-Cloud-Gateway","ogDescription":"This article contains information on managing API 2.0 applications during Mimecast’s migration to the Integrations Hub, including creation, updates, deletion, and key regeneration.Migration to the ...","favicon":"https://mimecastsupport.zendesk.com/hc/theming_assets/01JZ0NAR4QXDPSW25VSVN5Y2WC","scrapeId":"019d46c9-4df1-70ca-9269-c010647a9764","sourceURL":"https://mimecastsupport.zendesk.com/hc/en-us/articles/34000360548755-API-Integrations-Managing-API-2-0-for-Cloud-Gateway","url":"https://mimecastsupport.zendesk.com/hc/en-us/articles/34000360548755-API-Integrations-Managing-API-2-0-for-Cloud-Gateway","statusCode":200,"contentType":"text/html; charset=utf-8","timezone":"America/New_York","proxyUsed":"basic","cacheState":"miss","indexId":"2bc1e5ed-2a8b-4f9d-a712-6581c05d22be","creditsUsed":1}},{"url":"https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/","title":"Message Queues - API and Integrations | Mimecast","description":"Message Queue Endpoints: Find Processing Messages · Get Hold Message List · Get Message Detail · Get File · Get Message Hold Summary List · Reject Message ...","position":6,"markdown":"**Message Queue Endpoints:**\n\n- [Find Processing Messages](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/find-processing-messages/)\n- [Get Hold Message List](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-message-list/)\n- [Get Message Detail](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-message-detail/)\n- [Get File](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-file/)\n- [Get Message Hold Summary List](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/get-hold-summary-list/)\n- [Reject Message](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/reject-message/)\n- [Release Message](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/release-message/)\n- [Inbound & Outbound Queues](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/inbound-outbound-queues/)\n\n[Back to Top](https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/#)","metadata":{"language":"en","VirtualFolder":["\\","/"],"ogTitle":"Message Queues","description":"Mimecast API Message Queues","theme-color":"#ffffff","ogDescription":"Mimecast API Message Queues","og:site_name":"Mimecast","robots":"index, follow","author":"mimecast","twitter:card":"summary_large_image","title":"Message Queues | Mimecast","VIcurrentDateTime":["639106058916369986>","639106058916370038"],"ogUrl":"https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/","ogSiteName":"Mimecast","og:description":"Mimecast API Message Queues","og:url":"https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/","viewport":"width=device-width, initial-scale=1, shrink-to-fit=no","og:title":"Message Queues","favicon":"https://integrations.mimecast.com/sc-static/img/favicons/icons_m_192x192.png","scrapeId":"019d46c9-4df1-70ca-9269-c5b66b0a7d71","sourceURL":"https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/","url":"https://integrations.mimecast.com/documentation/endpoint-reference/message-queues/","statusCode":200,"contentType":"text/html; charset=utf-8","timezone":"America/New_York","proxyUsed":"basic","cacheState":"miss","indexId":"963bdd6d-9086-4cee-89da-462410b57297","creditsUsed":1}},{"url":"https://integrations.mimecast.com/documentation/api-2,-d-,0-reference/","title":"API 2-0 Reference | Mimecast","description":"Get Message Info · Message Queues Expand or Collapse Message Queues Children. Find Processing Messages · Get Hold Message List · Get Message Detail · Get File.","position":7,"markdown":"[Back to Top](https://integrations.mimecast.com/documentation/api-2,-d-,0-reference/#)","metadata":{"language":"en","viewport":"width=device-width, initial-scale=1, shrink-to-fit=no","VirtualFolder":["\\","/"],"author":"mimecast","ogUrl":"https://integrations.mimecast.com/documentation/api-2,-d-,0-reference/","VIcurrentDateTime":["639106058915664328>","639106058915664386"],"ogSiteName":"Mimecast","title":"API 2-0 Reference | Mimecast","robots":"index, follow","theme-color":"#ffffff","og:site_name":"Mimecast","og:url":"https://integrations.mimecast.com/documentation/api-2,-d-,0-reference/","twitter:card":"summary_large_image","favicon":"https://integrations.mimecast.com/sc-static/img/favicons/icons_m_192x192.png","scrapeId":"019d46c9-4df1-70ca-9269-ca16554aae73","sourceURL":"https://integrations.mimecast.com/documentation/api-2,-d-,0-reference/","url":"https://integrations.mimecast.com/documentation/api-2,-d-,0-reference/","statusCode":200,"contentType":"text/html; charset=utf-8","timezone":"America/New_York","proxyUsed":"basic","cacheState":"miss","indexId":"d258b49b-c98e-4edb-88b7-e65254dac257","creditsUsed":1}},{"url":"https://www.postman.com/api-evangelist/d6740a2c-d4d3-410b-b25a-9b8eb475f08e/request/s17i08u/get-message-hold-summary-list","title":"Get Message Hold Summary List | Mimecast | Postman API Network","description":"Start sending API requests with the Get Message Hold Summary List public request from Mimecast on the Postman API Network.","position":8,"markdown":"POST\n\nGet Message Hold Summary List\n\nEnvironment\n\nNo environment\n\nSave\n\nShare\n\n{{baseUrl}}/api/gateway/get-hold-summary-list\n\nSend\n\n- Overview\n- Params\n- Authorization\n- Headers 1\n- Body\n- Scripts\n- Settings\n\nCookies\n\n# Get Message Hold Summary List\n\n[View complete documentation](https://www.postman.com/api-evangelist/documentation/35240-1181ba4e-61bb-4025-ad8f-4fda717595b3?entity=request-35240-b28aaeeb-f172-4ebe-9ec7-d95f6954468b)\n\nhttps://us-api.mimecast.com/api/gateway/get-hold-summary-list\n\n## Body\n\nraw (text)\n\ntext\n\n```text\n\"\"\n```\n\n## Code Snippet\n\ncURL\n\n## Example\n\ndefault\n\nRequest\n\ncURL\n\n```curl\ncurl --location 'https://us-api.mimecast.com/api/gateway/get-hold-summary-list' \\\n--data '\"\"'\n```\n\n500 Internal Server Error\n\nResponse\n\n- Body\n- Headers (1)\n\nNo response body\n\nThis request doesn't return any response body.\n\nContent-Type\n\ntext/plain\n\n##### Response\n\nSend + Get a successful responseSend + Visualize responseSend + Write tests\n\nAI\n\n#### Sign in to use Postman Agent.\n\nSign in\n\nOnline\n\nBrowser Agent\n\n- Overview\n- Params\n- Authorization\n- Headers 1\n- Body\n- Scripts\n- Settings\n\n- Body\n- Headers (1)\n\n- Mimecast/\n- api/\n- gateway/\n- Get Message Hold Summary List","metadata":{"title":"Get Message Hold Summary List | Mimecast | Postman API Network","og:image":"https://www.postman.com/_ar-assets/js/images/postman-api-platform-social-preview-14a81059eaf1b6db.jpg","prerender-status-code":"301","twitter:description":"Start sending API requests with the Get Message Hold Summary List public request from Mimecast on the Postman API Network.","og:url":"https://www.postman.com/api-evangelist/mimecast/request/s17i08u/get-message-hold-summary-list","ogTitle":"Get Message Hold Summary List | Mimecast","og:title":"Get Message Hold Summary List | Mimecast","language":"en-US","viewport":"width=device-width,height=device-height,initial-scale=1,shrink-to-fit=no","og:description":"Start sending API requests with the Get Message Hold Summary List public request from Mimecast on the Postman API Network.","twitter:image":"https://www.postman.com/_ar-assets/js/images/postman-api-platform-social-preview-14a81059eaf1b6db.jpg","twitter:card":"summary_large_image","ogDescription":"Start sending API requests with the Get Message Hold Summary List public request from Mimecast on the Postman API Network.","og:site_name":"Postman","ogSiteName":"Postman","twitter:title":"Get Message Hold Summary List | Mimecast","twitter:creator":"@getpostman","description":"Start sending API requests with the Get Message Hold Summary List public request from Mimecast on the Postman API Network.","ogImage":"https://www.postman.com/_ar-assets/js/images/postman-api-platform-social-preview-14a81059eaf1b6db.jpg","ogUrl":"https://www.postman.com/api-evangelist/mimecast/request/s17i08u/get-message-hold-summary-list","prerender-header":"Location: https://www.postman.com/api-evangelist/mimecast/request/s17i08u/get-message-hold-summary-list","twitter:site":"@getpostman","og:type":"profile","favicon":"https://www.postman.com/_ar-assets/images/favicon-1-16.png","scrapeId":"019d46c9-4df1-70ca-9269-cf85dc93db9e","sourceURL":"https://www.postman.com/api-evangelist/d6740a2c-d4d3-410b-b25a-9b8eb475f08e/request/s17i08u/get-message-hold-summary-list","url":"https://www.postman.com/api-evangelist/mimecast/request/s17i08u/get-message-hold-summary-list?sideView=agentMode","statusCode":200,"contentType":"text/html","timezone":"America/New_York","proxyUsed":"basic","cacheState":"miss","indexId":"4c2a56e6-6bab-4472-9922-88964eb06047","creditsUsed":1}},{"url":"https://prodriveit.co.uk/blog/how-to-access-mimecast-on-hold-messages","title":"How to access Mimecast 'On Hold' messages - Pro Drive IT Ltd Blog","description":"On this vlog, we look at how to access and work with Mimecast 'on hold' messages via the Mimecast website portal or Outlook app.","position":9,"markdown":"[Skip to content](https://www.prodriveit.co.uk/blog/how-to-access-mimecast-on-hold-messages#content)\n\n[Benchmark Survey](https://prodriveitmaturitysurvey.scoreapp.com/)\n\n[Get Help](https://prodriveit.co.uk/help)\n\n[![2x Sticky | Pro Drive IT](https://prodriveit.co.uk/wp-content/uploads/2017/03/prodrive-logo-sticky-2x.png)](https://prodriveit.co.uk/)\n\n[Previous](https://www.prodriveit.co.uk/blog/important-microsoft-365-licensing-changes) [Next](https://www.prodriveit.co.uk/blog/4-lawtech-fixes-to-ace-your-caseload)\n\n# How to access Mimecast ‘On Hold’ messages\n\nIn our series of ‘how to’ videos we include tips on using Mimecast cloud cybersecurity. This time, we look at how to access and work with Mimecast ‘on hold’ messages via the Mimecast website portal or Outlook app.\n\n[Mimecast](https://www.mimecast.com/) provides a whole range of tools for email, data and web to help prevent cyber threats affecting your business. Here we focus on email messages.\n\n## Watch the video or read on to learn how to get the best out of your Mimecast ‘on hold’ messages system.\n\nHow to access Mimecast 'On Hold' messages on Outlook/Mimecast - YouTube\n\nTap to unmute\n\n[How to access Mimecast 'On Hold' messages on Outlook/Mimecast](https://www.youtube.com/watch?v=47e2pyR6q-Y) [Pro Drive IT](https://www.youtube.com/channel/UC3E8epkg2QhPv7IaMsoVkPA)\n\n![thumbnail-image](https://yt3.ggpht.com/n5ELxGVcwWl-HQ2nIhYuGS2iA1kjBzi3lkms7TgBrAXe3y8TBGHhjnlNHmSOADa9vVOqSrgHGw=s68-c-k-c0x00ffffff-no-rj)\n\nPro Drive IT150 subscribers\n\n[Watch on](https://www.youtube.com/watch?v=47e2pyR6q-Y)\n\n**Mimecast on Outlook**\n\n1\\. On your Outlook you’ll have the Home tab options and you will see the Mimecast add-in.\n\n2\\. Click on that and you’ll see the ‘on hold messages’ button.\n\n3\\. Here, you will be able to see any ‘on hold’ messages that are in your personal queue, or in your moderated queue. A personal queue is any email sent to your inbox and the moderated queue is for any mailboxes that you look after such as ‘info at’ or ‘sales at’, where you might be an overseer. Note that this would need to be set up beforehand, so just for this video we will be looking at the personal ‘on hold’ messages.\n\n4\\. Select ‘personal’ and ‘hold’ and you will get a pop-up screen that will show you any messages that are on hold. You can click on them and have a quick read – for your security Mimecast doesn’t show any images but you can opt to click to display them as well. It also tells you why the messages is being held – for example, it could be the Spam Signature Policy.\n\n5\\. Using that example, if you see that it isn’t a spam message, along the top bar there is a ‘release’ button. You can click ‘release’ and permit the address. That will add the single address into your permit list. This means that this account will never be blocked for spam again.\n\n6\\. There is also the ‘release message and permit domain’ option. That will add the domain to your ‘allow’ list. Now this can be a very useful tool if you receive emails from, say, a customer or client and they often get blocked for spam. However, we don’t recommend adding anything such as Yahoo, Gmail or Outlook.com to this ‘allow’ list as then, all these emails will miss this important cybersecurity check.\n\n7\\. Instead of releasing the email you can also ‘reject’ the email. This deletes it.\n\n8\\. Or you can ‘reject message and block the address’, which is just for the one specific address that sent you the email (which is the most preferred option).\n\n9\\. Or you can ‘reject message and block the domain’ as well. You are less likely to need this – remember, if you were to block someone such as@gmail.com or outlook or Yahoo then no one from that whole domain will be able to send you any emails at all!\n\n10\\. You can also mark messages as spam and these can be sent off to Mimecast for analysis, so they can help prevent these in the future.\n\n**Mimecast personal portal**\n\n1\\. [Log into Mimecast](https://login.mimecast.com/u/login/?gta=apps#/login) and enter your email address and password, as well as the multifactor authentication code if required.\n\n2\\. On the next screen, you’ll see the Mimecast personal portal option.\n\n3\\. Log into this option and you will see your inbox, where you have access to emails. On the left-hand side there are three dots, for the advanced option. Click into that to view your personal ‘on hold’ messages.\n\nAs with the Outlook instructions above, you can read emails, report as spam/phishing, or release the message, permit sender or domain – or reject the message sender or domain. You can also access the moderated ‘on hold’ as well if you do have access to any shared mailboxes.\n\nSo that’s it for working with your Mimecast ‘on hold’ messages.\n\n**We can help you with all kinds of [cybersecurity](https://prodriveit.co.uk/cyber-security) issues, including [Cyber Essentials,](https://prodriveit.co.uk/cyber-security/cyber-essentials) as well as other [business IT support](https://prodriveit.co.uk/business-it-support). If you have any questions, please feel free to contact us below.**\n\n[hypedmarketing](https://www.prodriveit.co.uk/blog/author/hypedmarketing \"Posts by hypedmarketing\")2021-11-24T10:55:33+00:00September 22nd, 2021\\| [Cyber Security](https://www.prodriveit.co.uk/blog/category/cyber-security), [Remote Working](https://www.prodriveit.co.uk/blog/category/remote-working), [Security and Threats](https://www.prodriveit.co.uk/blog/category/security-and-threats), [Tips and Advice](https://www.prodriveit.co.uk/blog/category/tips-and-advice) \\|Comments Off on How to access Mimecast ‘On Hold’ messages\n\n#### Share This Story, Choose Your Platform!\n\n[Facebook](https://www.facebook.com/sharer.php?u=https%3A%2F%2Fwww.prodriveit.co.uk%2Fblog%2Fhow-to-access-mimecast-on-hold-messages&t=How%20to%20access%20Mimecast%20%E2%80%98On%20Hold%E2%80%99%20messages \"\") [X](https://x.com/intent/post?url=https%3A%2F%2Fwww.prodriveit.co.uk%2Fblog%2Fhow-to-access-mimecast-on-hold-messages&text=How%20to%20access%20Mimecast%20%E2%80%98On%20Hold%E2%80%99%20messages \"\") [Reddit](https://reddit.com/submit?url=https://www.prodriveit.co.uk/blog/how-to-access-mimecast-on-hold-messages&title=How%20to%20access%20Mimecast%20%E2%80%98On%20Hold%E2%80%99%20messages \"\") [LinkedIn](https://www.linkedin.com/shareArticle?mini=true&url=https%3A%2F%2Fwww.prodriveit.co.uk%2Fblog%2Fhow-to-access-mimecast-on-hold-messages&title=How%20to%20access%20Mimecast%20%E2%80%98On%20Hold%E2%80%99%20messages&summary=In%20our%20series%20of%20%E2%80%98how%20to%E2%80%99%20videos%20we%20include%20tips%20on%20using%20Mimecast%20cloud%20cybersecurity.%20This%20time%2C%20we%20look%20at%20how%20to%20access%20and%20work%20with%20Mimecast%20%27on%20hold%27%20messages%20via%20the%20Mimecast%20website%20portal%20or%20Outlook%20app.%0D%0A%0D%0AMimecast%20provides%20a%20whole%20range%20of%20tool \"\") [Tumblr](https://www.tumblr.com/share/link?url=https%3A%2F%2Fwww.prodriveit.co.uk%2Fblog%2Fhow-to-access-mimecast-on-hold-messages&name=How%20to%20access%20Mimecast%20%E2%80%98On%20Hold%E2%80%99%20messages&description=In%20our%20series%20of%20%E2%80%98how%20to%E2%80%99%20videos%20we%20include%20tips%20on%20using%20Mimecast%20cloud%20cybersecurity.%20This%20time%2C%20we%20look%20at%20how%20to%20access%20and%20work%20with%20Mimecast%20%26%2339%3Bon%20hold%26%2339%3B%20messages%20via%20the%20Mimecast%20website%20portal%20or%20Outlook%20app.%0D%0A%0D%0AMimecast%20provides%20a%20whole%20range%20of%20tools%20for%20email%2C%20data%20and%20web%20to%20help%20prevent%20cyber%20threats \"\") [Pinterest](https://pinterest.com/pin/create/button/?url=https%3A%2F%2Fwww.prodriveit.co.uk%2Fblog%2Fhow-to-access-mimecast-on-hold-messages&description=In%20our%20series%20of%20%E2%80%98how%20to%E2%80%99%20videos%20we%20include%20tips%20on%20using%20Mimecast%20cloud%20cybersecurity.%20This%20time%2C%20we%20look%20at%20how%20to%20access%20and%20work%20with%20Mimecast%20%26%2339%3Bon%20hold%26%2339%3B%20messages%20via%20the%20Mimecast%20website%20portal%20or%20Outlook%20app.%0D%0A%0D%0AMimecast%20provides%20a%20whole%20range%20of%20tools%20for%20email%2C%20data%20and%20web%20to%20help%20prevent%20cyber%20threats&media=https%3A%2F%2Fwww.prodriveit.co.uk%2Fwp-content%2Fuploads%2F2021%2F09%2FSlide2.jpeg \"\") [Email](mailto:?body=https://www.prodriveit.co.uk/blog/how-to-access-mimecast-on-hold-messages&subject=How%20to%20access%20Mimecast%20%E2%80%98On%20Hold%E2%80%99%20messages \"\")\n\n## Related Posts\n\n![How to use Microsoft 365 to automate your data classification policies](https://www.prodriveit.co.uk/wp-content/uploads/2026/03/purview-portal-500x383.png)\n\n[How to use Microsoft 365 to automate your data classification policies](https://www.prodriveit.co.uk/blog/how-to-use-microsoft-365-to-automate-your-data-classification-policies) [How to use Microsoft 365 to automate your data classification policies](https://www.prodriveit.co.uk/blog/how-to-use-microsoft-365-to-automate-your-data-classification-policies)\n\n![How to create a data classification framework](https://www.prodriveit.co.uk/wp-content/uploads/2026/03/Creatre-data-classification-framework-500x383.png)\n\n[How to create a data classification framework](https://www.prodriveit.co.uk/blog/how-to-create-a-data-classification-framework) [How to create a data classification framework](https://www.prodriveit.co.uk/blog/how-to-create-a-data-classification-framework)\n\n![Why classifying data matters more than ever in the age of AI](https://www.prodriveit.co.uk/wp-content/uploads/2026/03/AI-data-classification-500x383.jpg)\n\n[Why classifying data matters more than ever in the age of AI](https://www.prodriveit.co.uk/blog/why-classifying-data-matters-more-than-ever-in-the-age-of-ai) [Why classifying data matters more than ever in the age of AI](https://www.prodriveit.co.uk/blog/why-classifying-data-matters-more-than-ever-in-the-age-of-ai)\n\n![Why data classification matters for professional services firms](https://www.prodriveit.co.uk/wp-content/uploads/2026/03/Data-classification-500x383.jpg)\n\n[Why data classification matters for professional services firms](https://www.prodriveit.co.uk/blog/why-data-classification-matters-for-professional-services-firms) [Why data classification matters for professional services firms](https://www.prodriveit.co.uk/blog/why-data-classification-matters-for-professional-services-firms)\n\n![How Microsoft Copilot Turns Outlook into Your Executive Assistant](https://www.prodriveit.co.uk/wp-content/uploads/2026/02/2025-11-05_10-03-16-500x383.png)\n\n[How Microsoft Copilot Turns Outlook into Your Executive Assistant](https://www.prodriveit.co.uk/blog/how-microsoft-copilot-turns-outlook-into-your-executive-assistant) [How Microsoft Copilot Turns Outlook into Your Executive Assistant](https://www.prodriveit.co.uk/blog/how-microsoft-copilot-turns-outlook-into-your-executive-assistant)\n\n![How to use Microsoft 365 to automate your data classification policies](https://www.prodriveit.co.uk/wp-content/uploads/2026/03/purview-portal-500x383.png)\n\n[How to use Microsoft 365 to automate your data classification policies](https://www.prodriveit.co.uk/blog/how-to-use-microsoft-365-to-automate-your-data-classification-policies) [How to use Microsoft 365 to automate your data classification policies](https://www.prodriveit.co.uk/blog/how-to-use-microsoft-365-to-automate-your-data-classification-policies)\n\n![How to create a data classification framework](https://www.prodriveit.co.uk/wp-content/uploads/2026/03/Creatre-data-classification-framework-500x383.png)\n\n[How to create a data classification framework](https://www.prodriveit.co.uk/blog/how-to-create-a-data-classification-framework) [How to create a data classification framework](https://www.prodriveit.co.uk/blog/how-to-create-a-data-classification-framework)\n\n![Why classifying data matters more than ever in the age of AI](https://www.prodriveit.co.uk/wp-content/uploads/2026/03/AI-data-classification-500x383.jpg)\n\n[Why classifying data matters more than ever in the age of AI](https://www.prodriveit.co.uk/blog/why-classifying-data-matters-more-than-ever-in-the-age-of-ai) [Why classifying data matters more than ever in the age of AI](https://www.prodriveit.co.uk/blog/why-classifying-data-matters-more-than-ever-in-the-age-of-ai)\n\n![Why data classification matters for professional services firms](https://www.prodriveit.co.uk/wp-content/uploads/2026/03/Data-classification-500x383.jpg)\n\n[Why data classification matters for professional services firms](https://www.prodriveit.co.uk/blog/why-data-classification-matters-for-professional-services-firms) [Why data classification matters for professional services firms](https://www.prodriveit.co.uk/blog/why-data-classification-matters-for-professional-services-firms)\n\n![How Microsoft Copilot Turns Outlook into Your Executive Assistant](https://www.prodriveit.co.uk/wp-content/uploads/2026/02/2025-11-05_10-03-16-500x383.png)\n\n[How Microsoft Copilot Turns Outlook into Your Executive Assistant](https://www.prodriveit.co.uk/blog/how-microsoft-copilot-turns-outlook-into-your-executive-assistant) [How Microsoft Copilot Turns Outlook into Your Executive Assistant](https://www.prodriveit.co.uk/blog/how-microsoft-copilot-turns-outlook-into-your-executive-assistant)\n\n![How to use Microsoft 365 to automate your data classification policies](https://www.prodriveit.co.uk/wp-content/uploads/2026/03/purview-portal-500x383.png)\n\n[How to use Microsoft 365 to automate your data classification policies](https://www.prodriveit.co.uk/blog/how-to-use-microsoft-365-to-automate-your-data-classification-policies) [How to use Microsoft 365 to automate your data classification policies](https://www.prodriveit.co.uk/blog/how-to-use-microsoft-365-to-automate-your-data-classification-policies)\n\n![How to create a data classification framework](https://www.prodriveit.co.uk/wp-content/uploads/2026/03/Creatre-data-classification-framework-500x383.png)\n\n[How to create a data classification framework](https://www.prodriveit.co.uk/blog/how-to-create-a-data-classification-framework) [How to create a data classification framework](https://www.prodriveit.co.uk/blog/how-to-create-a-data-classification-framework)\n\n![Why classifying data matters more than ever in the age of AI](https://www.prodriveit.co.uk/wp-content/uploads/2026/03/AI-data-classification-500x383.jpg)\n\n[Why classifying data matters more than ever in the age of AI](https://www.prodriveit.co.uk/blog/why-classifying-data-matters-more-than-ever-in-the-age-of-ai) [Why classifying data matters more than ever in the age of AI](https://www.prodriveit.co.uk/blog/why-classifying-data-matters-more-than-ever-in-the-age-of-ai)\n\n![Why data classification matters for professional services firms](https://www.prodriveit.co.uk/wp-content/uploads/2026/03/Data-classification-500x383.jpg)\n\n[Why data classification matters for professional services firms](https://www.prodriveit.co.uk/blog/why-data-classification-matters-for-professional-services-firms) [Why data classification matters for professional services firms](https://www.prodriveit.co.uk/blog/why-data-classification-matters-for-professional-services-firms)\n\n![How Microsoft Copilot Turns Outlook into Your Executive Assistant](https://www.prodriveit.co.uk/wp-content/uploads/2026/02/2025-11-05_10-03-16-500x383.png)\n\n[How Microsoft Copilot Turns Outlook into Your Executive Assistant](https://www.prodriveit.co.uk/blog/how-microsoft-copilot-turns-outlook-into-your-executive-assistant) [How Microsoft Copilot Turns Outlook into Your Executive Assistant](https://www.prodriveit.co.uk/blog/how-microsoft-copilot-turns-outlook-into-your-executive-assistant)\n\nPro Drive IT\n\nExport House\n\n5 Henry Plaza\n\nVictoria Way\n\nWoking\n\nGU21 6QX\n\nPhone: [0330 124 3599](tel:03301243599)\n\nEmail: [hello@prodriveit.co.uk](mailto:hello@prodriveit.co.uk)\n\n### Stay up to date on our latest news, projects and events\n\n[Sign up](https://www.prodriveit.co.uk/opt-in)\n\n[![Cyber Essentials](data:image/svg+xml,%3Csvg%20xmlns%3D%27http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%27%20width%3D%27126%27%20height%3D%27150%27%20viewBox%3D%270%200%20126%20150%27%3E%3Crect%20width%3D%27126%27%20height%3D%27150%27%20fill-opacity%3D%220%22%2F%3E%3C%2Fsvg%3E)](https://prodriveit.co.uk/cyber-security/cyber-essentials)\n\n![IASME](https://www.prodriveit.co.uk/wp-content/uploads/2023/01/IASMElogo-GOLDcertified-2017-FINAL.png)\n\n© 2026 Pro Drive IT \\| Powered by [Hyped Marketing](http://hypedmarketing.co.uk/) \\| [Privacy policy](https://www.prodriveit.co.uk/privacy-policy).\n\n[Page load link](https://www.prodriveit.co.uk/blog/how-to-access-mimecast-on-hold-messages#)\n\n[Go to Top](https://www.prodriveit.co.uk/blog/how-to-access-mimecast-on-hold-messages#)\n\nChat Widget","metadata":{"language":"en-GB","og:locale":["en_GB","en_GB"],"og:type":["article","article"],"twitter:data2":"3 minutes","ogDescription":"On this vlog, we look at how to access and work with Mimecast 'on hold' messages via the Mimecast website portal or Outlook app.","tec-api-origin":"https://www.prodriveit.co.uk","article:published_time":["2021-09-22T09:19:52+00:00","2021-09-22T09:19:52+01:00"],"title":"How to access Mimecast 'On Hold' messages - Pro Drive IT Ltd Blog","twitter:label2":"Estimated reading time","ogLocale":"en_GB","og:image":["https://www.prodriveit.co.uk/wp-content/uploads/2021/09/Slide2.jpeg","https://www.prodriveit.co.uk/wp-content/uploads/2021/09/Slide2.jpeg"],"msapplication-TileImage":"https://prodriveit.co.uk/wp-content/uploads/2017/03/prodrive-fav-72.png","ti-site-data":"eyJyIjoiMTowITc6MCEzMDowIiwibyI6Imh0dHBzOlwvXC93d3cucHJvZHJpdmVpdC5jby51az90aS1vbmxpbmUtdXNlcnMtZ29vZ2xlPTEmYW1wO3A9JTJGYmxvZyUyRmhvdy10by1hY2Nlc3MtbWltZWNhc3Qtb24taG9sZC1tZXNzYWdlcyZhbXA7X3dwbm9uY2U9NThmODg5YmEzZSJ9","robots":"index, follow, max-image-preview:large, max-snippet:-1, max-video-preview:-1","modifiedTime":"2021-11-24T10:55:33+00:00","description":"On this vlog, we look at how to access and work with Mimecast 'on hold' messages via the Mimecast website portal or Outlook app., In our series of ‘how to’ videos we include tips on using Mimecast cloud cybersecurity. This time, we look at how to access and work with Mimecast 'on hold' messages via the Mimecast website portal or Outlook app.\n\nMimecast provides a whole range of tools for email, data and web to help prevent cyber threats","og:url":["https://www.prodriveit.co.uk/blog/how-to-access-mimecast-on-hold-messages","https://www.prodriveit.co.uk/blog/how-to-access-mimecast-on-hold-messages"],"generator":["AMP for WP 1.1.12","WordPress 6.9.4","Powered by Slider Revolution 6.7.38 - responsive, Mobile-Friendly Slider Plugin for WordPress with comfortable drag and drop interface."],"twitter:creator":"@ProDriveIT","ogSiteName":"Pro Drive IT Ltd","twitter:card":"summary_large_image","msapplication-TileColor":"#2b5797","twitter:data1":"hypedmarketing","viewport":["width=device-width, initial-scale=1","width=device-width, initial-scale=1","width=device-width, initial-scale=1"],"ogTitle":"How to access Mimecast 'On Hold' messages - Pro Drive IT Ltd Blog","ogImage":"https://www.prodriveit.co.uk/wp-content/uploads/2021/09/Slide2.jpeg","ogUrl":"https://www.prodriveit.co.uk/blog/how-to-access-mimecast-on-hold-messages","og:title":["How to access Mimecast 'On Hold' messages - Pro Drive IT Ltd Blog","How to access Mimecast 'On Hold' messages - Pro Drive IT Ltd Blog"],"og:site_name":["Pro Drive IT Ltd","Pro Drive IT Ltd"],"tec-api-version":"v1","author":["hypedmarketing","hypedmarketing","HubSpot, Inc."],"twitter:site":"@ProDriveIT","twitter:label1":"Written by","article:modified_time":["2021-11-24T10:55:33+00:00","2021-11-24T10:55:33+01:00"],"og:image:height":["481","481"],"og:image:width":["720","720"],"publishedTime":"2021-09-22T09:19:52+00:00","og:description":["On this vlog, we look at how to access and work with Mimecast 'on hold' messages via the Mimecast website portal or Outlook app.","In our series of ‘how to’ videos we include tips on using Mimecast cloud cybersecurity. This time, we look at how to access and work with Mimecast 'on hold' messages via the Mimecast website portal or Outlook app.\n\nMimecast provides a whole range of tools for email, data and web to help prevent cyber threats"],"article:publisher":"https://www.facebook.com/prodriveit","og:image:type":["image/jpeg","image/jpeg"],"favicon":"https://prodriveit.co.uk/wp-content/uploads/2017/03/prodrive-fav.png","scrapeId":"019d46c9-4df1-70ca-9269-d3e711fe3e8e","sourceURL":"https://prodriveit.co.uk/blog/how-to-access-mimecast-on-hold-messages","url":"https://www.prodriveit.co.uk/blog/how-to-access-mimecast-on-hold-messages","statusCode":200,"contentType":"text/html; charset=UTF-8","timezone":"America/New_York","proxyUsed":"basic","cacheState":"miss","indexId":"4e24943d-e033-49f2-af69-bcb0f42461e0","creditsUsed":1}},{"url":"https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-message-release-logs/","title":"Message Release Logs - API and Integrations | Mimecast","description":"This endpoint can be used to find messages that were either released to the recipient, with details about the user that processed the release.","position":10,"markdown":"**In this guide:**\n\n- [Description](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-message-release-logs/#description)\n- [Pre-requisites](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-message-release-logs/#pre-requisites)\n- [URI](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-message-release-logs/#uri)\n- [Request Headers](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-message-release-logs/#request-headers)\n- [Request Body](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-message-release-logs/#request-body)\n- [Response](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-message-release-logs/#response)\n- [Sample Code](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-message-release-logs/#sample-code)\n\n#### Description\n\nThis endpoint can be used to find messages that were either released to the recipient, with details about the user that processed the release. These logs also include messages that expired in the held queue, and were dropped by Mimecast housekeeping services.\n\n#### Pre-requisites\n\n- In order to successfully use this endpoint the logged in user must be a Mimecast administrator with at least the **Monitoring \\| Held \\| Read** permission.\n\n#### URI\n\nTo use this endpoint you send a POST request to:\n\n- /api/gateway/get-held-release-logs\n\n#### Request Headers\n\nThe following request headers must be included in your request:\n\n| **Field** | **Description** |\n| --- | --- |\n| Authorization | Please see the [Authorization](https://integrations.mimecast.com/documentation/EPiServer/CMS/Content/documentation/guides/authorization,,32461/?epieditmode=False) guide for more information on building the Authorization header. |\n| x-mc-req-id | A randomly generated GUID, for example,
```
8578FCFC-A305-4D9A-99CB-F4D5ECEFE297
``` |\n| x-mc-app-id | The Application ID provided with your Registered API Application. |\n| x-mc-date | The current date and time in the following format, for example,
```
Tue, 24 Nov 2015 12:50:11 UTC
``` |\n\n#### Request Body\n\n```\n\n{\n\n \"meta\": {\n\n \"pagination\": {\n\n \"pageSize\": 25,\n\n \"pageToken\": \"String\"\n\n }\n\n },\n\n \"data\": [\\\n\\\n {\\\n\\\n \"searchBy\": {\\\n\\\n \"fieldName\": \"heldReason\",\\\n\\\n \"value\": \"High-Confidence Impersonation Protection\"\\\n\\\n },\\\n\\\n \"filterBy\": [\\\n\\\n {\\\n\\\n \"fieldName\": \"route\",\\\n\\\n \"value\": \"inbound\"\\\n\\\n }\\\n\\\n ],\\\n\\\n \"start\": \"2015-11-16T14:49:18+00:00\",\\\n\\\n \"end\": \"2015-11-25T14:49:18+00:00\"\\\n\\\n }\\\n\\\n ]\n\n}\n```\n\n##### meta\n\n| **Field** | **Type** | **Required** | **Description** |\n| --- | --- | --- | --- |\n| pagination | Object | Optional | An object defining paging options for the request. |\n\n##### Paginiation Object\n\n| **Field** | **Type** | **Required** | **Description** |\n| --- | --- | --- | --- |\n| pageSize | Number | Optional | The number of results to request. |\n| pageToken | String | Optional | The value of the 'next' or 'previous' fields from an earlier request. |\n\n##### Data\n\n| **Field** | **Type** | **Required** | **Description** |\n| --- | --- | --- | --- |\n| searchBy | Search Object | Optional | Field name and value on which to base search. |\n| filterBy | Array of Filter Objects | Optional | Filters that should be applied to the search results. |\n| start | Date String | Optional | The start date of results to return in ISO 8601 format. Default value is one month before the current date. |\n| end | Date String | Optional | The end date of results to return in ISO 8601 format. Default value is the current date. |\n\n##### Search Object\n\n| **Field** | **Type** | **Required** | **Description** |\n| --- | --- | --- | --- |\n| fieldName | String | Optional | The field on which to be filtered. Possible field names are: all, operator, from, to, subject, info or heldReason |\n| value | String | Optional | The value of which the filter will be applied. |\n\n##### Filter Object\n\n| **Field** | **Type** | **Required** | **Description** |\n| --- | --- | --- | --- |\n| fieldName | String | Optional | The field on which to be filtered. Possible values are: route, status or attachments. |\n| value | String | Optional | The value of which the filter will be applied. Possible values for route are: all, internal, outbound, inbound or external. Possible values for status are: released or rejected. Possible values for attachments are: true or false. |\n\n#### Response\n\n```\n\n{\n\n \"fail\": [],\n\n \"meta\": {\n\n \"status\": 200,\n\n \"pagination\": {\n\n \"pageSize\": 25,\n\n \"next\": \"String\",\n\n \"previous\": \"String\"\n\n }\n\n },\n\n \"data\": [\\\n\\\n {\\\n\\\n \"heldReleaseLogs\": [\\\n\\\n {\\\n\\\n \"spamProcessingDetail\": {\\\n\\\n \"greyEmail\": true,\\\n\\\n \"permittedSender\": {\\\n\\\n \"allow\": true,\\\n\\\n \"info\": \"allow\"\\\n\\\n },\\\n\\\n \"managedSender\": {\\\n\\\n \"allow\": true,\\\n\\\n \"info\": \"allow\"\\\n\\\n },\\\n\\\n \"dkim\": {\\\n\\\n \"allow\": true,\\\n\\\n \"info\": \"allow\"\\\n\\\n },\\\n\\\n \"spf\": {\\\n\\\n \"allow\": true,\\\n\\\n \"info\": \"allow\"\\\n\\\n },\\\n\\\n \"rbl\": {\\\n\\\n \"allow\": true,\\\n\\\n \"info\": \"allow\"\\\n\\\n },\\\n\\\n \"dmarc\": {\\\n\\\n \"allow\": true,\\\n\\\n \"info\": \"allow\"\\\n\\\n },\\\n\\\n \"spamVerdict\": {\\\n\\\n \"decision\": \"spam\",\\\n\\\n \"description\": \"\",\\\n\\\n \"risk\": \"low\",\\\n\\\n \"categories\": [\\\n\\\n {\\\n\\\n \"name\": \"spam\",\\\n\\\n \"risk\": \"low\",\\\n\\\n \"subcategories\": [\\\n\\\n {\\\n\\\n \"name\": \"phishing\",\\\n\\\n \"risk\": \"low\",\\\n\\\n \"augmentations\": [\\\n\\\n {\\\n\\\n \"name\": \"body\",\\\n\\\n \"risk\": \"negligible\"\\\n\\\n }\\\n\\\n ]\\\n\\\n }\\\n\\\n ]\\\n\\\n }\\\n\\\n ]\\\n\\\n }\\\n\\\n },\\\n\\\n \"attachments\": true,\\\n\\\n \"messageInfo\": \"Expired in queue - rejected by housekeeping\",\\\n\\\n \"subject\": \"Exclusive Offer - You don't want to miss this!\",\\\n\\\n \"detectionLevel\": \"moderate\",\\\n\\\n \"heldGroup\": \"IT Staff Global\",\\\n\\\n \"operator\": \"admin@domain.tld\",\\\n\\\n \"fromEnv\": {\\\n\\\n \"emailAddress\": \"user@domain.tld\",\\\n\\\n \"displayableName\": \"FirstName LastName\"\\\n\\\n },\\\n\\\n \"rejectReason\": \"Message contains undesirable content\",\\\n\\\n \"route\": \"inbound\",\\\n\\\n \"size\": 5043,\\\n\\\n \"heldReason\": \"High-Confidence Impersonation Protection\",\\\n\\\n \"spamScore\": 12,\\\n\\\n \"id\": \"eNpVj21LhEAUhf_LfN2VnRl1RpclCN...\",\\\n\\\n \"to\": [\\\n\\\n {\\\n\\\n \"emailAddress\": \"user@domain.tld\",\\\n\\\n \"displayableName\": \"FirstName LastName\"\\\n\\\n }\\\n\\\n ],\\\n\\\n \"released\": \"2015-11-25T14:49:18+00:00\",\\\n\\\n \"fromHdr\": {\\\n\\\n \"emailAddress\": \"user@domain.tld\",\\\n\\\n \"displayableName\": \"FirstName LastName\"\\\n\\\n },\\\n\\\n \"status\": \"released\",\\\n\\\n \"policy\": \"Moderate Spam Detection\"\\\n\\\n }\\\n\\\n ]\\\n\\\n }\\\n\\\n ]\n\n}\n```\n\n##### meta\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| status | Number | The function level status of the request. |\n| pagination | Object | An object containing paging information. |\n\n##### Pagination Object\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| pageSize | Number | The number of results requested. |\n| next | String | A pageToken value that can be used to request the next page of results. Only returned if there are more results to return. |\n| previous | String | A pageToken value that can be used to request the previous page of results. Only returned if there is a previous page. |\n\n##### data\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| heldReleaseLogs | Array of released Objects | The resulting messages that match the search and filter queries. |\n\n##### Released Object\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| spamProcessingDetail | Spam Processing Detail Object | Object containing the spam, sender validation and managed sender scan results. |\n| attachments | Boolean | Indicates whether the message contains attachments. |\n| messageInfo | String | Additional information around the release reason. |\n| subject | String | The released message's subject line. |\n| detectionLevel | String | Spam detection level, if held by a spam policy. Possible values are: relaxed, moderate, aggressive, cluster or whitelisted\\_cluster |\n| heldGroup | String | The recipient group of the held message, if message was sent to a group. |\n| operator | String | Email address of the user that released the message. |\n| fromEnv | Email Address Object | Envelope from address information |\n| rejectReason | String | Detail on the reason a message was rejected, if message was rejected. |\n| route | String | Message direction. Possible values are: inbound or outbound. |\n| size | Number | Total size of the message, in bytes. |\n| heldReason | String | Detail around the reason the message was initially held. If held by a specific policy definition, this will be the name of the policy definition that triggered the message to be held. |\n| spamScore | Number | The message spam score, based on the applied spam scanning policy definition. |\n| id | String | The Mimecast secure ID of the specific message release log. |\n| to | Array of Email Address Objects | Envelope from address information |\n| released | Date String | Timestamp of the message release action in ISO 8601 format. |\n| fromHdr | Email Address Object | Header from address information |\n| status | String | Status of the message. Possible values are released or rejected. |\n| policy | String | Name of the policy definition that triggered the message to be held. |\n\n##### Spam Processing Detail Object\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| greyEmail | Boolean | Indicates with the spam was classified as graymail or bulk. Note that this API uses graymail and greymail interchangeably. |\n| permittedSender | Information Object | Indicates if the sender has been permitted by policy. |\n| managedSender | Information Object | Indicates if the sender has been permitted by a Managed Sender entry. |\n| dkim | Information Object | Indicates if the message passed DKIM checks. |\n| spf | Information Object | Indicates if the message passed SPF checks. |\n| rbl | Information Object | Indicates if the message passed RBL checks. |\n| dmarc | Information Object | Indicates if the message passed DMARC checks. |\n| spamVerdict | Spam Verdict Object | Information about the spam scanning results. |\n\n##### Email Address Object\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| emailAddress | String | The routable email address of the user |\n| displayableName | String | Display name of the user address. If none exists, this field will be empty. |\n\n##### Spam Verdict Object\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| decision | String | Indicating what the ultimate verdict was for the message. |\n| description | String | Description of the spam verdict decision. |\n| risk | String | Identified risk level within the spam detection. Possible values are: negligible, low, high. |\n| categories | Array of Category Objects | Spam detection type categories |\n\n##### Spam Category Object\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| name | String | Name of the scanning category. Possible values are spam, phishing or graymail. Note that this API uses graymail and greymail interchangeably. |\n| risk | String | Identified risk level within the category detection. Possible values are: negligible, low, high. |\n| subcategories | Array of Spam Subcategory Objects | Additional category information under the high-level category. |\n\n##### Spam Subcategory Object\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| name | String | Name of the scanning subcategory. |\n| risk | String | Identified risk level within the subcategory detection. Possible values are: negligible, low, high. |\n| augmentations | Array of Augmentation Objects | Component of the message where this subcategory was identified. |\n\n##### Augmentation Object\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| name | String | Name of the message component. |\n| risk | String | Identified risk level within the component scanning. Possible values are: negligible, low, high. |\n\n##### Information Object\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| allow | Boolean | Indicates if this check was performed. |\n| info | String | Details about the check result. |\n\n#### Sample Code\n\nSample code is provided to demonstrate how to use the API and is not representative of a production application. To use the sample code; complete the required variables as described, populate the desired values in the request body, and execute in your favorite IDE.  Please see the [Global Base URL's](https://integrations.mimecast.com/EPiServer/CMS/Content/c7dde7d8-d351-4248-95a5-13528930efc1_developer/documentation/global-base-urls,,32727/?epieditmode=False) page to find the correct base URL to use for your account.\n\nHTTPPythonC#PowerShellJava\n\n```\n\nPOST {base_url}/api/gateway/get-held-release-logs\n\nAuthorization: MC {accesskKey}:{Base64 encoded signed Data To Sign}\n\nx-mc-date: {dateTime}\n\nx-mc-req-id: {unique id}\n\nx-mc-app-id: {applicationId}\n\nContent-Type: application/json\n\nAccept: application/json\n\n\n\n{\n\n \"meta\": {\n\n \"pagination\": {\n\n \"pageSize\": 25,\n\n \"pageToken\": \"String\"\n\n }\n\n },\n\n \"data\": [\\\n\\\n {\\\n\\\n \"searchBy\": {\\\n\\\n \"fieldName\": \"heldReason\",\\\n\\\n \"value\": \"High-Confidence Impersonation Protection\"\\\n\\\n },\\\n\\\n \"filterBy\": [\\\n\\\n {\\\n\\\n \"fieldName\": \"route\",\\\n\\\n \"value\": \"inbound\"\\\n\\\n }\\\n\\\n ],\\\n\\\n \"start\": \"2015-11-16T14:49:18+00:00\",\\\n\\\n \"end\": \"2015-11-25T14:49:18+00:00\"\\\n\\\n }\\\n\\\n ]\n\n}\n```\n\n```\n\nimport base64\n\nimport hashlib\n\nimport hmac\n\nimport uuid\n\nimport datetime\n\nimport requests\n\n\n\n# Setup required variables\n\nbase_url = \"https://xx-api.mimecast.com\"\n\nuri = \"/api/gateway/get-held-release-logs\"\n\nurl = base_url + uri\n\naccess_key = \"YOUR ACCESS KEY\"\n\nsecret_key = \"YOUR SECRET KEY\"\n\napp_id = \"YOUR APPLICATION ID\"\n\napp_key = \"YOUR APPLICATION KEY\"\n\n\n\n# Generate request header values\n\nrequest_id = str(uuid.uuid4())\n\nhdr_date = datetime.datetime.utcnow().strftime(\"%a, %d %b %Y %H:%M:%S\") + \" UTC\"\n\n\n\n# DataToSign is used in hmac_sha1\n\ndataToSign = ':'.join([hdr_date, request_id, uri, app_key])\n\n\n\n# Create the HMAC SHA1 of the Base64 decoded secret key for the Authorization header\n\nhmac_sha1 = hmac.new(base64.b64decode(secret_key), dataToSign.encode(), digestmod=hashlib.sha1).digest()\n\n\n\n# Use the HMAC SHA1 value to sign the hdrDate + \":\" requestId + \":\" + URI + \":\" + appkey\n\nsig = base64.b64encode(hmac_sha1).rstrip()\n\n\n\n# Create request headers\n\nheaders = {\n\n 'Authorization': 'MC ' + access_key + ':' + sig.decode(),\n\n 'x-mc-app-id': app_id,\n\n 'x-mc-date': hdr_date,\n\n 'x-mc-req-id': request_id,\n\n 'Content-Type': 'application/json'\n\n}\n\n\n\npayload = {\n\n 'meta': {\n\n 'pagination': {\n\n 'pageSize': 25,\n\n 'pageToken': 'String'\n\n }\n\n },\n\n 'data': [\\\n\\\n {\\\n\\\n 'searchBy': {\\\n\\\n 'fieldName': 'heldReason',\\\n\\\n 'value': 'High-Confidence Impersonation Protection'\\\n\\\n },\\\n\\\n 'filterBy': [\\\n\\\n {\\\n\\\n 'fieldName': 'route',\\\n\\\n 'value': 'inbound'\\\n\\\n }\\\n\\\n ],\\\n\\\n 'start': '2015-11-16T14:49:18+00:00',\\\n\\\n 'end': '2015-11-25T14:49:18+00:00'\\\n\\\n }\\\n\\\n ]\n\n}\n\n\n\nr = requests.post(url=url, headers=headers, data=str(payload))\n\n\n\nprint(r.text)\n```\n\n```\n\nstatic void Main(string[] args)\n\n {\n\n //Setup required variables\n\n string baseUrl = \"https://xx-api.mimecast.com\";\n\n string uri = \"/api/gateway/get-held-release-logs\";\n\n string accessKey = \"YOUR ACCESS KEY\";\n\n string secretKey = \"YOUR SECRET KEY\";\n\n string appId = \"YOUR APPLICATION ID\";\n\n string appKey = \"YOUR APPLICATION KEY\";\n\n\n\n //Generate request header values\n\n string hdrDate = System.DateTime.Now.ToUniversalTime().ToString(\"R\");\n\n string requestId = System.Guid.NewGuid().ToString();\n\n\n\n //Create the HMAC SHA1 of the Base64 decoded secret key for the Authorization header\n\n System.Security.Cryptography.HMAC h = new System.Security.Cryptography.HMACSHA1(System.Convert.FromBase64String(secretKey));\n\n\n\n //Use the HMAC SHA1 value to sign the hdrDate + \":\" requestId + \":\" + URI + \":\" + appkey\n\n byte[] hash = h.ComputeHash(System.Text.Encoding.Default.GetBytes(hdrDate + \":\" + requestId + \":\" + uri + \":\" + appKey));\n\n\n\n //Build the signature to be included in the Authorization header in your request\n\n string signature = \"MC \" + accessKey + \":\" + System.Convert.ToBase64String(hash);\n\n\n\n //Build Request\n\n System.Net.HttpWebRequest request = (System.Net.HttpWebRequest)System.Net.WebRequest.Create(baseUrl + uri);\n\n request.Method = \"POST\";\n\n request.ContentType = \"application/json\";\n\n\n\n //Add Headers\n\n request.Headers[System.Net.HttpRequestHeader.Authorization] = signature;\n\n request.Headers.Add(\"x-mc-date\", hdrDate);\n\n request.Headers.Add(\"x-mc-req-id\", requestId);\n\n request.Headers.Add(\"x-mc-app-id\", appId);\n\n\n\n //Add request body\n\n //Create and write data to stream\n\n string postData = @\"{\n\n \"\"meta\"\": {\n\n \"\"pagination\"\": {\n\n \"\"pageSize\"\": 25,\n\n \"\"pageToken\"\": \"\"String\"\"\n\n }\n\n },\n\n \"\"data\"\": [\\\n\\\n {\\\n\\\n \"\"searchBy\"\": {\\\n\\\n \"\"fieldName\"\": \"\"heldReason\"\",\\\n\\\n \"\"value\"\": \"\"High-Confidence Impersonation Protection\"\"\\\n\\\n },\\\n\\\n \"\"filterBy\"\": [\\\n\\\n {\\\n\\\n \"\"fieldName\"\": \"\"route\"\",\\\n\\\n \"\"value\"\": \"\"inbound\"\"\\\n\\\n }\\\n\\\n ],\\\n\\\n \"\"start\"\": \"\"2015-11-16T14:49:18+00:00\"\",\\\n\\\n \"\"end\"\": \"\"2015-11-25T14:49:18+00:00\"\"\\\n\\\n }\\\n\\\n ]\n\n}\";\n\n\n\n byte[] payload = System.Text.Encoding.UTF8.GetBytes(postData);\n\n\n\n System.IO.Stream stream = request.GetRequestStream();\n\n stream.Write(payload, 0, payload.Length);\n\n stream.Close();\n\n\n\n //Send Request\n\n System.Net.HttpWebResponse response = (System.Net.HttpWebResponse)request.GetResponse();\n\n\n\n //Output response to console\n\n System.IO.StreamReader reader = new System.IO.StreamReader(response.GetResponseStream());\n\n string responseBody = \"\";\n\n string temp = null;\n\n while ((temp = reader.ReadLine()) != null)\n\n {\n\n responseBody += temp;\n\n };\n\n System.Console.WriteLine(responseBody);\n\n System.Console.ReadLine();\n\n }\n```\n\n```\n\n#Setup required variables\n\n$baseUrl = \"https://xx-api.mimecast.com\"\n\n$uri = \"/api/gateway/get-held-release-logs\"\n\n$url = $baseUrl + $uri\n\n$accessKey = \"YOUR ACCESS KEY\"\n\n$secretKey = \"YOUR SECRET KEY\"\n\n$appId = \"YOUR APPLICATION ID\"\n\n$appKey = \"YOUR APPLICATION KEY\"\n\n\n\n#Generate request header values\n\n$hdrDate = (Get-Date).ToUniversalTime().ToString(\"ddd, dd MMM yyyy HH:mm:ss UTC\")\n\n$requestId = [guid]::NewGuid().guid\n\n\n\n#Create the HMAC SHA1 of the Base64 decoded secret key for the Authorization header\n\n$sha = New-Object System.Security.Cryptography.HMACSHA1\n\n$sha.key = [Convert]::FromBase64String($secretKey)\n\n$sig = $sha.ComputeHash([Text.Encoding]::UTF8.GetBytes($hdrDate + \":\" + $requestId + \":\" + $uri + \":\" + $appKey))\n\n$sig = [Convert]::ToBase64String($sig)\n\n\n\n#Create Headers\n\n$headers = @{\"Authorization\" = \"MC \" + $accessKey + \":\" + $sig;\n\n \"x-mc-date\" = $hdrDate;\n\n \"x-mc-app-id\" = $appId;\n\n \"x-mc-req-id\" = $requestId;\n\n \"Content-Type\" = \"application/json\"}\n\n\n\n#Create post body\n\n$postBody = \"{\n\n \"\"meta\"\": {\n\n \"\"pagination\"\": {\n\n \"\"pageSize\"\": 25,\n\n \"\"pageToken\"\": \"\"String\"\"\n\n }\n\n },\n\n \"\"data\"\": [\\\n\\\n {\\\n\\\n \"\"searchBy\"\": {\\\n\\\n \"\"fieldName\"\": \"\"heldReason\"\",\\\n\\\n \"\"value\"\": \"\"High-Confidence Impersonation Protection\"\"\\\n\\\n },\\\n\\\n \"\"filterBy\"\": [\\\n\\\n {\\\n\\\n \"\"fieldName\"\": \"\"route\"\",\\\n\\\n \"\"value\"\": \"\"inbound\"\"\\\n\\\n }\\\n\\\n ],\\\n\\\n \"\"start\"\": \"\"2015-11-16T14:49:18+00:00\"\",\\\n\\\n \"\"end\"\": \"\"2015-11-25T14:49:18+00:00\"\"\\\n\\\n }\\\n\\\n ]\n\n}\"\n\n\n\n#Send Request\n\n$response = Invoke-RestMethod -Method Post -Headers $headers -Body $postBody -Uri $url\n\n\n\n#Print the response\n\n$response\n```\n\n```\n\npublic static void main(String[] args) throws java.io.IOException, java.security.NoSuchAlgorithmException, java.security.InvalidKeyException {\n\n\n\n //set up variables for request\n\n String baseUrl = \"https://xx-api.mimecast.com\";\n\n String uri = \"/api/gateway/get-held-release-logs\";\n\n String url = \"https://\" + baseUrl + uri;\n\n String accessKey = \"YOUR ACCESS KEY\";\n\n String secretKey = \"YOUR SECRET KEY\";\n\n String appId = \"YOUR APPLICATION ID\";\n\n String appKey = \"YOUR APPLICATION KEY\";\n\n\n\n //create URL object\n\n java.net.URL obj = new java.net.URL(url);\n\n\n\n // set guid for x-mc-req-id header\n\n String guid = java.util.UUID.randomUUID().toString();\n\n\n\n // set date for x-mc-date header\n\n java.text.SimpleDateFormat sdf = new java.text.SimpleDateFormat(\"EEE, d MMM yyyy HH:mm:ss z\");\n\n sdf.setTimeZone(java.util.TimeZone.getTimeZone(\"UTC\"));\n\n String date = sdf.format(new java.util.Date());\n\n\n\n //create signature for the Authorization header\n\n String dataToSign = date + \":\" + guid + \":\" + uri + \":\" + appKey;\n\n String hmacSHA1 = \"HmacSHA1\";\n\n javax.crypto.spec.SecretKeySpec signingKey = new javax.crypto.spec.SecretKeySpec(org.apache.commons.codec.binary.Base64.decodeBase64(secretKey.getBytes()), hmacSHA1);\n\n javax.crypto.Mac mac = javax.crypto.Mac.getInstance(hmacSHA1);\n\n mac.init(signingKey);\n\n String sig = new String(org.apache.commons.codec.binary.Base64.encodeBase64(mac.doFinal(dataToSign.getBytes())));\n\n\n\n // create request object\n\n javax.net.ssl.HttpsURLConnection con = (javax.net.ssl.HttpsURLConnection) obj.openConnection();\n\n\n\n //set request type to POST\n\n con.setRequestMethod(\"POST\");\n\n con.setDoOutput(true);\n\n\n\n //add reuqest headers\n\n con.setRequestProperty(\"Authorization\", \"MC \" + accessKey + \":\" + sig);\n\n con.setRequestProperty(\"x-mc-req-id\", guid);\n\n con.setRequestProperty(\"x-mc-app-id\", appId);\n\n con.setRequestProperty(\"x-mc-date\", date);\n\n con.setRequestProperty(\"Content-Type\", \"application/json\");\n\n con.setRequestProperty(\"Accept\", \"application/json\");\n\n\n\n //Add post body to the request\n\n String postBody = \"{\\n\" +\n\n\" \\\"meta\\\": {\\n\" +\n\n\" \\\"pagination\\\": {\\n\" +\n\n\" \\\"pageSize\\\": 25,\\n\" +\n\n\" \\\"pageToken\\\": \\\"String\\\"\\n\" +\n\n\" }\\n\" +\n\n\" },\\n\" +\n\n\" \\\"data\\\": [\\n\" +\\\n\\\n\" {\\n\" +\\\n\\\n\" \\\"searchBy\\\": {\\n\" +\\\n\\\n\" \\\"fieldName\\\": \\\"heldReason\\\",\\n\" +\\\n\\\n\" \\\"value\\\": \\\"High-Confidence Impersonation Protection\\\"\\n\" +\\\n\\\n\" },\\n\" +\\\n\\\n\" \\\"filterBy\\\": [\\n\" +\\\n\\\n\" {\\n\" +\\\n\\\n\" \\\"fieldName\\\": \\\"route\\\",\\n\" +\\\n\\\n\" \\\"value\\\": \\\"inbound\\\"\\n\" +\\\n\\\n\" }\\n\" +\\\n\\\n\" ],\\n\" +\\\n\\\n\" \\\"start\\\": \\\"2015-11-16T14:49:18+00:00\\\",\\n\" +\\\n\\\n\" \\\"end\\\": \\\"2015-11-25T14:49:18+00:00\\\"\\n\" +\\\n\\\n\" }\\n\" +\\\n\\\n\" ]\\n\" +\n\n\"}\";\n\n java.io.OutputStream os = con.getOutputStream();\n\n os.write(postBody.getBytes(\"UTF-8\"));\n\n os.close();\n\n\n\n //process response\n\n java.io.BufferedReader in = new java.io.BufferedReader(\n\n new java.io.InputStreamReader(con.getInputStream()));\n\n String inputLine;\n\n StringBuffer response = new StringBuffer();\n\n\n\n while ((inputLine = in.readLine()) != null) {\n\n response.append(inputLine);\n\n }\n\n in.close();\n\n\n\n //return result\n\n java.lang.System.out.println(response.toString());\n\n }\n```\n\n[Back to Top](https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-message-release-logs/#)","metadata":{"og:site_name":"Mimecast","ogSiteName":"Mimecast","ogTitle":"Message Release Logs","title":"Message Release Logs | Mimecast","ogUrl":"https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-message-release-logs/","og:url":"https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-message-release-logs/","ogDescription":"Get message release logs","VIcurrentDateTime":["639106058916686805>","639106058916686896"],"robots":"index, follow","viewport":"width=device-width, initial-scale=1, shrink-to-fit=no","og:description":"Get message release logs","language":"en","theme-color":"#ffffff","description":"Get message release logs","author":"mimecast","og:title":"Message Release Logs","twitter:card":"summary_large_image","VirtualFolder":["\\","/"],"favicon":"https://integrations.mimecast.com/sc-static/img/favicons/icons_m_192x192.png","scrapeId":"019d46c9-4df1-70ca-9269-d6b477c92e11","sourceURL":"https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-message-release-logs/","url":"https://integrations.mimecast.com/documentation/endpoint-reference/logs-and-statistics/get-message-release-logs/","statusCode":200,"contentType":"text/html; charset=utf-8","timezone":"America/New_York","proxyUsed":"basic","cacheState":"miss","indexId":"c25504d9-72e8-47cb-b469-aefd9a61e7c0","creditsUsed":1}}]}} \ No newline at end of file diff --git a/app/admin/sync/mimecast/page.tsx b/app/admin/sync/mimecast/page.tsx index 6795a71..ea24756 100644 --- a/app/admin/sync/mimecast/page.tsx +++ b/app/admin/sync/mimecast/page.tsx @@ -7,7 +7,8 @@ import { Tabs, TabsContent, TabsList, TabsTrigger } from '@/components/ui/tabs'; import { ArrowLeft, Activity, History, Calendar, Mail, RefreshCw, Loader2, CheckCircle2, XCircle, AlertTriangle, Shield, Inbox, Send, - Clock, ChevronDown, ChevronRight, + Clock, ChevronDown, ChevronRight, Users, Search, LockKeyhole, UnlockKeyhole, + PauseCircle, Building2, } from 'lucide-react'; import SyncScheduler from '@/components/admin/SyncScheduler'; @@ -288,6 +289,117 @@ function ThreatsTab() { ); } +// ── Cloud Users Tab ─────────────────────────────────────────────────────────── +function CloudUserTab() { + const [email, setEmail] = useState(''); + const [domain, setDomain] = useState(''); + const [loading, setLoading] = useState(false); + const [result, setResult] = useState(null); + const [showRaw, setShowRaw] = useState(false); + + const handleEmailChange = (v: string) => { + setEmail(v); + const atIdx = v.indexOf('@'); + if (atIdx >= 0) setDomain(v.slice(atIdx + 1)); + }; + + const lookup = async () => { + if (!email || !domain) return; + setLoading(true); + setResult(null); + setShowRaw(false); + try { + const params = new URLSearchParams({ emailAddress: email, domain }); + const res = await fetch(`/api/mimecast/cloud-user?${params}`); + setResult(await res.json()); + } catch (err: any) { + setResult({ error: err.message }); + } finally { + setLoading(false); + } + }; + + const user = result?.user; + const lockedOut = user?.lockedOut ?? false; + + return ( +
+
+
+ + handleEmailChange(e.target.value)} + onKeyDown={e => e.key === 'Enter' && lookup()} + className="border rounded-md px-3 py-1.5 text-sm bg-background w-72" + /> +
+
+ + setDomain(e.target.value)} + onKeyDown={e => e.key === 'Enter' && lookup()} + className="border rounded-md px-3 py-1.5 text-sm bg-background w-48" + /> +
+ +
+ + {result?.error && ( +
+ {result.error} +
+ )} + + {result && !result.error && !result.found && ( +
+ User not found in Mimecast Cloud Gateway. +
+ )} + + {user && ( +
+
+ {lockedOut + ? + : } +
+

+ {lockedOut ? 'Account Locked Out' : 'Account Active'} +

+

+ {user.name && {user.name} · } + {user.emailAddress} + {user.status && · Status: {user.status}} +

+
+
+ + + {showRaw && ( + 
+              {JSON.stringify(user._raw ?? user, null, 2)}
+
+ )} +
+ )} +
+ ); +} + // ── History Tab ─────────────────────────────────────────────────────────────── function HistoryTab() { const [rows, setRows] = useState([]); @@ -346,6 +458,177 @@ function HistoryTab() { ); } +// ── Held Mail Tab ───────────────────────────────────────────────────────────── +function HeldMailTab() { + const [data, setData] = useState(null); + const [loading, setLoading] = useState(false); + const [recipient, setRecipient] = useState(''); + const [tenantFilter, setTenantFilter] = useState(''); + const [policyFilter, setPolicyFilter] = useState(''); + const [loaded, setLoaded] = useState(false); + + const load = (recipientVal?: string) => { + setLoading(true); + const params = new URLSearchParams(); + const r = recipientVal ?? recipient; + if (r) params.set('recipient', r); + if (tenantFilter) params.set('tenantId', tenantFilter); + fetch(`/api/mimecast/held?${params}`) + .then(res => res.json()) + .then(d => { setData(d); setLoaded(true); }) + .catch(() => setData(null)) + .finally(() => setLoading(false)); + }; + + const messages: any[] = data?.messages ?? []; + const filtered = policyFilter + ? messages.filter(m => m.policyInfo?.toLowerCase().includes(policyFilter.toLowerCase())) + : messages; + + const policies = [...new Set(messages.map((m: any) => m.policyInfo).filter(Boolean))].sort(); + const tenants: any[] = data?.tenants ?? []; + + return ( +
+ {/* Search bar */} +
+
+ + setRecipient(e.target.value)} + onKeyDown={e => e.key === 'Enter' && load()} + className="w-full border rounded-md px-3 py-1.5 text-sm bg-background" + /> +
+ {tenants.length > 1 && ( +
+ + +
+ )} + {loaded && policies.length > 0 && ( +
+ + +
+ )} + +
+ + {/* Tenant summary badges */} + {loaded && tenants.length > 0 && ( +
+ {tenants.map(t => ( +
0 ? 'border-yellow-400/40 bg-yellow-500/5 text-yellow-700' : + 'border-border bg-muted/30 text-muted-foreground' + }`}> + + {t.accountName} + {t.error + ? error + : — {t.count.toLocaleString()}{t.totalCount > t.count ? ` of ${t.totalCount.toLocaleString()}` : ''} held + } +
+ ))} +
+ )} + + {!loaded && !loading && ( +
+ Click “Load Held Mail” to fetch held messages across all configured Mimecast tenants. +
+ )} + + {loading && ( +
+ + Fetching held messages from all tenants… +
+ )} + + {loaded && !loading && filtered.length === 0 && ( +
+ No held messages found. +
+ )} + + {loaded && !loading && filtered.length > 0 && ( +
+
+ + {filtered.length.toLocaleString()} held message{filtered.length !== 1 ? 's' : ''} + {data?.totalCount > filtered.length ? ` (showing ${filtered.length} of ${data.totalCount.toLocaleString()} total)` : ''} + +
+
+ + + + + + + + + {tenants.length > 1 && } + + + + {filtered.map((m: any) => ( + + + + + + + {tenants.length > 1 && ( + + )} + + ))} + +
DateToFromSubjectPolicyTenant
+ {new Date(m.dateReceived).toLocaleString(undefined, { month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit' })} + +
{m.to}
+ 		+
{m.fromDisplay || m.from}
+ {m.fromDisplay &&
{m.from}
} + 		+
{m.subject || '(no subject)'}
+ 		+ + {m.policyInfo || m.reason || '—'} + + {m.accountName}
+
+
+ )} +
+ ); +} + // ── Page ────────────────────────────────────────────────────────────────────── export default function MimecastSyncPage() { const [statusData, setStatusData] = useState(null); @@ -414,21 +697,25 @@ export default function MimecastSyncPage() { )} - - Status - Messages - Threats - History - Schedules + + Status + Held Mail + Messages + Threats + Cloud Users + History + Schedules - + - - - - + + + + + + ); diff --git a/app/api/mimecast/cloud-user/route.ts b/app/api/mimecast/cloud-user/route.ts new file mode 100644 index 0000000..7d41531 --- /dev/null +++ b/app/api/mimecast/cloud-user/route.ts @@ -0,0 +1,22 @@ +import { NextRequest, NextResponse } from 'next/server'; +import { getMimecastClient } from '@/lib/services/mimecast-client'; + +export async function GET(req: NextRequest) { + const emailAddress = req.nextUrl.searchParams.get('emailAddress'); + const domain = req.nextUrl.searchParams.get('domain'); + + if (!emailAddress || !domain) { + return NextResponse.json({ error: 'emailAddress and domain are required' }, { status: 400 }); + } + + try { + const client = getMimecastClient(); + const user = await client.getCloudUser(emailAddress, domain); + if (!user) { + return NextResponse.json({ found: false }); + } + return NextResponse.json({ found: true, user }); + } catch (err: any) { + return NextResponse.json({ error: err.message }, { status: 500 }); + } +} diff --git a/app/api/mimecast/held/route.ts b/app/api/mimecast/held/route.ts new file mode 100644 index 0000000..8ef2663 --- /dev/null +++ b/app/api/mimecast/held/route.ts @@ -0,0 +1,91 @@ +import { NextRequest, NextResponse } from 'next/server'; +import { postgresClient } from '@/lib/services/postgres-client'; +import { getMimecastClientForTenant } from '@/lib/services/mimecast-client'; + +export async function GET(req: NextRequest) { + try { + const { searchParams } = new URL(req.url); + const tenantId = searchParams.get('tenantId'); + const recipient = searchParams.get('recipient') ?? undefined; + + // Build query — filter by tenant if provided, else all enabled tenants + let tenants: any[]; + if (tenantId) { + const r = await postgresClient.query( + `SELECT mt.*, c.company_name FROM mimecast_tenants mt + LEFT JOIN companies c ON c.id = mt.company_id + WHERE mt.id = $1 AND mt.enabled = true`, + [tenantId] + ); + tenants = r.rows; + } else { + const r = await postgresClient.query( + `SELECT mt.*, c.company_name FROM mimecast_tenants mt + LEFT JOIN companies c ON c.id = mt.company_id + WHERE mt.enabled = true + ORDER BY mt.account_name` + ); + tenants = r.rows; + } + + if (!tenants.length) { + return NextResponse.json({ error: 'No configured Mimecast tenants found' }, { status: 404 }); + } + + // Fetch held messages for each tenant in parallel + const results = await Promise.allSettled( + tenants.map(async (tenant) => { + const client = getMimecastClientForTenant(tenant); + const { messages, totalCount } = await client.getHeldMessages({ recipient, maxMessages: 500 }); + return { + tenantId: tenant.id, + accountCode: tenant.account_code, + accountName: tenant.account_name, + companyName: tenant.company_name ?? tenant.account_name, + companyId: tenant.company_id, + messages, + totalCount, + error: null, + }; + }) + ); + + const tenantResults = results.map((r, i) => { + if (r.status === 'fulfilled') return r.value; + return { + tenantId: tenants[i].id, + accountCode: tenants[i].account_code, + accountName: tenants[i].account_name, + companyName: tenants[i].company_name ?? tenants[i].account_name, + companyId: tenants[i].company_id, + messages: [], + totalCount: 0, + error: r.reason?.message ?? 'Failed to fetch', + }; + }); + + const allMessages = tenantResults.flatMap(t => + t.messages.map((m: any) => ({ ...m, tenantId: t.tenantId, accountName: t.accountName, companyName: t.companyName })) + ); + + // Sort all messages newest first + allMessages.sort((a, b) => new Date(b.dateReceived).getTime() - new Date(a.dateReceived).getTime()); + + return NextResponse.json({ + tenants: tenantResults.map(t => ({ + tenantId: t.tenantId, + accountName: t.accountName, + companyName: t.companyName, + companyId: t.companyId, + count: t.messages.length, + totalCount: t.totalCount, + error: t.error, + })), + messages: allMessages, + totalCount: allMessages.length, + }); + } catch (error: any) { + console.error('[Mimecast] held messages error:', error); + return NextResponse.json({ error: error.message }, { status: 500 }); + } +} diff --git a/app/api/sync/classifications/route.ts b/app/api/sync/classifications/route.ts index 4e5fb48..6beca8b 100644 --- a/app/api/sync/classifications/route.ts +++ b/app/api/sync/classifications/route.ts @@ -6,18 +6,20 @@ export async function POST(request: NextRequest) { try { console.log('Starting classification icons sync...'); - // Fetch classification icons from Autotask API + // Fetch classification picklist from Companies field info const autotaskClient = getAutotaskClient(); - const classifications = await autotaskClient.getClassificationIcons(); - - if (!classifications || classifications.length === 0) { + const fields = await autotaskClient.getFieldInfo('Companies'); + const classificationField = fields.find((f: any) => f.name === 'classification'); + + if (!classificationField || !classificationField.picklistValues?.length) { return NextResponse.json( - { error: 'No classifications found in Autotask' }, + { error: 'No classification picklist found in Companies field info' }, { status: 404 } ); } - console.log(`Fetched ${classifications.length} classification icons from Autotask`); + const classifications = classificationField.picklistValues; + console.log(`Fetched ${classifications.length} classification values from Autotask`); let inserted = 0; let updated = 0; @@ -26,16 +28,16 @@ export async function POST(request: NextRequest) { for (const classification of classifications) { const result = await postgresClient.query( `INSERT INTO company_classifications ( - classification_id, - name, - description, + classification_id, + name, + description, is_active, is_system, updated_at, synced_at ) VALUES ($1, $2, $3, $4, $5, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP) - ON CONFLICT (classification_id) - DO UPDATE SET + ON CONFLICT (classification_id) + DO UPDATE SET name = EXCLUDED.name, description = EXCLUDED.description, is_active = EXCLUDED.is_active, @@ -44,9 +46,9 @@ export async function POST(request: NextRequest) { synced_at = CURRENT_TIMESTAMP RETURNING (xmax = 0) AS inserted`, [ - classification.id, - classification.name, - classification.description || null, + parseInt(String(classification.value)), + classification.label, + null, classification.isActive !== false, classification.isSystem || false ] @@ -66,7 +68,7 @@ export async function POST(request: NextRequest) { total: classifications.length, inserted, updated, - message: `Synced ${classifications.length} classification icons` + message: `Synced ${classifications.length} classifications from Companies field info` }); } catch (error) { diff --git a/docs/DATTO_RMM_API_GUIDE.md b/docs/DATTO_RMM_API_GUIDE.md new file mode 100644 index 0000000..56808c3 --- /dev/null +++ b/docs/DATTO_RMM_API_GUIDE.md @@ -0,0 +1,280 @@ +# Datto RMM API Guide for openclaw + +Everything learned from building the Datto RMM integration in Pulse. Use this as a reference for any future work touching the Datto RMM API. + +--- + +## Authentication + +Datto RMM API v2 uses **OAuth2 with password grant type** — not a simple API key header. + +- **Auth endpoint**: `https://concord-api.centrastage.net/auth/oauth/token` +- **Base API URL**: `https://concord-api.centrastage.net/api/v2` +- **Client credentials**: always `public-client:public` (this is the public OAuth client — not your credentials) +- **Your credentials**: API Access Key = `username`, API Secret Key = `password` + +```http +POST https://concord-api.centrastage.net/auth/oauth/token +Authorization: Basic cHVibGljLWNsaWVudDpwdWJsaWM= (base64 of "public-client:public") +Content-Type: application/x-www-form-urlencoded + +grant_type=password&username=YOUR_API_KEY&password=YOUR_API_SECRET +``` + +Response returns `access_token` (bearer token). Tokens last ~1 hour; refresh proactively at 50 minutes. + +**Environment variables used in Pulse:** +``` +DATTO_RMM_API_URL=https://concord-api.centrastage.net +DATTO_RMM_API_KEY= +DATTO_RMM_API_SECRET= +DATTO_RMM_WEBHOOK_SECRET= +``` + +--- + +## Making API Calls + +All requests go to `https://concord-api.centrastage.net/api/v2{endpoint}` with: + +```http +Authorization: Bearer {access_token} +Content-Type: application/json +Accept: application/json +``` + +The response body is always JSON. Always parse it — the API never returns empty 200s (except for write operations where you should guard with `text ? JSON.parse(text) : {}`). + +--- + +## Key Endpoints + +### Sites +``` +GET /account/sites → { sites: [...], pageDetails: {...} } +GET /site/{siteUid}/devices → { devices: [...] } +``` + +Sites map to Autotask companies via `autotaskCompanyId` / `autotaskCompanyName` fields on the site object. This is the primary join key between the two systems. + +### Devices +``` +GET /account/devices → { devices: [...], pageDetails: {...} } +GET /devices/{deviceId} → { item: DattoRMMDevice } +GET /device/{deviceId}/auditdata → detailed hardware info (bios, processors, memory, disks) +``` + +Default page size is 250. Always paginate using `pageDetails.nextPageUrl` — follow it until null. + +### Alerts +``` +GET /account/alerts/open → { alerts: [...], pageDetails: {...} } +GET /account/alerts/resolved → { alerts: [...], pageDetails: {...} } +GET /alert/{alertUid} → single alert with full alertContext +``` + +Resolved alerts can be huge — cap page fetches (e.g. 4 pages) rather than fetching all. + +For PING alerts, `alertContext['@class'] === 'ping_ctx'` and `alertContext.instanceName` holds the ping target hostname. + +### Components & Quick Jobs +``` +GET /account/components → { components: [...] } (automation scripts/tasks) +PUT /device/{deviceUid}/quickjob → run a component on a device +GET /job/{jobUid}/results/{deviceUid} → job output/results +``` + +Quick job payload: +```json +{ + "jobName": "My Job Name", + "jobComponent": { + "componentUid": "abc-123-...", + "variables": [ + { "name": "VAR_NAME", "value": "value" } + ] + } +} +``` + +--- + +## Pagination Pattern + +The API uses `pageDetails.nextPageUrl` for cursor-based pagination. Always follow it: + +```typescript +let url: string | null = `https://concord-api.centrastage.net/api/v2/account/sites?pageSize=250`; +while (url) { + const resp = await fetch(url, { headers: { Authorization: `Bearer ${token}` } }); + const body = await resp.json(); + items.push(...(body.sites || [])); + url = body.pageDetails?.nextPageUrl ?? null; +} +``` + +Some older endpoints use `?page=1&pageSize=250` query params — check which pattern each endpoint uses. The `fetchAllPages` helper in `datto-rmm-client.ts` handles the `nextPageUrl` style. + +--- + +## Data Model (PostgreSQL Tables) + +### `datto_rmm_sites` +| Column | Notes | +|--------|-------| +| `id` | Datto integer ID (PK) | +| `uid` | Datto GUID string (unique) | +| `name` | Site display name | +| `autotask_company_id` | FK → `companies(id)` — join key | +| `autotask_company_name` | Denormalized for display | +| `number_of_devices` | Online/offline counts from API | +| `portal_url` | Deep link to Datto portal | + +### `datto_rmm_devices` +| Column | Notes | +|--------|-------| +| `id` | Datto integer ID (PK) | +| `uid` | Datto GUID (unique, used for API calls and quick jobs) | +| `site_id` | FK → `datto_rmm_sites(id)` | +| `hostname` | Device hostname | +| `online` / `suspended` / `deleted` | Status flags | +| `device_type_category` | e.g. "Desktop", "Server", "Laptop" | +| `operating_system` | OS string | +| `antivirus_product` / `antivirus_status` | AV info | +| `patch_status` | Patch management summary | +| `patches_approved_pending` | Count of pending patches | +| `last_seen` | Timestamp (ms epoch from API, stored as TIMESTAMPTZ) | +| `web_remote_url` | Direct remote session URL | +| `udf` | JSONB — User Defined Fields 1–10 from API | + +### `datto_rmm_alerts` +| Column | Notes | +|--------|-------| +| `alert_uid` | PK (Datto GUID string) | +| `device_uid` / `device_name` | Source device | +| `site_uid` / `site_name` | Source site | +| `priority` | "Critical", "High", "Moderate", "Low", "Information" | +| `alert_context` | JSONB — varies by alert type, contains `@class` discriminator | +| `resolved` | Boolean | +| `resolved_on` | Timestamp | +| `muted` | Boolean | +| `ticket_number` | Linked Autotask ticket if any | +| `alert_category` | e.g. "Patch Management" | +| `alert_type` | e.g. "PING", "DISK", "CPU" | +| `alert_message_en` | Human-readable alert message | +| `device_udf1`–`device_udf29` | All 29 UDF fields from webhook payloads | +| `ping_target` | Resolved from API for PING alerts | +| `triggered` | Raw webhook "True"/"False" string | + +### `datto_rmm_webhook_logs` +Raw capture table — stores every incoming webhook payload verbatim for inspection before processing. + +--- + +## Webhooks + +Datto RMM can POST alert events to your endpoint when alerts fire or resolve. + +**Webhook receiver**: `POST /api/webhooks/datto-rmm` + +**Authentication**: Datto sends a shared secret in the `X-Datto-Webhook-Secret` header. Validate it against `DATTO_RMM_WEBHOOK_SECRET` env var. + +**Alert webhook payload shape** (flat JSON, not nested like the REST API): +```json +{ + "alert_uid": "abc-123-...", + "triggered": "True", // "True" = alert fired, "False" = resolved + "alert_type": "PING", + "alert_category": "Networking", + "alert_priority": "Critical", + "alert_message_en": "Ping monitor failed for ...", + "device_uid": "...", + "device_hostname": "SERVER01", + "device_ip": "10.0.0.1", + "device_os": "Windows Server 2019", + "device_description": "...", + "device_id": "12345", + "site_uid": "...", + "site_name": "ACME Corp", + "site_id": "678", + "platform": "Windows", + "last_user": "DOMAIN\\user", + "device_udf1": "...", + // ... device_udf2 through device_udf29 +} +``` + +Key gotcha: `triggered === "True"` means the alert is **active** (not resolved). `triggered === "False"` means it **resolved**. Map `triggered === "False"` → `resolved = true`. + +**Always return HTTP 200** even on errors — Datto will disable your webhook endpoint if it receives repeated non-200 responses. + +--- + +## Sync Architecture in Pulse + +The sync pipeline runs in order: **sites → devices → open_alerts → resolved_alerts** + +Sites must sync before devices (FK constraint). The sync service guards against orphaned FK refs by pre-fetching known IDs and setting FK fields to null when the parent doesn't exist yet. + +Timestamps from the Datto API come as **millisecond epoch integers**. Convert with `new Date(milliseconds)` before storing in PostgreSQL. + +The factory singleton (`datto-rmm-factory.ts`) is the standard way to get a client instance in API routes: +```typescript +import { getDattoRMMClient } from '@/lib/services/datto-rmm-factory'; +const client = getDattoRMMClient(); +``` + +--- + +## Common Gotchas + +1. **Auth URL is different from API URL** — token is fetched from `concord-api.centrastage.net/auth/...`, API calls go to `concord-api.centrastage.net/api/v2/...` + +2. **Parse auth response carefully** — if auth fails, the server may return HTML (an error page) instead of JSON. Always try/catch the JSON.parse and log the raw text on failure. + +3. **`uid` vs `id`** — devices and sites have both an integer `id` and a GUID `uid`. The REST API uses `uid` in paths for most operations. Quick jobs require `deviceUid` (the GUID), not the integer ID. + +4. **UDFs in webhooks vs REST API** — The REST API returns UDFs as `udf: { udf1: "...", udf2: "..." }` (nested object, up to 10). Webhooks flatten them to `device_udf1` through `device_udf29` as top-level fields (29 total). + +5. **Alert context varies by type** — always check `alertContext['@class']` to know what fields are available. For PING alerts, fetch `/alert/{uid}` to get `instanceName` (the ping target) since it's not in the bulk alert list response. + +6. **Page size 250** is the effective maximum — don't request more. + +7. **Resolved alerts grow without bound** — never fetch all resolved alerts in production. Limit to recent pages (e.g. 4 pages = ~1000 most recent). + +8. **Site → Company mapping** — `site.autotaskCompanyId` is a string from the API even though it's an integer ID. Always `parseInt()` it and validate `> 0` and `!isNaN()` before using as a FK. + +--- + +## Quick Reference: Alert Priority Values + +- `Critical` +- `High` +- `Moderate` +- `Low` +- `Information` + +## Quick Reference: Common Alert Types + +- `PING` — ping monitor failure +- `DISK` — disk space/health +- `CPU` — CPU utilization +- `MEMORY` — RAM utilization +- `SERVICE` — Windows service down +- `EVENTLOG` — Windows event log match +- `PATCH` — patch management +- `ANTIVIRUS` — AV status + +--- + +## Pipeline Integration + +In Pulse, incoming Datto RMM webhooks can trigger the **pipeline engine** (fire-and-forget): + +```typescript +pipelineEngine.processTrigger('datto_rmm', payload).catch(err => + console.error('[DATTO-RMM-WEBHOOK] Pipeline processing error:', err) +); +``` + +The trigger type `'datto_rmm'` matches pipeline rules configured in the admin UI. Pipelines can take actions like creating Autotask tickets, sending notifications, etc. diff --git a/docs/clista-changes-2026-03-26.md b/docs/clista-changes-2026-03-26.md new file mode 100644 index 0000000..390994a --- /dev/null +++ b/docs/clista-changes-2026-03-26.md @@ -0,0 +1,104 @@ +# Clista Electric — User List Changes Since January 2026 + +_Comparison of "Clista Approved - User List and Classification.xlsx" against Autotask/M365 as of 2026-03-26. Enriched with ticket history._ + +--- + +## New Users Added Since January + +| Name | Email | Added | Classification (from tickets) | +|---|---|---|---| +| **Brett Tokarski** | btokarski@clistaelectric.com | Jan 6 | Likely **BRONZE** — iPad + Bluebeam Complete (estimator/PM profile), no laptop deployed | +| **Joe Glassbrenner** | jglassbrenner@clistaelectric.com | Jan 6 | Likely **EMAIL ONLY** — iPad setup only, no workstation | +| **Daniel Archer** | darcher@clistaelectric.com | Mar 3 | Likely **EMAIL ONLY** — mailbox + Foreman distribution list + iPad; field foreman | + +New device added: **SPRO009** (Jan 15, assigned to Josh Miller — "Activate SPRO009 and install Wulf tools") + +--- + +## Deleted Since January + +- **Joe Laplace** (jlaplace@clistaelectric.com) — removed Jan 6. His laptop (**LT049**) was reassigned to Bryan Detweiler (ticket T20260119.0181). + +--- + +## Users in Autotask NOT on the Spreadsheet + +Ticket history used to determine likely classification: + +| Name | Email | Likely Classification | Evidence | +|---|---|---|---| +| **Bryan Detweiler** | bdetweiler@clistaelectric.com | **BRONZE USER** | Received LT049 (Joe Laplace's repurposed laptop, Jan 13). iPad email setup Oct 2025. | +| **Nicholas Flinko** | nflinko@clistaelectric.com | **BRONZE USER** | Has LT032 (multiple patch/disk/Teams tickets on LT032 under his name). Spreadsheet incorrectly lists LT032 under Jared Boger. | +| **Tanner Lacher** | tlacher@clistaelectric.com | **EMAIL ONLY** | "New iPad and Email Setup Request" Oct 2025 — iPad only, no workstation. | +| **Randy Nocleg** | rnocleg@clistaelectric.com | **EMAIL ONLY** | "Mobile email set up" Jun 2025 — mobile only. | +| **John Pronko** | jpronko@clistaelectric.com | **EMAIL ONLY** | "Duo and Outlook Setup on iPad" Nov 2025 — iPad only. | +| **Bill Shindledecker** | bShindledecker@clistaelectric.com | **EMAIL ONLY** | "Email Setup for iPad" Oct 2025 — iPad only. | +| **Jeff Gatto** | jgatto@clistaelectric.com | **Unknown** | No tickets found. | +| **Rob Gerhart** | rgerhart@clistaelectric.com | **Unknown** | No tickets found. | +| **Mike Jr.** | mikejr@clistaelectric.com | **Likely duplicate** | Only 2 tickets (unusual sign-in alerts, Oct 2025). Likely a legacy/stale account for Mike Clista Jr. (mclistajr@). | +| **safety unknown** | safety@clistaelectric.com | **DEVICE EMAIL or GENERAL** | Generic safety mailbox — no user-specific tickets. | + +--- + +## Flagged REMOVE — Still Have Active Licenses in M365 + +Both are still licensed in the M365 export: + +- **CAD1** — still has Microsoft 365 Business Standard +- **Sam Cocola** — still has Microsoft 365 Basic + +--- + +## Device Reassignments Found in Tickets + +Devices that moved or were reassigned since the spreadsheet was made: + +| Device | Old Assignment (spreadsheet) | New Assignment (from tickets) | Notes | +|---|---|---|---| +| **LT049** | (not on spreadsheet) | Bryan Detweiler | Reassigned from Joe Laplace when he left (Jan 13) | +| **LT074** | (not on spreadsheet) | Mark Blum | Repurposed deployment Mar 4; onboarding check-in Mar 11. **Mark Blum should be reclassified — he was EMAIL ONLY but now has a workstation.** | +| **LT078** | (not on spreadsheet) | Brendon Bittel | Patch alerts Dec 2025. **Bittel was EMAIL ONLY but now has a laptop.** | +| **LT079** | (not on spreadsheet) | Travis Lenhart | Patch failure Mar 2026. Lenhart was EMAIL ONLY with MIX003 (now inactive). **Upgrade to BRONZE.** | +| **LT080** | (not on spreadsheet) | Andrew Holzworth | Docking station ticket Feb 2026. LT040 (his old device) was repurposed for field use Jan 20. | +| **LT076** | (not on spreadsheet) | Roseann March | VPN confirmation ticket Nov 2025. She already had WL-LT004 + DT034; LT076 may be a replacement. | +| **LT077** | (not on spreadsheet) | Roseann March | Patch failure Dec 2025 — second device or replacement for WL-LT004. | +| **LT032** | Jared Boger (EMAIL ONLY) | Nicholas Flinko | Flinko is the contact on all LT032 alerts — Boger classification may be stale. | + +--- + +## Users Whose Classification Should Be Updated + +Based on device deployments found in tickets: + +| Name | Current Classification | Suggested Update | Reason | +|---|---|---|---| +| **Mark Blum** | EMAIL ONLY | **BRONZE USER** | Received workstation LT074 (Mar 2026) | +| **Brendon Bittel** | EMAIL ONLY | **BRONZE USER** | Has laptop LT078 (added Dec 2025) | +| **Travis Lenhart** | EMAIL ONLY | **BRONZE USER** | Has laptop LT079; MIX003 retired | +| **Bryan Detweiler** | Not on list | **BRONZE USER** | Add to list — has LT049 | +| **Jared Boger** | EMAIL ONLY (LT032) | Review — LT032 now under Flinko | Boger may have no device now | + +--- + +## Devices on Spreadsheet Now Inactive in DB + +| Device | Assigned To (per spreadsheet) | Status | Likely Replacement | +|---|---|---|---| +| LT017 | Justin Klosky | Inactive | Unknown | +| LT028 | Anthony Laskey | Inactive | Unknown | +| LT032 | Jared Boger | Inactive | Now under Nicholas Flinko | +| MIX003 | Travis Lenhart | Inactive | LT079 | +| WL-LT004 | Roseann March | Inactive | LT076 or LT077 | +| LT040 | Andrew Holzworth | Repurposed | LT080 — "repurposed for field use" Jan 20 | + +--- + +## Data Quality Issues + +- **Dominic Edwards** — email typo in Autotask: `dedwards@clistaelectric.om` (missing the 'c') +- **Ron Marangoni** — spreadsheet says `marangoni@`, M365 and Autotask both show `rmarangoni@` +- **Sonny Stewart** — spreadsheet lists "Microsoft 365" license but M365 export shows no license assigned +- **Michael Skibinski** — duplicate contact record created Feb 13, 2026 (two records, same email) +- **Dave Warywoda**, **Grant Hoffman**, **Dominic Edwards**, **Donald Maraugha** — on rachel_list but absent from M365 export entirely +- **LT073 and LT075** — active devices with no ticket history found; assignment unknown diff --git a/lib/services/mimecast-client.ts b/lib/services/mimecast-client.ts index c437333..6822ef3 100644 --- a/lib/services/mimecast-client.ts +++ b/lib/services/mimecast-client.ts @@ -73,6 +73,32 @@ export interface MimecastMessageInfo { headers?: Record; } +export interface MimecastHeldMessage { + id: string; + subject: string; + from: string; + fromDisplay: string; + to: string; + toDisplay: string; + dateReceived: string; + reason: string; + reasonCode: string; + policyInfo: string; + route: string; + hasAttachments: boolean; + size: number; +} + +export interface MimecastCloudUser { + emailAddress: string; + domain: string; + lockedOut: boolean; + status?: string; + name?: string; + alias?: string[]; + [key: string]: any; +} + export interface PaginatedResult { items: T[]; nextCursor: string | null; @@ -398,6 +424,87 @@ export class MimecastClient { } } + // ── Cloud Gateway ───────────────────────────────────────────────────────── + + /** + * GET /user/cloud-gateway/v1/users?emailAddress=...&domain=... + */ + async getCloudUser(emailAddress: string, domain: string): Promise { + const data = await this.request('GET', '/user/cloud-gateway/v1/users', undefined, { + emailAddress, + domain, + }); + const user = data?.value?.[0] ?? data?.data?.[0] ?? null; + if (!user) return null; + return { + emailAddress: user.emailAddress ?? emailAddress, + domain: user.domain ?? domain, + lockedOut: user.lockedOut ?? false, + status: user.status ?? undefined, + name: user.name ?? undefined, + alias: user.alias ?? undefined, + _raw: user, + }; + } + + // ── Held Messages ────────────────────────────────────────────────────────── + + /** + * POST /api/gateway/get-hold-message-list + * admin: true = see user-level hold queues as an admin + * pageSize is ignored by the API (always returns 10); paginate via meta.pagination.next + * Fetches ALL pages up to maxMessages limit. + */ + async getHeldMessages(options: { + recipient?: string; + maxMessages?: number; + } = {}): Promise<{ messages: MimecastHeldMessage[]; totalCount: number }> { + const maxMessages = options.maxMessages ?? 500; + const all: MimecastHeldMessage[] = []; + let cursor: string | null = null; + let totalCount = 0; + + do { + const reqBody: any = { admin: true }; + if (options.recipient) { + reqBody.searchBy = { fieldName: 'recipient', value: options.recipient }; + } + + const body: any = { data: [reqBody] }; + if (cursor) { + body.meta = { pagination: { pageToken: cursor } }; + } + + const result = await this.request('POST', '/api/gateway/get-hold-message-list', body); + const pagination = result?.meta?.pagination ?? {}; + const msgs: any[] = result?.data ?? []; + + if (totalCount === 0) totalCount = pagination.totalCount ?? msgs.length; + + for (const m of msgs) { + all.push({ + id: m.id, + subject: m.subject ?? '', + from: m.fromHeader?.emailAddress ?? m.from?.emailAddress ?? '', + fromDisplay: m.fromHeader?.displayableName ?? m.from?.displayableName ?? '', + to: m.to?.emailAddress ?? '', + toDisplay: m.to?.displayableName ?? '', + dateReceived: m.dateReceived ?? '', + reason: m.reason ?? '', + reasonCode: m.reasonCode ?? '', + policyInfo: m.policyInfo ?? '', + route: m.route ?? '', + hasAttachments: m.hasAttachments ?? false, + size: m.size ?? 0, + }); + } + + cursor = pagination.next ?? null; + } while (cursor && all.length < maxMessages); + + return { messages: all, totalCount }; + } + // ── Account ──────────────────────────────────────────────────────────────── /** @@ -436,3 +543,17 @@ export function getMimecastClient(): MimecastClient { } return _client; } + +export function getMimecastClientForTenant(tenant: { + client_id: string; + client_secret: string; + base_url?: string; + account_code?: string; +}): MimecastClient { + return new MimecastClient({ + clientId: tenant.client_id, + clientSecret: tenant.client_secret, + baseUrl: tenant.base_url ?? 'https://api.services.mimecast.com', + accountCode: tenant.account_code ?? '', + }); +} diff --git a/migrations/061_create_recurring_revenue_views.sql b/migrations/061_create_recurring_revenue_views.sql new file mode 100644 index 0000000..ad1586e --- /dev/null +++ b/migrations/061_create_recurring_revenue_views.sql @@ -0,0 +1,49 @@ +-- Views filtering all core Autotask data to CompanyCategory ID 1 (Recurring Revenue Customer) + +-- Base: recurring revenue companies +CREATE OR REPLACE VIEW v_mrr_companies AS +SELECT * +FROM companies +WHERE company_category_id = 1 + AND is_active = true; + +-- Tickets for recurring revenue companies +CREATE OR REPLACE VIEW v_mrr_tickets AS +SELECT t.* +FROM tickets t +INNER JOIN v_mrr_companies c ON c.id = t.company_id +WHERE t.is_deleted = false; + +-- Contacts for recurring revenue companies +CREATE OR REPLACE VIEW v_mrr_contacts AS +SELECT ct.* +FROM contacts ct +INNER JOIN v_mrr_companies c ON c.id = ct.company_id +WHERE ct.is_deleted = false; + +-- Contracts for recurring revenue companies +CREATE OR REPLACE VIEW v_mrr_contracts AS +SELECT cn.* +FROM contracts cn +INNER JOIN v_mrr_companies c ON c.id = cn.company_id +WHERE cn.is_deleted = false; + +-- Configuration items for recurring revenue companies +CREATE OR REPLACE VIEW v_mrr_configuration_items AS +SELECT ci.* +FROM configuration_items ci +INNER JOIN v_mrr_companies c ON c.id = ci.company_id +WHERE ci.is_deleted = false; + +-- Time entries for recurring revenue companies (via ticket) +CREATE OR REPLACE VIEW v_mrr_time_entries AS +SELECT te.* +FROM time_entries te +INNER JOIN v_mrr_tickets t ON t.id = te.ticket_id; + +-- Billing items for recurring revenue companies +CREATE OR REPLACE VIEW v_mrr_billing_items AS +SELECT bi.* +FROM billing_items bi +INNER JOIN v_mrr_companies c ON c.id = bi.company_id +WHERE bi.is_deleted = false; diff --git a/migrations/062_create_mimecast_tenants.sql b/migrations/062_create_mimecast_tenants.sql new file mode 100644 index 0000000..3468747 --- /dev/null +++ b/migrations/062_create_mimecast_tenants.sql @@ -0,0 +1,19 @@ +-- Migration 062: Mimecast multi-tenant credentials +-- Stores per-client Mimecast API credentials for held mail and other per-tenant queries + +CREATE TABLE IF NOT EXISTS mimecast_tenants ( + id SERIAL PRIMARY KEY, + company_id BIGINT REFERENCES companies(id) ON DELETE SET NULL, + account_code VARCHAR(50), + account_name VARCHAR(255), + client_id VARCHAR(255) NOT NULL, + client_secret VARCHAR(255) NOT NULL, + base_url VARCHAR(255) DEFAULT 'https://api.services.mimecast.com', + enabled BOOLEAN DEFAULT true, + notes TEXT, + created_at TIMESTAMP WITHOUT TIME ZONE DEFAULT NOW(), + updated_at TIMESTAMP WITHOUT TIME ZONE DEFAULT NOW() +); + +CREATE INDEX IF NOT EXISTS idx_mimecast_tenants_company ON mimecast_tenants(company_id); +CREATE INDEX IF NOT EXISTS idx_mimecast_tenants_enabled ON mimecast_tenants(enabled); diff --git a/scripts/test-duo.mjs b/scripts/test-duo.mjs new file mode 100644 index 0000000..efb6eb7 --- /dev/null +++ b/scripts/test-duo.mjs @@ -0,0 +1,131 @@ +/** + * Quick connectivity test for both Duo API integrations. + * Calls a lightweight read endpoint on each: + * Accounts API → GET /admin/v1/accounts (lists child accounts) + * Admin API → GET /admin/v1/info/summary (tenant summary stats) + * + * Duo auth: HMAC-SHA1 signed "Authorization: Basic " header + * https://duo.com/docs/adminapi#authentication + */ + +import crypto from 'crypto'; +import https from 'https'; + +// ── credentials from .env.local ────────────────────────────────────────────── +const ACCOUNTS = { + ikey: process.env.DUOACCOUNTS_INTEGRATION_KEY, + skey: process.env.DUOACCOUNTS_SECRET_KEY, + host: process.env.DUOACCOUNTS_API_HOSTNAME, +}; +const ADMIN = { + ikey: process.env.DUOADMIN_INTEGRATION_KEY, + skey: process.env.DUOADMIN_SECRET_KEY, + host: process.env.DUOADMIN_API_HOSTNAME, +}; + +// ── Duo HMAC signer ─────────────────────────────────────────────────────────── +function duoSign(ikey, skey, host, method, path, params = {}) { + const date = new Date().toUTCString(); + const sortedParams = Object.keys(params) + .sort() + .map(k => `${encodeURIComponent(k)}=${encodeURIComponent(params[k])}`) + .join('&'); + + const canon = [date, method.toUpperCase(), host.toLowerCase(), path, sortedParams].join('\n'); + const sig = crypto.createHmac('sha1', skey).update(canon).digest('hex'); + const auth = Buffer.from(`${ikey}:${sig}`).toString('base64'); + + return { date, auth: `Basic ${auth}`, query: sortedParams }; +} + +// ── generic HTTPS GET ───────────────────────────────────────────────────────── +function duoGet(creds, path, params = {}) { + return new Promise((resolve, reject) => { + const { date, auth, query } = duoSign(creds.ikey, creds.skey, creds.host, 'GET', path, params); + const url = `https://${creds.host}${path}${query ? '?' + query : ''}`; + + const req = https.get(url, { + headers: { Authorization: auth, Date: date, 'Content-Type': 'application/json' }, + }, res => { + let body = ''; + res.on('data', d => body += d); + res.on('end', () => { + try { resolve({ status: res.statusCode, data: JSON.parse(body) }); } + catch { resolve({ status: res.statusCode, data: body }); } + }); + }); + req.on('error', reject); + req.setTimeout(10000, () => { req.destroy(); reject(new Error('Timeout')); }); + }); +} + +// ── run tests ──────────────────────────────────────────────────────────────── +async function main() { + console.log('=== Duo API Connectivity Test ===\n'); + + // Validate env + for (const [name, val] of Object.entries({ ...ACCOUNTS, ...ADMIN })) { + if (!val) { console.error(`Missing env var for key: ${name}`); process.exit(1); } + } + + // 1. Accounts API — POST /accounts/v1/account/list (all Accounts API endpoints use POST) + console.log('── Accounts API ────────────────────────────────'); + console.log(`Host : ${ACCOUNTS.host}`); + console.log(`IKey : ${ACCOUNTS.ikey}`); + try { + const r = await duoPost(ACCOUNTS, '/accounts/v1/account/list'); + console.log(`HTTP : ${r.status}`); + if (r.status === 200) { + const accounts = r.data?.response ?? []; + console.log(`✓ OK — ${accounts.length} child account(s) returned`); + accounts.slice(0, 5).forEach(a => console.log(` · ${a.name} (${a.account_id}) — ${a.api_hostname}`)); + } else { + console.log(`✗ Response:`, JSON.stringify(r.data, null, 2)); + } + } catch (e) { + console.log(`✗ Error: ${e.message}`); + } + + console.log(); + + // 2. Admin API — GET /admin/v1/info/summary + console.log('── Admin API ───────────────────────────────────'); + console.log(`Host : ${ADMIN.host}`); + console.log(`IKey : ${ADMIN.ikey}`); + try { + const r = await duoGet(ADMIN, '/admin/v1/info/summary'); + console.log(`HTTP : ${r.status}`); + if (r.status === 200) { + const s = r.data?.response ?? {}; + console.log('✓ OK — Summary:'); + console.log(` Users : ${s.user_count ?? 'n/a'}`); + console.log(` Integrations : ${s.integration_count ?? 'n/a'}`); + console.log(` Phones : ${s.telephony_credits_remaining ?? 'n/a'} credits remaining`); + } else { + console.log(`✗ Response:`, JSON.stringify(r.data, null, 2)); + } + } catch (e) { + console.log(`✗ Error: ${e.message}`); + } + + // 3. Admin API — GET /admin/v1/users (first page, limit 5) + console.log(); + console.log('── Admin API — Users (first 5) ─────────────────'); + try { + const r = await duoGet(ADMIN, '/admin/v1/users', { limit: '5', offset: '0' }); + console.log(`HTTP : ${r.status}`); + if (r.status === 200) { + const users = r.data?.response ?? []; + console.log(`✓ OK — ${users.length} user(s) in page`); + users.forEach(u => console.log(` · ${u.username} — ${u.status} — ${u.email ?? '(no email)'}`)); + } else { + console.log(`✗ Response:`, JSON.stringify(r.data, null, 2)); + } + } catch (e) { + console.log(`✗ Error: ${e.message}`); + } + + console.log('\n=== Done ==='); +} + +main();