Create Incoming Webhooks in Shorter Loop

What is an Inbound Webhook?

An Inbound Webhook allows external applications and services (like Jira, Make.com, or Zapier) to send real-time data or trigger actions into Shorter Loop.

For example, when an issue is updated in an external bug tracker, an inbound webhook can notify Shorter Loop to automatically update the corresponding backlog work item, keeping everything seamlessly synced.

Creating an Inbound Webhook

1. Navigate to Integrations

Navigate to: Products > Integrations > Webhooks

Note: Only Super Admins have access to manage Webhooks. Please contact your workspace administrator if you don't see this option.

2. Create the Webhook

Click the "Create Webhook" button.

In the popup dialog, ensure the webhook direction is set to Inbound.

Enter a clear, identifiable Name for the webhook (e.g., "Jira Status Sync").

(Notice that you do not need to provide a Base URL, as Shorter Loop will be the one receiving the data).

Click Create.

Using Your Inbound Webhook URL

Once the webhook is created, Shorter Loop will generate a unique endpoint URL for you.

Locate your newly created inbound webhook in the list.

You will see a secure Webhook URL.

Click the "Copy" icon next to it.

Go to your external application (e.g., Jira Webhooks configuration) and paste this URL as the destination endpoint for their outgoing events.

Payload format for Epic

{
  "summary": "Enhance User Engagement and Retention",
  "description": "<p>Improve user engagement and retention metrics.</p>",
  "progress": "in-progress",
  "color": "#ffb64f",
  "businessGoal": "Increase MAUs by 20% within the next fiscal year.",
  "teamId": 587,
  "userId": [],
  "startDate": "2024-06-30T18:30:00.000Z",
  "endDate": "2024-07-30T18:30:00.000Z",
  "tags": "[\"Epic\",\"User engagement\"]",
  "urls": [
    {
      "url": "https://example.com"
    }
  ],
  "estimate": "60",
  "businessValue": "100"
}

Payload format for Feature

{
  "summary": "Enhance User Engagement and Retention",
  "description": "<p>Improve user engagement and retention metrics.</p>",
  "progress": "in-progress",
  "color": "#ffb64f",
  "businessGoal": "Increase MAUs by 20% within the next fiscal year.",
  "teamId": 587,
  "userId": [],
  "startDate": "2024-06-30T18:30:00.000Z",
  "endDate": "2024-07-30T18:30:00.000Z",
  "tags": "[\"Feature\",\"User engagement\"]",
  "urls": [
    {
      "url": "https://example.com"
    }
  ],
  "estimate": "60",
  "businessValue": "100",
  "epicId": 1
}

Payload format for User Story

{
  "summary": "As a PM, I want personalized onboarding emails to improve retention.",
  "description": "<p>Acceptance criteria: track user actions, design dynamic email templates.</p>",
  "progress": "to-do",
  "backlog": true,
  "color": "#4784fc",
  "businessGoal": "Enhance user engagement via personalized communication.",
  "teamId": 587,
  "userId": [],
  "startDate": "2024-06-30T18:30:00.000Z",
  "endDate": "2024-07-18T18:30:00.000Z",
  "tags": "[\"Product management\",\"engagement\"]",
  "urls": [
    {
      "url": "https://example.com"
    }
  ],
  "epicId": 0,
  "featureId": 0,
  "storyPoint": "7",
  "remainingTime": "3"
}

Summary

Flow: External App ➔ Shorter Loop
Purpose: Sync external data/events into Shorter Loop.
Setup: Create in Shorter Loop ➔ Copy URL ➔ Paste into External App.

What is an Inbound Webhook?#

Creating an Inbound Webhook#

1. Navigate to Integrations#

2. Create the Webhook#

Using Your Inbound Webhook URL#

Payload format for Epic#

Payload format for Feature#

Payload format for User Story#

Summary#