<!--
{
  "availability" : [
    "App Store Server API: 1.5.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppStoreServerAPI",
  "identifier" : "/documentation/AppStoreServerAPI/Request-a-Test-Notification",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "App Store Server API"
    ],
    "preciseIdentifier" : "rest:app_store_server_api:post:v1-notifications-test"
  },
  "title" : "Request a Test Notification"
}
-->

# Request a Test Notification

Ask App Store Server Notifications to send a test notification to your server.

## Discussion

Use this endpoint to test if your server is receiving <doc://com.apple.documentation/documentation/AppStoreServerNotifications> at the URLs that you configured in App Store Connect. The [`Request a Test Notification`](/documentation/AppStoreServerAPI/Request-a-Test-Notification) endpoint prompts the App Store server to send your server a notification with the `TEST` [`notificationType`](/documentation/AppStoreServerAPI/notificationType). The App Store server sends the `TEST` notification to your production URL if you call this endpoint’s production URL; it sends it to your sandbox URL if you call this endpoint’s sandbox URL.

Although `TEST` is a version 2 notification, you can call this endpoint regardless of whether you configured your App Store Server Notifications URL in App Store Connect for version 1 or version 2. For more information about the configuration and enabling notifications, see [Enter a URL for App Store server notifications](https://help.apple.com/app-store-connect/#/dev0067a330b) and <doc://com.apple.documentation/documentation/AppStoreServerNotifications/enabling-app-store-server-notifications>.

This endpoint responds with a `testNotificationToken` in [`SendTestNotificationResponse`](/documentation/AppStoreServerAPI/SendTestNotificationResponse). To learn the result that the App Store server recorded when it attempted to send your server the `TEST` notification, call the [`Get Test Notification Status`](/documentation/AppStoreServerAPI/Get-Test-Notification-Status) endpoint with the `testNotificationToken`. Use the status information to troubleshoot your server if it’s unable to receive the `TEST` notification.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)