Confirming the Subscription

Overview

Before your HTTPS endpoint can receive update notifications, AWS SNS requires a one-time subscription confirmation handshake. When TrustArc staff register your endpoint with the SNS Topic, your application will receive a confirmation message and must respond to complete the subscription.

What you need to do

✓Detect the SubscriptionConfirmation message type when it arrives at your endpoint

✓Make a GET request to the SubscribeURL in the message to confirm the subscription

Confirmation Steps

1

When TrustArc staff create the subscription using your HTTPS endpoint, your endpoint will receive a message with "Type": "SubscriptionConfirmation". This is a one-time handshake from AWS SNS — it is not an update notification.

2

Your application must make a GET request to the URL provided in the SubscribeURL field of the message.

3

AWS SNS returns a 200 OK response, confirming the subscription is active. Your endpoint will now begin receiving Data Inventory update notifications.

📋 Tip: Your endpoint should inspect the Type field of every incoming message before processing it. Route SubscriptionConfirmation messages to the confirmation handler and Notification messages to your update handler.

TrustArc  ·  Hub API — Subscription Confirmation  ·  support.trustarc.com