Webhooks allow you to build or set up integrations that subscribe to events in Oktopost. By subscribing to a webhook, Oktopost will send data to your custom URL every time an event happens.

Create a Webhook

To create a webhook go to Account Settings → Webhooks and click on New Webhook. Each webhook has the following properties:

Property Description
Name The webhook name
Description The webhook description
Event The Oktopost event that will trigger this webhook
URL The URL you use to submit data to
Secret An auto-generated field, used for validating requests

Note that Oktopost sends ALL webhook events using HTTP POST.

Supported Events

Oktopost supports the following events:

Inbox Events

  • A new note is added to a conversation
  • A new conversation is available in your inbox
  • A new comment or reply are available on existing conversation
  • A conversation is assigned to a new user
  • A conversation status is updated

People Database Events

  • A social conversion is captured
  • A new lead is captured
  • A new social activity is detected

Board Events

  • A new message is added to the board
  • A new topic is added to the board

Publishing Events

  • A new campaign is created
  • A post is sent to social media
  • A new post is created
  • A scheduled post is updated
  • A scheduled post is deleted

Approval Workflow Events

  • A post or message is sent to the approval workflow
  • A post or message is approved
  • A post or message is rejected

The data sent with each event includes an array of JSON objects. For example, A new message is added to the board will include the message and the boards' metadata. With that, you may want to use the REST API to retrieve additional information about related objects.

Secure Connection

To secure your endpoint you may wish to validate that it's actually receiving data from Oktopost and not from other, potentially malicious sources.

To validate the request simply generate an HMACSHA1 hash from the Secret field and the raw payload (JSON string) received from the webhook (secret + payload) and compare it with the X-Oktopost-Secret HTTP header.

Handling Responses

Response Headers

Each response will contain the following HTTP headers.

Header Description
X-Oktopost-Secret Secret to compare the payload with
X-Oktopost-Webhook The webhook Id
X-Oktopost-Payload A list of comma-separated payload Ids

Successful Responses

For each successful response, your endpoint should return a 2xx HTTP response code.

Failed Responses

If your endpoint fails to process the data it should respond with a 4xx or 5xx HTTP response code. In this case, Oktopost will attempt to resend the data in 10-minute intervals for up to 5 additional attempts.

If the issue will take longer to fix, you can deactivate the webhook and Oktopost will resend the data when the webhook is reactivated.

Request Log

To examine which requests were sent to your endpoint, you can view the request log by clicking on the date under the Last Run column in the webhooks table. If no value is available it means that Oktopost never sent data to your endpoint.


  1. How to Set Up The Marketo Integration
  2. How to Install Social Insights for Salesforce
  3. Salesforce Social Insights Data and Reports
  4. How to Install Social Analytics for Salesforce
  5. How to Install Social Advocacy For Salesforce
  6. How to Set Up The Eloqua Integration
  7. How to Set Up the HubSpot Integration
  8. How to Set Up The Salesforce Integration
  9. How to Set up The Microsoft Dynamics Integration
  10. Microsoft Dynamics Social Activity Entity
  11. Oktopost Solution Package for Microsoft Dynamics
  12. How to Set Up The Mautic Integration
  13. How to Set Up the Bitly Integration
  14. How to Set Up the Feedly Integration
  15. How to Set Up the Act-On Integration
  16. Feedly Custom Sharing with Oktopost
  17. Act-On Integration: Segmenting Lists Using Social Data
  18. Act-On Integration: Social Lead Scoring
  19. Conversion Tracking With Marketo Forms 2.0
  20. Marketo Integration: Lead Segmentation
  21. Marketo Integration: Interesting Social Moments
  22. How to Set Up the Salesfusion Integration
  23. How to Set Up the Pardot Integration
  24. Setting up the Google Analytics integration
  25. How to Set Up the Facebook Retargeting Integration
  26. How to Create a Facebook Audience Based on Social Behavior
  27. Attributing Social to Leads in Marketo
  28. Webhooks
  29. How to Connect Oktopost to Zapier
  30. How to Create Salesforce Cases From Assignments
  31. Setting up Integration Assets
  32. Social Click URLs
  33. Salesforce Campaign Naming Parameters
  34. How to Track Conversion on HubSpot Embedded Forms
  35. How to Track Conversion on Pardot Forms
  36. How to Track Conversions on Act-On Labs Forms
  37. How to Set Up Single Sign-on With AD FS
  38. How to Set Up Single Sign-on With Okta
  39. How to Set Up Single Sign-on With OneLogin
  40. How to Set Up Single Sign-on With Google Apps
  41. How to Set up Single Sign-on With Azure Active Directory (AAD)
  42. How to Set Up The Facebook Lead Ads Integration
  43. Zapier Use Cases
  44. How to Set up Oktopost for Bizible
  45. How to Format Dates in Salesforce Template Fields
  46. Social Attribution Parameters
  47. Lead Parameters
  48. How to Update an Existing Social Insights Installation

Feedback and Knowledge Base