Skip to main content
POST
/
v1
/
webhooks
Subscribe to webhook events
const options = {
  method: 'POST',
  headers: {
    'x-api-key': '<api-key>',
    'x-api-secret': '<api-key>',
    'x-connector-id': '<api-key>',
    'x-owner-id': '<api-key>',
    'x-session-token': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({events: []})
};

fetch('https://api.runmorph.dev/v1/webhooks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
[
  {
    "object": "webhook",
    "model": "<string>",
    "trigger": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>"
  }
]

​
Connectors Setup

Some connectors require a specific setup to support webhook subscription.
HubSpot requires two global webhooks to be configured at the HubSpot App level in your HubSpot developer portal.

​
Main Webhook Setup

  1. Navigate to Developer Hub > Your App
  2. Go to the “Webhooks” section
  3. Add the following webhook URL:
https://api.runmorph.dev/v1/hook/{orgId}/prod/hubspot/global/main

​
Card View Webhook Setup

If you plan to use the WidgetCardView model, you’ll need to configure an additional global webhook:
  1. Navigate to the “CRM Card” section
  2. Click “Create a new card”
  3. In the “Data fetch URL” field, enter:
https://api.runmorph.dev/v1/hook/{orgId}/prod/hubspot/global/cardView
Replace {orgId} with your actual organization ID in both webhook URLs.

Authorizations

​
x-api-key
string
header
required
​
x-api-secret
string
header
required
​
x-connector-id
string
header
required
​
x-owner-id
string
header
required
​
x-session-token
string
header
required

Body

​
events
enum<string>[]
required
Minimum array length: 1
Available options:
genericCompany::created,
genericCompany::updated,
genericCompany::deleted,
genericContact::created,
genericContact::updated,
genericContact::deleted,
genericUser::created,
genericUser::updated,
genericUser::deleted,
genericWorkspace::created,
genericWorkspace::updated,
genericWorkspace::deleted,
crmOpportunity::created,
crmOpportunity::updated,
crmOpportunity::deleted,
crmStage::created,
crmStage::updated,
crmStage::deleted,
crmPipeline::created,
crmPipeline::updated,
crmPipeline::deleted,
crmEngagement::created,
crmEngagement::updated,
crmEngagement::deleted,
telephonyCall::created,
telephonyCall::updated,
telephonyCall::deleted,
telephonyCallTranscript::created,
telephonyCallTranscript::updated,
telephonyCallTranscript::deleted,
schedulingEventType::created,
schedulingEventType::updated,
schedulingEventType::deleted,
schedulingSlot::created,
schedulingSlot::updated,
schedulingSlot::deleted,
schedulingEvent::created,
schedulingEvent::updated,
schedulingEvent::deleted,
widgetCardView::created,
widgetCardView::updated,
widgetCardView::deleted,
accountingInvoice::created,
accountingInvoice::updated,
accountingInvoice::deleted,
accountingInvoiceLineItem::created,
accountingInvoiceLineItem::updated,
accountingInvoiceLineItem::deleted,
accountingInvoiceItem::created,
accountingInvoiceItem::updated,
accountingInvoiceItem::deleted

Response

Created

​
object
enum<string>
required
Available options:
webhook
​
model
string
required
​
trigger
string
required
​
createdAt
string
required
​
updatedAt
string
required