🪝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" top right.

Or you can also hover over a view in the side bar, click the three dots, and select "Enable notification."

1. Toggle on webhook

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

1. Add in webhook URL & Choose desired frequency

1. Test your webhook to see if 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"
  }
}

What are some example use cases for webhooks

1. Send Discord notifications for new (platform) mention

2. Automatically Add (platform) mentions to notion database

3. Add new (Platform) Mentions in 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 Issue for new (platform) mention

12. Create New Leads in Pipedrive from (Platform) Mentions

13. Create New Salesforce Lead for new (platform) mention

14. Automatically Add (Platform) Mentions to Zoho CRM

15. Create Todoist Tasks Instantly from (Platform) Mentions

16. Create trello card for new (platform) mention

17. Send Microsoft Teams message for new (platform) mention