Skip to main content

Create Subscription

POST 
/eventsubscriptions

Create an event subscription. Topic subscription can be a single event (Ex: threesixty.created) or a wildcard list of events using the * (star) notation to denote 'everything' (Ex:threesixty.\* will subscribe to all 360 events from Qualtrics.)

Complete Example

For a complete example showing how to subscribe to and then listen for events look here.

Administrator Request

To use this call you must be a Qualtrics brand administrator

Publication URL

This is a REST endpoint that would be set up on your end. We will ping that URL with a POST request.

Note

The publicationUrl must be able to handle HTTP GET/POST. It will be receiving x-www-form-urlencoded data not JSON. You can do that different ways, like using the Python object BaseHTTPRequestHandler and HTTPServer when you stand up your web listener.

Use Message Body to Generate HMAC Signature

Generate the HMAC signature from the message body and compare it with the HMAC in the event message. Both must be equal. Some languages have a library to generate the signature. For example, in Typescript you can use the built-in crypto module

Request​

Responses​

A successful create event subscription response