🪝Webhooks

You can set up an Octolens Webhook to send mention notifications to other apps.

How to create a webhook

You can turn any view in your feed into a webhook notification. Here’s how:

1. Choose which view you want to send as a webhook

You can do this by clicking "Enable as notification" in the top-right.

Or hover over a view in the sidebar, click the three dots, and select "Enable notification."

1. Toggle on webhook

Once you have chosen your view, select "Webhook" in Step 2: Destination and Frequency.

1. Add the webhook URL and choose a frequency

2. Test your webhook to confirm it works

Example Payload

Here is an example of one of our webhook payloads. The action event can be either "mention_created" or "mention_updated".

{
  "action": "mention_created",
  "data": {
    "title": "title",
    "body": "post body text.",
    "url": "https://posturl",
    "timestamp": "2024-12-04T13:55:32.000Z",
    "imageUrl": "imageurl",
    "author": "author",
    "authorProfileLink": "https://platform.com/author",
    "source": "platform",
    "sourceId": "111111111",
    "relevanceScore": "0",
    "relevanceComment": "User is suggesting a feature that could enhance Octolens.",
    "keyword": "Octolens",
    "sentimentLabel": "Neutral",
    "subreddit": "r/subreddit", -> only if reddit
    "viewId": "111",
    "viewName": "View name"
  }
}

Example use cases for webhooks

1. Send Discord notifications for new (platform) mentions

2. Automatically add (platform) mentions to a Notion database

3. Add new (platform) mentions to Google Sheets

4. Automatically add (platform) mentions to Airtable

5. Capture new (platform) mentions as HubSpot CRM contacts

6. Create Asana tasks from (platform) mentions

7. Turn (platform) mentions into ClickUp tasks

8. Automatically receive email alerts for new (platform) mentions

9. Automatically create Intercom tickets from (platform) mentions

10. Generate Monday.com tasks from (platform) mentions

11. Create Linear issues for new (platform) mentions

12. Create new leads in Pipedrive from (platform) mentions

13. Create new Salesforce leads for new (platform) mentions

14. Automatically add (platform) mentions to Zoho CRM

15. Create Todoist tasks instantly from (platform) mentions

16. Create Trello cards for new (platform) mentions

17. Send Microsoft Teams messages for new (platform) mentions