Webhooks allow you to build or set up integrations that subscribe to events in Oktopost. Webhooks will push data every time a certain event happens to a custom URL. For detailed instructions on how to use webhooks, please read the following article.

Create a Webhook

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

Property Description
Name The webhook name
Description A short description of the webhooks' function
Event The Oktopost event that will trigger this webhook
URL The URL you use to submit data to
Secret Auto-generated. Used for validating requests

Once set up, Oktopost will send data to your URL via HTTP POST request every time an event happens.

Supported Events

Oktopost currently supports the following events:

  • New conversion
  • New assignment
  • New note on existing assignment
  • Assignment status changes
  • New message is added to the board
  • New item is added to the inbox
  • Inbox item is udpated

The data sent for each events will include an array of JSON formatted objects that describe the related event. For example: New message on the board will include the message and the boards' meta data. With that, you may need to use the REST API to retrieve additional information about Oktopost 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 a 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.com
  3. How to Set up Data Sync for Salesforce.com
  4. How to Set Up The Eloqua Integration
  5. How to Set Up the HubSpot Integration
  6. How to Set Up The Salesforce Integration
  7. How to Find the Security Token in Salesforce.com
  8. How to Set Up the Bitly Integration
  9. How to Set Up the Feedly Integration
  10. How to Set Up the Act-On Integration
  11. Feedly Custom Sharing with Oktopost
  12. Act-On Integration: Segmenting Lists Using Social Data
  13. Act-On Integration: Social Lead Scoring
  14. Marketo Integration: Social Lead Scoring
  15. Conversion Tracking With Marketo Forms 2.0
  16. Marketo Integration: Lead Segmentation
  17. Marketo Integration: Interesting Social Moments
  18. How to Set Up the Salesfusion Integration
  19. How to Set Up the Pardot Integration
  20. Setting up the Google Analytics integration
  21. How to Set Up the Facebook Retargeting Integration
  22. How to Create a Facebook Audience Based on Social Behavior
  23. Attributing Social to Leads in Marketo
  24. How to Set up the AdRoll Integration
  25. Webhooks
  26. How to Connect Oktopost to Zapier
  27. Oktopost Tracking with Google Tag Manager
  28. How to Create Salesforce Cases From Assignments
  29. Setting up Integration Assets
  30. Social Click URLs
  31. Salesforce Campaign Naming Parameters Guide
  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 The Facebook Lead Ads Integration

Feedback and Knowledge Base