PureSpectrum
PureSpectrum websiteHelp center
PureSpectrum websiteHelp center
  1. Guides
  • Intro
  • API Overview
  • Definitions
  • Survey Lifecycle
  • Create Your First Survey
  • Redirect URLs
  • Changelog
  • HTTP Status Codes
  • General Reference Codes
    • Survey Status Codes
    • Respondent Status Codes
    • Survey Category Codes
    • Age Unit Codes
    • Currency Codes
    • Survey Localization Codes
  • Guides
    • Getting Started
    • Create Survey Examples
    • Multi-Country Surveys
    • Children Age & Gender
    • Append Respondent Demographics to the Survey Entry Link
    • Test Survey Flow
    • Supplier Blends & Groups
    • Respondent Exclusion / Recontact
    • Survey Exclusion Group
    • Quotas on Clicks
    • Field Evenly Over Time (FEOT)
    • Quota Based Pricing (QBP)
    • Quota Level Complete (QLC)
    • Quota Throttling
    • Templates
    • Bypassing Automatic Variable Mapping
    • Research Defender's Predupe
    • Subscriber Emails
    • Real-Time Notifications (SNS)
  • API Reference
  • Schemas
    • Feasibility
      • Feasibility request schema
      • Feasibility response schema
    • Surveys
      • Create survey full request schema
      • Create survey minimum request schema
      • Create survey response schema
      • Update survey status request schema
      • Update survey status response schema
      • Get survey status response
    • Qualifications
      • Qualification Schema
      • Create qualification request schema
    • Quotas
      • Quota Schema
      • Create quota request schema
      • Create quota response schema
    • Attributes
      • Get attributes response
    • Supplier management
      • Supplier
      • List of all suppliers response
      • List of all suppliers per survey response
      • Update the list of suppliers for a Survey request
      • Update the list of suppliers for a Survey response
    • Other
      • Generic error response
  1. Guides

Real-Time Notifications (SNS)

This functionality requires an additional step to activate SNS communication in MarketPlace. Please get in touch with your PureSpectrum representative to enable and use this feature.
Before activating, make sure you have a Webhook URL. Please share the URL with your PS representative.
When PureSpectrum sets up your webhook in the notification service you will receive a payload asking to confirm your subscription.
image.png
To confirm your subscription you must visit the SubscribeURL. The confirmation response will look like the following:
image.png
After you confirm your subscription you will be able to receive events like the following:
image.png
The event is delivered as a raw string message that you can parse to JSON and extract the information.
The events are stored in PureSpectrum system for 7 days.
You can use the endpoint Get events to query the events.

Webhook Subscription Notifications in Event API Response#

AUTO CLOSE Automation Cases:
The survey is automatically closed if it remains paused for more than 10 days, preventing it from being set live.
The survey is automatically closed due to inactivity for over 10 days.
The survey is automatically closed if it records 0 completes within 3 days of launch.
FMA Auto Paused Automation Cases:
FMA Auto Paused: The survey is automatically paused if there are 0 valid starts in the last 24 hours.
FMA Auto Paused: The survey is automatically paused if no completes are recorded in the last 72 hours.
FMA Near Quota Complete: The traffic channel-specific audience survey is auto-launched when the current target for any quota is less than 10.
FMA Auto Paused: The survey is automatically paused because Earnings Per Click (EPC) fell below the minimum threshold.
FMA Auto Paused: The survey is automatically paused because the Cost Per Interview (CPI) fell below the minimum threshold.
FMA Auto Paused: The survey is automatically paused because the Price Per Minute fell below the minimum threshold.
Soft Launch:
The survey is automatically paused upon completion of the soft launch phase.
The survey is automatically paused after meeting the defined threshold in the soft launch.
Goal Achieved:
The survey is automatically paused after successfully achieving its goal.
Auto Invoice:
The survey is auto invoiced.
Modified at 2025-09-10 13:27:53
Previous
Subscriber Emails
Next
API Reference