Subscribing to Social Media Management Webhooks

Using Social Media Management Webhooks, you can subscribe to receive Social Media Management data on third-party integrations in real time. Webhooks allow you to get updates on your Social Media Management Organization’s activities in Publish, such as when new campaigns, posts, drafts, or stock items are created and much more.

In this article, find out how to get access to Webhooks, how to view, edit, and subscribe to Webhooks, and what Webhook topics are available.

Note:

Only users with a user role of Admin or Team Leader can view, edit, and subscribe to Webhooks in Social Media Management. The options mentioned in this article will not be available to users with any other user role.


Getting access to Webhooks

Access to Webhooks will be granted once your organization has signed and gained access to Social Media Management APIs. If you have not yet gained access to Social Media Management APIs, please follow the complete guide on our Help Center here.

When your organization has gained access to APIs, the options mentioned in the Webhook subscription guide below will become available.

Tip:

Still not seeing the option to subscribe to Webhooks as described below? If you have signed and gained access to Social Media Management APIs already, please contact your Social Media Management Account Manager for help resolving the issue.


Subscribing to Webhooks

Once your organization has been granted access to Social Media Management Webhooks, any Admin user can begin subscribing to new Webhooks by following the steps below:

  1. In the lower-left corner of Social Media Management, click the Manage settings (cog) icon, then select Organization admin.Screenshot 2023-09-22 at 3.29.26 PM.png
  2. From the left-hand navigation sidebar, select Integrations & API.Screenshot 2023-09-22 at 4.52.48 PM.png
  3. Select Webhooks.
  4. Under Webhook Services, your Secret will be displayed. Your third party or application developer must use this secret to generate the correct HTTP response during our automated verification process.
  5. Next, click either Create New Webhook or New Subscription (if Webhooks have already been created).mceclip0.png
  6. Enter a secure destination URL. The destination URL defines where the information will be sent. The URL should be generated either by you or the third party receiving the Webhook data.blobid1__1_.png
  7. Click Save & Continue.
  8. Enter name and description. The description is optional.blobid2.png
  9. Click Save & Continue.
  10. To verify, click Verify & Save.

By default, when the new Webhook subscription has been verified and saved, no Webhook topics will be selected yet. Follow the steps below to edit your subscription and choose the topics for which you would like to receive data.


Editing and deleting webhooks

At any time, you can edit or delete Webhooks from the Webhooks menu.

Under Webhook subscriptions, locate your Webhook and click either Edit or the Trash icon on the far right.

When editing the webhook, you can add or remove Webhook topics by checking/unchecking the Subscribed box on the right of each topic.


What Webhook topics are available?

There are four Webhook topics available. By editing each Webhook subscription, you can select/deselect any number of topics. Below, you can find out what notifications you can expect from each Webhook topic:

Publish Campaigns
Notifications will arrive when Campaigns are created, edited, or deleted. You will also receive a notification when Campaign attachments, labels, or reminders are added or deleted.
Publish Publication (Posts)
Notifications will arrive when existing (published) posts are deleted, archived, or copied.
Publish Publishing (Draft)
Notifications will arrive when drafts are created, updated, archived, deleted, submitted for approved, scheduled, unscheduled, published, manually published (for example, without being scheduled), and copied.
Publish Publishing Template (Stock)
Notifications will arrive when stock items in the Content Pool are created, updated, archived, and copied.

Was this article helpful?
0 out of 0 found this helpful
Brandwatch Academy

The Brandwatch Academy is here

Access on-demand courses on the Brandwatch product suite, plus live events to enrich your knowledge.