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

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 Set up Social Insights for Salesforce
  3. Salesforce Insights Data and Reports
  4. How to Set up Data Sync for Salesforce
  5. How to Set Up The Social Advocacy Package 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 Mautic Integration
  10. How to Set Up the Bitly Integration
  11. How to Set Up the Feedly Integration
  12. How to Set Up the Act-On Integration
  13. Feedly Custom Sharing with Oktopost
  14. Act-On Integration: Segmenting Lists Using Social Data
  15. Act-On Integration: Social Lead Scoring
  16. Conversion Tracking With Marketo Forms 2.0
  17. Marketo Integration: Lead Segmentation
  18. Marketo Integration: Interesting Social Moments
  19. How to Set Up the Salesfusion Integration
  20. How to Set Up the Pardot Integration
  21. Setting up the Google Analytics integration
  22. How to Set Up the Facebook Retargeting Integration
  23. How to Create a Facebook Audience Based on Social Behavior
  24. Attributing Social to Leads in Marketo
  25. Webhooks
  26. How to Connect Oktopost to Zapier
  27. How to Create Salesforce Cases From Assignments
  28. Setting up Integration Assets
  29. Social Click URLs
  30. Salesforce Campaign Naming Parameters Guide
  31. How to Track Conversion on HubSpot Embedded Forms
  32. How to Track Conversion on Pardot Forms
  33. How to Track Conversions on Act-On Labs Forms
  34. How to Set Up Single Sign-on With AD FS
  35. How to Set Up Single Sign-on With Okta
  36. How to Set Up Single Sign-on With OneLogin
  37. How to Set Up Single Sign-on With Google Apps
  38. How to Set Up The Facebook Lead Ads Integration

Feedback and Knowledge Base