Help Center

| Submit or View Help Requests | Developer Docs |

View desktop instructions
View mobile app instructions
Enable Action Inquiry Event Notification Postbacks as a Partner

If you want to receive real-time notifications whenever action inquiries are created or resolved, you can set up an event notifications. For more information on what event notifications are and how action inquiry postbacks work, and more, see Action Inquiry Event Notification Postbacks FAQ for Partners.

Set up action inquiry postbacks

This feature is only accessible to specific editions or add-ons. Contact us to upgrade your account and get access!

Action inquiry postbacks update you whenever an action inquiry is opened or closed by an account user in your account. To set up action inquiry postbacks:

  1. From the left navigation bar, select ellipsis-v-solid.svg [Menu] → Settings.

    • Alternatively for Creator accounts, in the upper-right corner of the page, select user-circle-solid.svg [User Profile]Settings.

  2. Under Technical, select Event Notifications.

  3. Hover over the Action Inquiry Events field and select pencil-alt-solid.svg [Edit].

  4. Enter your server's URL. This is the URL to which will send postbacks.

  5. Select your preferred HTTP method.

    • If you select Post, you will need to enter the body of the request. Below is an example of how you might want to map each data point for a JSON format. The keys in each key-value pair should be sourced from your own system’s setup, and the values will be your chosen coinciding data point that provides and should be entered in curly brackets { }.

    • View some of's available body parameters.

    • Don't see a value you need? Reach out to your Publisher Account Manager (or contact support).

  6. Select the Body Format that matches your setup in Step 5.

  7. Select Action Inquiry Events arrow-down-solid.svg These settings are optional.

    • Enter an HTTP Header as a way to pass additional information between you and the server.

    • Enter a Minimum Delay between when an event happens and when the postback is generated and sent to your system.

    • Enter a rate limit for the Maximum Requests can make to your system per second.

    • Enter what you want the Success Response to a postback to be.

    • Enter what you want the Error Response to a postback to be.

  8. Select Save.

Now that you have action inquiry postbacks set up, your system should begin receiving postbacks whenever an inquiry is created by your account or resolved by a partnered brand. To learn how to test your new postback setup, view the Test an action inquiry postback section below.

Test an action inquiry postback

Once you set up action inquiry postbacks, you should test your setup. Make sure you notify your partnered brand that you'll be testing your postback setup.

  1. From the top navigation menu, select Content → Assets.

  2. Select an asset, then in the slide-out, select Get Tracking Link. Ensure that there are values in the Sub ID and Shared ID fields:

    • toggle-on-solid.svg [Toggle on] Tracking Parameters, enter at least one word in each Sub ID and Shared ID field, then select Save.

  3. Select Copy Tracking Link.

  4. Paste the link into a fresh browser window and search.

  5. Complete the action.

    • This action will ultimately be reversed.

  6. After about 15 minutes, find the action on the Pending Actions screen. You'll need some pieces of information to generate an action inquiry in-app:

    • The brand associated with your test action.

    • The action's Order ID.

    • The action's Sale Amount.

    • The action's Transaction Date.

  7. Create a new action inquiry in In the Notes section, mention this is a test inquiry.

    • Learn how to create an inquiry via the UI.

    • After doing so, you should receive a postback letting you know an action inquiry was created. If you see the new inquiry on the Inquiries screen but have not received a postback yet, double-check your postback setup.

  8. Provide your partnered brand with the Order ID associated with the inquiry and ask them to Decline the inquiry.

    • When the brand declines the inquiry, you should receive another postback informing you of the inquiry's resolution. If you see the inquiry update on the Inquiries screen but have not received a postback yet, double-check your postback setup.

Warning: If you cannot find any issues with your postback setup but are still not receiving postbacks, contact support. We can check if postbacks are being generated, what the response code for them is, as well as the body for each postback. This information might help you successfully debug your setup.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.