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.
In this article:
Getting access to Webhooks
Access to Webhooks will be granted once your organization has gained access to Social Media Management APIs. Please visit our guide on accessing Social Media Management's APIs to complete this step.
When your organization has gained access to APIs, the options mentioned in the steps below will become available.
Tip:
Still not seeing the option to subscribe to Webhooks as described below? If you have 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:
- In the lower-left corner of Social Media Management, click the Manage settings (cog) icon, then select Organization admin.
- From the left-hand navigation sidebar, select Integration marketplace.
- Select the Webhooks tab. Under Falcon.io 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. Click either Create New Webhook or New Subscription to generate a new Webhook.
- 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. Click Save & Continue to proceed.
- Enter an optional Webhook name and description. Click Save & Continue to proceed.
- 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.