fix(webhooks): answer missing trigger configuration with 400 and log refused resumes at warn

Author: waleedlatif1

apps/sim/app/api/webhooks/route.ts

@@ -33,6 +33,7 @@ import {
   shouldRecreateExternalWebhookSubscription,
 } from '@/lib/webhooks/provider-subscriptions'
 import { getProviderHandler } from '@/lib/webhooks/providers'
+import { WebhookDeploymentConfigurationError } from '@/lib/webhooks/providers/errors'
 import { mergeNonUserFields } from '@/lib/webhooks/utils'
 import { findConflictingWebhookPathOwner } from '@/lib/webhooks/utils.server'
 import { listAccessibleWorkspaceRowsForUser } from '@/lib/workspaces/utils'
@@ -573,13 +574,20 @@ export const POST = withRouteHandler(async (request: NextRequest) => {
           }
         }
       } catch (err) {
-        logger.error(`[${requestId}] Error creating external webhook subscription`, err)
+        const isConfigurationError = err instanceof WebhookDeploymentConfigurationError
+        if (isConfigurationError) {
+          logger.warn(`[${requestId}] Rejected webhook trigger configuration`, {
+            error: err.message,
+          })
+        } else {
+          logger.error(`[${requestId}] Error creating external webhook subscription`, err)
+        }
         return NextResponse.json(
           {
             error: 'Failed to create external webhook subscription',
             details: getErrorMessage(err, 'Unknown error'),
           },
-          { status: 500 }
+          { status: isConfigurationError ? 400 : 500 }
         )
       }
     } else {

apps/sim/lib/webhooks/providers/airtable.ts

@@ -14,6 +14,7 @@ import {
   getNotificationUrl,
   getProviderConfig,
 } from '@/lib/webhooks/provider-subscription-utils'
+import { WebhookDeploymentConfigurationError } from '@/lib/webhooks/providers/errors'
 import type {
   DeleteSubscriptionContext,
   FormatInputContext,
@@ -446,19 +447,19 @@ export const airtableHandler: WebhookProviderHandler = {
         logger.warn(`[${requestId}] Missing baseId or tableId for Airtable webhook creation.`, {
           webhookId: webhookRecord.id,
         })
-        throw new Error(
+        throw new WebhookDeploymentConfigurationError(
           'Base ID and Table ID are required to create Airtable webhook. Please provide valid Airtable base and table IDs.'
         )
       }
 
       const baseIdValidation = validateAirtableId(baseId, 'app', 'baseId')
       if (!baseIdValidation.isValid) {
-        throw new Error(baseIdValidation.error)
+        throw new WebhookDeploymentConfigurationError(baseIdValidation.error)
       }
 
       const tableIdValidation = validateAirtableId(tableId, 'tbl', 'tableId')
       if (!tableIdValidation.isValid) {
-        throw new Error(tableIdValidation.error)
+        throw new WebhookDeploymentConfigurationError(tableIdValidation.error)
       }
 
       const accessToken = credentialId
@@ -535,6 +536,7 @@ export const airtableHandler: WebhookProviderHandler = {
       )
       return { providerConfigUpdates: { externalId: responseBody.id } }
     } catch (error: unknown) {
+      if (error instanceof WebhookDeploymentConfigurationError) throw error
       const err = error as Error
       logger.error(
         `[${requestId}] Exception during Airtable webhook creation for webhook ${webhookRecord.id}.`,

apps/sim/lib/webhooks/providers/ashby.ts

@@ -6,6 +6,7 @@ import { isRecordLike, omit, toRecord } from '@sim/utils/object'
 import { NextResponse } from 'next/server'
 import { isPayloadSizeLimitError, readResponseJsonWithLimit } from '@/lib/core/utils/stream-limits'
 import { getNotificationUrl, getProviderConfig } from '@/lib/webhooks/provider-subscription-utils'
+import { WebhookDeploymentConfigurationError } from '@/lib/webhooks/providers/errors'
 import type {
   AuthContext,
   DeleteSubscriptionContext,
@@ -235,13 +236,15 @@ export const ashbyHandler: WebhookProviderHandler = {
       }
 
       if (!apiKey) {
-        throw new Error(
+        throw new WebhookDeploymentConfigurationError(
           'Ashby API Key is required. Please provide your API Key with apiKeysWrite permission in the trigger configuration.'
         )
       }
 
       if (!triggerId) {
-        throw new Error('Trigger ID is required to create Ashby webhook.')
+        throw new WebhookDeploymentConfigurationError(
+          'Trigger ID is required to create Ashby webhook.'
+        )
       }
 
       const { ASHBY_TRIGGER_ACTION_MAP } = await import('@/triggers/ashby/utils')
@@ -322,6 +325,7 @@ export const ashbyHandler: WebhookProviderHandler = {
       )
       return { providerConfigUpdates: { externalId, secretToken } }
     } catch (error: unknown) {
+      if (error instanceof WebhookDeploymentConfigurationError) throw error
       const err = error as Error
       logger.error(
         `[${ctx.requestId}] Exception during Ashby webhook creation for webhook ${ctx.webhook.id}.`,

apps/sim/lib/webhooks/providers/attio.ts

@@ -9,6 +9,7 @@ import {
   getNotificationUrl,
   getProviderConfig,
 } from '@/lib/webhooks/provider-subscription-utils'
+import { WebhookDeploymentConfigurationError } from '@/lib/webhooks/providers/errors'
 import type {
   AuthContext,
   DeleteSubscriptionContext,
@@ -116,7 +117,7 @@ export const attioHandler: WebhookProviderHandler = {
         logger.warn(`[${requestId}] Missing credentialId for Attio webhook creation.`, {
           webhookId: webhookRecord.id,
         })
-        throw new Error(
+        throw new WebhookDeploymentConfigurationError(
           'Attio account connection required. Please connect your Attio account in the trigger configuration and try again.'
         )
       }
@@ -222,6 +223,7 @@ export const attioHandler: WebhookProviderHandler = {
 
       return { providerConfigUpdates: { externalId: webhookId, webhookSecret: secret || '' } }
     } catch (error: unknown) {
+      if (error instanceof WebhookDeploymentConfigurationError) throw error
       const message = toError(error).message
       logger.error(
         `[${requestId}] Exception during Attio webhook creation for webhook ${webhookRecord.id}.`,

apps/sim/lib/webhooks/providers/bitbucket.ts

@@ -11,6 +11,7 @@ import {
   getNotificationUrl,
   getProviderConfig,
 } from '@/lib/webhooks/provider-subscription-utils'
+import { WebhookDeploymentConfigurationError } from '@/lib/webhooks/providers/errors'
 import type {
   DeleteSubscriptionContext,
   EventMatchContext,
@@ -89,7 +90,7 @@ async function resolveBitbucketAccessToken(
   requestId: string
 ): Promise<string> {
   if (!credentialId) {
-    throw new Error(
+    throw new WebhookDeploymentConfigurationError(
       'Bitbucket account connection required. Connect or reconnect Bitbucket in the trigger configuration and try again.'
     )
   }
@@ -112,7 +113,9 @@ function readRequiredConfigString(
 ): string {
   const value = config[key]
   if (typeof value !== 'string' || !value.trim()) {
-    throw new Error(`Bitbucket ${label} is required to manage the repository webhook.`)
+    throw new WebhookDeploymentConfigurationError(
+      `Bitbucket ${label} is required to manage the repository webhook.`
+    )
   }
   return value.trim()
 }

apps/sim/lib/webhooks/providers/calendly.ts

@@ -1,5 +1,6 @@
 import { createLogger } from '@sim/logger'
 import { getNotificationUrl, getProviderConfig } from '@/lib/webhooks/provider-subscription-utils'
+import { WebhookDeploymentConfigurationError } from '@/lib/webhooks/providers/errors'
 import type {
   DeleteSubscriptionContext,
   FormatInputContext,
@@ -37,7 +38,7 @@ export const calendlyHandler: WebhookProviderHandler = {
         logger.warn(`[${ctx.requestId}] Missing apiKey for Calendly webhook creation.`, {
           webhookId: ctx.webhook.id,
         })
-        throw new Error(
+        throw new WebhookDeploymentConfigurationError(
           'Personal Access Token is required to create Calendly webhook. Please provide your Calendly Personal Access Token.'
         )
       }
@@ -46,7 +47,7 @@ export const calendlyHandler: WebhookProviderHandler = {
         logger.warn(`[${ctx.requestId}] Missing organization URI for Calendly webhook creation.`, {
           webhookId: ctx.webhook.id,
         })
-        throw new Error(
+        throw new WebhookDeploymentConfigurationError(
           'Organization URI is required to create Calendly webhook. Please provide your Organization URI from the "Get Current User" operation.'
         )
       }
@@ -55,7 +56,9 @@ export const calendlyHandler: WebhookProviderHandler = {
         logger.warn(`[${ctx.requestId}] Missing triggerId for Calendly webhook creation.`, {
           webhookId: ctx.webhook.id,
         })
-        throw new Error('Trigger ID is required to create Calendly webhook')
+        throw new WebhookDeploymentConfigurationError(
+          'Trigger ID is required to create Calendly webhook'
+        )
       }
 
       const notificationUrl = getNotificationUrl(ctx.webhook)
@@ -152,6 +155,7 @@ export const calendlyHandler: WebhookProviderHandler = {
       )
       return { providerConfigUpdates: { externalId: webhookId } }
     } catch (error: unknown) {
+      if (error instanceof WebhookDeploymentConfigurationError) throw error
       const err = error as Error
       logger.error(
         `[${ctx.requestId}] Exception during Calendly webhook creation for webhook ${ctx.webhook.id}.`,

apps/sim/lib/webhooks/providers/checkr.ts

@@ -8,6 +8,7 @@ import { and, eq, isNull, ne } from 'drizzle-orm'
 import { NextResponse } from 'next/server'
 import { isPayloadSizeLimitError, readResponseJsonWithLimit } from '@/lib/core/utils/stream-limits'
 import { getNotificationUrl, getProviderConfig } from '@/lib/webhooks/provider-subscription-utils'
+import { WebhookDeploymentConfigurationError } from '@/lib/webhooks/providers/errors'
 import type {
   AuthContext,
   DeleteSubscriptionContext,
@@ -198,7 +199,9 @@ export const checkrHandler: WebhookProviderHandler = {
     const providerConfig = getProviderConfig(ctx.webhook)
     const apiKey = typeof providerConfig.apiKey === 'string' ? providerConfig.apiKey.trim() : ''
     if (!apiKey) {
-      throw new Error('Checkr API key is required to register the webhook.')
+      throw new WebhookDeploymentConfigurationError(
+        'Checkr API key is required to register the webhook.'
+      )
     }
 
     const notificationUrl = getNotificationUrl(ctx.webhook)

apps/sim/lib/webhooks/providers/clickup.ts

@@ -9,6 +9,7 @@ import {
   getNotificationUrl,
   getProviderConfig,
 } from '@/lib/webhooks/provider-subscription-utils'
+import { WebhookDeploymentConfigurationError } from '@/lib/webhooks/providers/errors'
 import type {
   DeleteSubscriptionContext,
   EventMatchContext,
@@ -46,7 +47,7 @@ async function resolveClickUpAccessToken(
   requestId: string
 ): Promise<string> {
   if (!credentialId) {
-    throw new Error(
+    throw new WebhookDeploymentConfigurationError(
       'ClickUp account connection required. Please connect your ClickUp account in the trigger configuration and try again.'
     )
   }
@@ -72,7 +73,9 @@ function parseOptionalNumericId(value: unknown, label: string): number | undefin
   if (!raw) return undefined
   const parsed = Number(raw)
   if (!Number.isInteger(parsed)) {
-    throw new Error(`ClickUp ${label} must be a whole number. Received: ${raw}`)
+    throw new WebhookDeploymentConfigurationError(
+      `ClickUp ${label} must be a whole number. Received: ${raw}`
+    )
   }
   return parsed
 }
@@ -154,7 +157,7 @@ export const clickupHandler: WebhookProviderHandler = {
 
       const workspaceId = parseOptionalStringId(config.triggerWorkspaceId)
       if (!workspaceId) {
-        throw new Error(
+        throw new WebhookDeploymentConfigurationError(
           'ClickUp workspace is required. Please select a workspace in the trigger configuration and try again.'
         )
       }
@@ -271,6 +274,7 @@ export const clickupHandler: WebhookProviderHandler = {
 
       return { providerConfigUpdates: { externalId, webhookSecret: secret } }
     } catch (error: unknown) {
+      if (error instanceof WebhookDeploymentConfigurationError) throw error
       const message = toError(error).message
       logger.error(
         `[${requestId}] Exception during ClickUp webhook creation for webhook ${webhookRecord.id}.`,

apps/sim/lib/webhooks/providers/emailbison.ts

@@ -7,6 +7,7 @@ import {
   validateUrlWithDNS,
 } from '@/lib/core/security/input-validation.server'
 import { getNotificationUrl, getProviderConfig } from '@/lib/webhooks/provider-subscription-utils'
+import { WebhookDeploymentConfigurationError } from '@/lib/webhooks/providers/errors'
 import type {
   DeleteSubscriptionContext,
   EventMatchContext,
@@ -127,15 +128,15 @@ export const emailBisonHandler: WebhookProviderHandler = {
     const triggerId = providerConfig.triggerId as string | undefined
 
     if (!apiKey?.trim()) {
-      throw new Error('Email Bison API Key is required.')
+      throw new WebhookDeploymentConfigurationError('Email Bison API Key is required.')
     }
 
     if (!apiBaseUrl?.trim()) {
-      throw new Error('Email Bison Instance URL is required.')
+      throw new WebhookDeploymentConfigurationError('Email Bison Instance URL is required.')
     }
 
     if (!triggerId) {
-      throw new Error('Email Bison trigger ID is required.')
+      throw new WebhookDeploymentConfigurationError('Email Bison trigger ID is required.')
     }
 
     const { getEmailBisonEventTypeForTrigger } = await import('@/triggers/emailbison/utils')

apps/sim/lib/webhooks/providers/fathom.ts

@@ -1,6 +1,7 @@
 import { createLogger } from '@sim/logger'
 import { validateAlphanumericId } from '@/lib/core/security/input-validation'
 import { getNotificationUrl, getProviderConfig } from '@/lib/webhooks/provider-subscription-utils'
+import { WebhookDeploymentConfigurationError } from '@/lib/webhooks/providers/errors'
 import type {
   DeleteSubscriptionContext,
   SubscriptionContext,
@@ -27,7 +28,7 @@ export const fathomHandler: WebhookProviderHandler = {
         logger.warn(`[${requestId}] Missing apiKey for Fathom webhook creation.`, {
           webhookId: webhook.id,
         })
-        throw new Error(
+        throw new WebhookDeploymentConfigurationError(
           'Fathom API Key is required. Please provide your API key in the trigger configuration.'
         )
       }
@@ -108,6 +109,7 @@ export const fathomHandler: WebhookProviderHandler = {
 
       return { providerConfigUpdates: { externalId: responseBody.id } }
     } catch (error: unknown) {
+      if (error instanceof WebhookDeploymentConfigurationError) throw error
       const err = error as Error
       logger.error(
         `[${requestId}] Exception during Fathom webhook creation for webhook ${webhook.id}.`,