Create a webhook subscription for the authenticated team. The full signing secret is returned exactly once in this response — store it now, because every later read returns only a 4-character preview. Creating a webhook is free (0 API credits). A team may have at most 10 active webhooks.
Event types to subscribe to. Duplicates are removed.
Event type a subscription can register for. system.test is accepted but only ever delivered by the Send Test Event endpoint; it never fires automatically.
Optional string key/value filters that narrow which events are delivered. Recognized keys: countries, jobCountries, categories, search, teamSize, dateFrom, dateTo, funding, roundFlavor, fundingAmount, acquisitionAmount, healthScore. Unrecognized keys are silently ignored — note the round-type key is funding, not round. For hiring.created events countries matches the job listing country OR the company HQ country (same as the REST hiring endpoint), and jobCountries matches the job listing country only; jobCountries never matches non-hiring events. For investor.created events only countries and search apply. See the Webhooks overview 'Filters' section for value formats.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Signalbase Documentation","colors":{"primary":"#F97316","light":"#FB923C","dark":"#EA580C"},"logo":{"light":"https://mintcdn.com/trysignalbasecom-5904a15f/6IA72HMCvXLX5PTo/logo/logo.png?fit=max\u0026auto=format\u0026n=6IA72HMCvXLX5PTo\u0026q=85\u0026s=3a1b6dfa702965308046d1f046daca5e","dark":"https://mintcdn.com/trysignalbasecom-5904a15f/6IA72HMCvXLX5PTo/logo/logo.png?fit=max\u0026auto=format\u0026n=6IA72HMCvXLX5PTo\u0026q=85\u0026s=3a1b6dfa702965308046d1f046daca5e"},"favicon":"https://mintcdn.com/trysignalbasecom-5904a15f/cYNM26cw-VnLEnjP/favicon.svg?fit=max\u0026auto=format\u0026n=cYNM26cw-VnLEnjP\u0026q=85\u0026s=ef1d9a99762ff3a4e40e433a89628cb5","appearance":{"default":"light"},"navbar":{"links":[],"primary":{"type":"button","label":"Dashboard","href":"https://www.trysignalbase.com/personal/account"}},"footer":{"socials":{"x":"https://x.com/trysignalbase","github":"https://github.com/trysignalbase","linkedin":"https://linkedin.com/company/signalbase"}},"styling":{"latex":false},"navigation":{"global":{},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"trysignalbasecom-5904a15f","hasAudioNarration":false,"actualSubdomain":"trysignalbasecom-5904a15f","customDomains":["docs.trysignalbase.com"],"gitSource":{"type":"github","owner":"trysignalbase","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ab0e84e41250717a715a01b","collectionId":"113a9baa-8a34-4c3a-8ebc-f3857b0c890d","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ab0e84e41250717a715a01b"},"entitlements":{},"buildId":"6ab0e84e41250717a715a01b","clientVersion":"0.0.4064","searchFilterCounts":[{"language":"default","tag":"Endpoints","count":17},{"language":"default","tag":"Monitoring","count":10},{"language":"default","tag":"Webhooks","count":9},{"language":"default","tag":"Monitors","count":5},{"language":"default","tag":"Targets","count":4},{"language":"default","tag":"CSV Enrichment","count":3},{"language":"default","tag":"Acquisition Signals","count":2},{"language":"default","tag":"Companies","count":2},{"language":"default","tag":"Funding Signals","count":2},{"language":"default","tag":"Hiring Signals","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/webhooks/endpoint/create","slug":"/api-reference/webhooks/endpoint/create","pageMetadata":{"title":"Create Webhook","openapi":"POST /webhooks","description":"Create a webhook subscription for the authenticated team. The full signing secret is returned exactly once in this response — store it now, because every later read returns only a 4-character preview. Creating a webhook is free (0 API credits). A team may have at most 10 active webhooks.","href":"/api-reference/webhooks/endpoint/create"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create a webhook subscription for the authenticated team. The full signing secret is returned exactly once in this response — store it now, because every later read returns only a 4-character preview. Creating a webhook is free (0 API credits). A team may have at most 10 active webhooks.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Webhook","openapi":"POST /webhooks","description":"Create a webhook subscription for the authenticated team. The full signing secret is returned exactly once in this response — store it now, because every later read returns only a 4-character preview. Creating a webhook is free (0 API credits). A team may have at most 10 active webhooks.","href":"/api-reference/webhooks/endpoint/create"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create Webhook","description":"Create a webhook subscription for the authenticated team. The full signing secret is returned exactly once in this response — store it now, because every later read returns only a 4-character preview. Creating a webhook is free (0 API credits). A team may have at most 10 active webhooks.","operationId":"createWebhook","requestBody":"667cdf99-e761-4485-9936-048fd69d2770","responses":{"201":"6f5e50a5-6598-4ea8-bfba-51097757b324","400":"ecedd79f-dee1-4e86-9bad-06189edc9c6e","401":"b5c0f1f7-cecd-447d-be27-518c6db3c2ac","403":"ee34c61d-be02-4b20-ae0a-fc59de0901e0","429":"99e54489-baf5-4708-b922-9e08ca264c30","500":"12f86182-05f2-4139-8f26-65563b37dfd5"},"method":"post","type":"path","servers":["faab4c94-7579-4059-b080-5374ea5a56a8"],"security":["c74e0e0b-fb0f-43e1-8e73-75c600233ad3"],"path":"/webhooks","baseUrlOptions":["https://www.trysignalbase.com/api/v2"],"title":"Create Webhook","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["endpoint_url","event_types"],"description":"Field names accept snake_case (canonical) or camelCase (endpointUrl, eventTypes).","properties":{"endpoint_url":{"type":"string","format":"uri","maxLength":500,"description":"Destination URL. Must be a valid http/https URL of at most 500 characters. In production, localhost and private/link-local addresses are rejected.","example":"https://example.com/hooks/signalbase","isRequired":true,"uniqueKey":"endpoint_url","typeLabel":"string\u003curi>"},"event_types":{"type":"array","description":"Event types to subscribe to. Duplicates are removed.","items":{"type":"string","description":"Event type a subscription can register for. system.test is accepted but only ever delivered by the Send Test Event endpoint; it never fires automatically.","enum":["funding.created","acquisition.created","job_change.created","hiring.created","new_company.created","investor.created","system.test"],"uniqueKey":"event_types.items.[INDEX]","typeLabel":"enum\u003cstring>"},"example":["funding.created","hiring.created"],"isRequired":true,"uniqueKey":"event_types","typeLabel":"enum\u003cstring>[]"},"filters":{"type":"object","description":"Optional string key/value filters that narrow which events are delivered. Recognized keys: countries, jobCountries, categories, search, teamSize, dateFrom, dateTo, funding, roundFlavor, fundingAmount, acquisitionAmount, healthScore. Unrecognized keys are silently ignored — note the round-type key is `funding`, not `round`. For hiring.created events `countries` matches the job listing country OR the company HQ country (same as the REST hiring endpoint), and `jobCountries` matches the job listing country only; `jobCountries` never matches non-hiring events. For investor.created events only countries and search apply. See the Webhooks overview 'Filters' section for value formats.","additionalProperties":{"type":"string","uniqueKey":"filters.additionalProperties","typeLabel":"string"},"example":{"countries":"US,GB","funding":"seed,series a"},"uniqueKey":"filters","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"endpoint_url":"https://example.com/hooks/signalbase","event_types":["funding.created","hiring.created"],"filters":{"countries":"US,GB"}},"examples":{"Example":{"title":"Example","value":{"endpoint_url":"https://example.com/hooks/signalbase","event_types":["funding.created","hiring.created"],"filters":{"countries":"US,GB"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"6f5e50a5-6598-4ea8-bfba-51097757b324":{"description":"Webhook created. data includes the full signing secret (shown only on create).","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","const":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"object","description":"A webhook subscription. List/retrieve/update(no rotation)/delete include secret_preview; create and rotate_secret include the full secret instead.","required":["id","endpoint_url","event_types","filters","active","created_at","updated_at","last_modified_by","last_modified_via","stats"],"properties":{"id":{"type":"string","description":"Unique webhook ID (UUID).","isRequired":true,"uniqueKey":"data.id","typeLabel":"string"},"endpoint_url":{"type":"string","format":"uri","description":"HTTPS endpoint that receives deliveries.","isRequired":true,"uniqueKey":"data.endpoint_url","typeLabel":"string\u003curi>"},"event_types":{"type":"array","description":"Event types this subscription is registered for.","items":{"type":"string","description":"Event type a subscription can register for. system.test is accepted but only ever delivered by the Send Test Event endpoint; it never fires automatically.","enum":["funding.created","acquisition.created","job_change.created","hiring.created","new_company.created","investor.created","system.test"],"uniqueKey":"data.event_types.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"data.event_types","typeLabel":"enum\u003cstring>[]"},"filters":{"type":"object","description":"Optional string key/value filters that narrow which events are delivered. Recognized keys: countries, jobCountries, categories, search, teamSize, dateFrom, dateTo, funding, roundFlavor, fundingAmount, acquisitionAmount, healthScore. Unrecognized keys are silently ignored — note the round-type key is `funding`, not `round`. For hiring.created events `countries` matches the job listing country OR the company HQ country (same as the REST hiring endpoint), and `jobCountries` matches the job listing country only; `jobCountries` never matches non-hiring events. For investor.created events only countries and search apply. See the Webhooks overview 'Filters' section for value formats.","additionalProperties":{"type":"string","uniqueKey":"data.filters.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.filters","typeLabel":"object"},"active":{"type":"boolean","description":"Whether the webhook is active. Soft-deleted webhooks are active=false.","isRequired":true,"uniqueKey":"data.active","typeLabel":"boolean"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time>"},"last_modified_by":{"oneOf":[{"type":"string","description":"ID of the user who last modified the webhook. Null if created before audit columns existed.","isRequired":true,"uniqueKey":"data.last_modified_by.oneOf.0","typeLabel":"string"},{"type":"null","description":"ID of the user who last modified the webhook. Null if created before audit columns existed.","isRequired":true,"uniqueKey":"data.last_modified_by.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.last_modified_by","typeLabel":"string | null"},"last_modified_via":{"oneOf":[{"type":"string","description":"Where the last change originated.","enum":["api","dashboard",null],"isRequired":true,"uniqueKey":"data.last_modified_via.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Where the last change originated.","enum":["api","dashboard",null],"isRequired":true,"uniqueKey":"data.last_modified_via.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.last_modified_via","typeLabel":"enum\u003cstring> | null"},"stats":{"type":"object","required":["total_deliveries","successful_deliveries","failed_deliveries","last_success_at","last_failure_at","consecutive_failures"],"properties":{"total_deliveries":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.stats.total_deliveries","typeLabel":"integer"},"successful_deliveries":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.stats.successful_deliveries","typeLabel":"integer"},"failed_deliveries":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.stats.failed_deliveries","typeLabel":"integer"},"last_success_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.stats.last_success_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"data.stats.last_success_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.stats.last_success_at","typeLabel":"string\u003cdate-time> | null"},"last_failure_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.stats.last_failure_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"data.stats.last_failure_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.stats.last_failure_at","typeLabel":"string\u003cdate-time> | null"},"consecutive_failures":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.stats.consecutive_failures","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"data.stats","typeLabel":"object"},"secret":{"type":"string","description":"Full HMAC signing secret (UUID). Returned ONLY on create and on update with rotate_secret:true.","uniqueKey":"data.secret","typeLabel":"string"},"secret_preview":{"type":"string","description":"An ellipsis followed by the last 4 characters of the secret (e.g. \"…5a6b\"). Returned on every read instead of the full secret.","uniqueKey":"data.secret_preview","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"},"meta":{"type":"object","required":["endpoint","creditsUsed"],"properties":{"endpoint":{"type":"string","description":"Endpoint identifier (e.g. webhooks.create).","isRequired":true,"uniqueKey":"meta.endpoint","typeLabel":"string"},"creditsUsed":{"type":"integer","minimum":0,"description":"API credits consumed by this request.","isRequired":true,"uniqueKey":"meta.creditsUsed","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":true,"data":{"id":"b1f2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d","endpoint_url":"https://example.com/hooks/signalbase","event_types":["funding.created","hiring.created"],"filters":{"countries":"US,GB"},"active":true,"created_at":"2026-05-29T10:30:00.000Z","updated_at":"2026-05-29T10:30:00.000Z","last_modified_by":"user_2a9f8c7b6d5e4f3a","last_modified_via":"api","secret":"3f9a1c7e-2b4d-4e6a-9f1b-8c2d3e4f5a6b","stats":{"total_deliveries":0,"successful_deliveries":0,"failed_deliveries":0,"last_success_at":null,"last_failure_at":null,"consecutive_failures":0}},"meta":{"endpoint":"webhooks.create","creditsUsed":0}},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"id":"b1f2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d","endpoint_url":"https://example.com/hooks/signalbase","event_types":["funding.created","hiring.created"],"filters":{"countries":"US,GB"},"active":true,"created_at":"2026-05-29T10:30:00.000Z","updated_at":"2026-05-29T10:30:00.000Z","last_modified_by":"user_2a9f8c7b6d5e4f3a","last_modified_via":"api","secret":"3f9a1c7e-2b4d-4e6a-9f1b-8c2d3e4f5a6b","stats":{"total_deliveries":0,"successful_deliveries":0,"failed_deliveries":0,"last_success_at":null,"last_failure_at":null,"consecutive_failures":0}},"meta":{"endpoint":"webhooks.create","creditsUsed":0}}}},"exampleType":"examples"}},"exampleType":"examples"},"ecedd79f-dee1-4e86-9bad-06189edc9c6e":{"description":"Invalid request body, invalid endpoint URL, invalid event type, or the per-team active webhook limit (10) was reached.","content":{"application/json":{"schema":{"type":"object","required":["success","error","code"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","enum":["bad_request","invalid_api_key","subscription_expired","not_found","conflict","rate_limited","internal_server_error","internal_error"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"retryAfter":{"type":"integer","description":"Seconds until a retry is recommended. Present on rate-limit (429) responses.","uniqueKey":"retryAfter","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"Webhook URL must be a public address","code":"bad_request"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Webhook URL must be a public address","code":"bad_request"}}},"exampleType":"examples"}},"exampleType":"examples"},"b5c0f1f7-cecd-447d-be27-518c6db3c2ac":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["success","error","code"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","enum":["bad_request","invalid_api_key","subscription_expired","not_found","conflict","rate_limited","internal_server_error","internal_error"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"retryAfter":{"type":"integer","description":"Seconds until a retry is recommended. Present on rate-limit (429) responses.","uniqueKey":"retryAfter","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"Invalid API key. No key found.","code":"invalid_api_key"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Invalid API key. No key found.","code":"invalid_api_key"}}},"exampleType":"examples"}},"exampleType":"examples"},"ee34c61d-be02-4b20-ae0a-fc59de0901e0":{"description":"The API key belongs to a team without an active subscription.","content":{"application/json":{"schema":{"type":"object","required":["success","error","code"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","enum":["bad_request","invalid_api_key","subscription_expired","not_found","conflict","rate_limited","internal_server_error","internal_error"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"retryAfter":{"type":"integer","description":"Seconds until a retry is recommended. Present on rate-limit (429) responses.","uniqueKey":"retryAfter","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"Subscription expired. Please upgrade your subscription: https://www.trysignalbase.com/#pricing","code":"subscription_expired"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Subscription expired. Please upgrade your subscription: https://www.trysignalbase.com/#pricing","code":"subscription_expired"}}},"exampleType":"examples"}},"exampleType":"examples"},"99e54489-baf5-4708-b922-9e08ca264c30":{"description":"Rate limit exceeded for this team and endpoint. The response also sets X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers.","content":{"application/json":{"schema":{"type":"object","required":["success","error","code"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","enum":["bad_request","invalid_api_key","subscription_expired","not_found","conflict","rate_limited","internal_server_error","internal_error"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"retryAfter":{"type":"integer","description":"Seconds until a retry is recommended. Present on rate-limit (429) responses.","uniqueKey":"retryAfter","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"Too many requests. Please upgrade your plan or slow down.","code":"rate_limited","retryAfter":60},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Too many requests. Please upgrade your plan or slow down.","code":"rate_limited","retryAfter":60}}},"exampleType":"examples"}},"exampleType":"examples"},"12f86182-05f2-4139-8f26-65563b37dfd5":{"description":"Unexpected server error.","content":{"application/json":{"schema":{"type":"object","required":["success","error","code"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","enum":["bad_request","invalid_api_key","subscription_expired","not_found","conflict","rate_limited","internal_server_error","internal_error"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"retryAfter":{"type":"integer","description":"Seconds until a retry is recommended. Present on rate-limit (429) responses.","uniqueKey":"retryAfter","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"An unknown error occurred","code":"internal_error"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"An unknown error occurred","code":"internal_error"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"c74e0e0b-fb0f-43e1-8e73-75c600233ad3":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API key","description":"Use your `ff_live_…` API key as a Bearer token in the Authorization header.","scopes":[]}}},"servers":{"faab4c94-7579-4059-b080-5374ea5a56a8":{"url":"https://www.trysignalbase.com/api/v2"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API key","description":"Use your `ff_live_…` API key as a Bearer token in the Authorization header.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Use your `ff_live_…` API key as a Bearer token in the Authorization header.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"trysignalbasecom-5904a15f","siteName":"Signalbase Documentation","title":"Create Webhook - Signalbase Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-02T08:50:22.111Z","originalFileLocation":"api-reference/webhooks/endpoint/create.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a webhook subscription for the authenticated team. The full signing secret is returned exactly once in this response — store it now, because every later read returns only a 4-character preview. Creating a webhook is free (0 API credits). A team may have at most 10 active webhooks.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Signalbase Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/trysignalbasecom-5904a15f/H7oGJPUQxV48znff/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/trysignalbasecom-5904a15f/H7oGJPUQxV48znff/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/trysignalbasecom-5904a15f/H7oGJPUQxV48znff/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/trysignalbasecom-5904a15f/H7oGJPUQxV48znff/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/trysignalbasecom-5904a15f/H7oGJPUQxV48znff/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/trysignalbasecom-5904a15f/H7oGJPUQxV48znff/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/trysignalbasecom-5904a15f/H7oGJPUQxV48znff/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/trysignalbasecom-5904a15f/H7oGJPUQxV48znff/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/trysignalbasecom-5904a15f/H7oGJPUQxV48znff/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Webhook - Signalbase Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a webhook subscription for the authenticated team. The full signing secret is returned exactly once in this response — store it now, because every later read returns only a 4-character preview. Creating a webhook is free (0 API credits). A team may have at most 10 active webhooks.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Signalbase Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.trysignalbase.com/api-reference/webhooks/endpoint/create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://trysignalbasecom-5904a15f.mintlify.app/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=Create+Webhook\u0026amp;description=Create+a+webhook+subscription+for+the+authenticated+team.+The+full+signing+secret+is+returned+exactly+once+in+this+response+%E2%80%94+store+it+now%2C+because+every+later+\u0026amp;theme=77b147cf88ee5368024108fd\u0026amp;signature=ac707131a2bc863356473d609f68967ea124a71d0eb03c5436944344d0b47c90\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create Webhook - Signalbase Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a webhook subscription for the authenticated team. The full signing secret is returned exactly once in this response — store it now, because every later read returns only a 4-character preview. Creating a webhook is free (0 API credits). A team may have at most 10 active webhooks.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://trysignalbasecom-5904a15f.mintlify.app/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=Create+Webhook\u0026amp;description=Create+a+webhook+subscription+for+the+authenticated+team.+The+full+signing+secret+is+returned+exactly+once+in+this+response+%E2%80%94+store+it+now%2C+because+every+later+\u0026amp;theme=77b147cf88ee5368024108fd\u0026amp;signature=ac707131a2bc863356473d609f68967ea124a71d0eb03c5436944344d0b47c90\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/trysignalbasecom-5904a15f/H7oGJPUQxV48znff/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Signalbase Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F97316\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.trysignalbase.com/api-reference/webhooks/endpoint/create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/webhooks/endpoint/create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.trysignalbase.com/#organization\",\"name\":\"Signalbase Documentation\",\"url\":\"https://docs.trysignalbase.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/trysignalbasecom-5904a15f/6IA72HMCvXLX5PTo/logo/logo.png?fit=max\u0026auto=format\u0026n=6IA72HMCvXLX5PTo\u0026q=85\u0026s=3a1b6dfa702965308046d1f046daca5e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.trysignalbase.com#website\",\"name\":\"Signalbase Documentation\",\"url\":\"https://docs.trysignalbase.com\",\"publisher\":{\"@id\":\"https://docs.trysignalbase.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.trysignalbase.com/api-reference/webhooks/endpoint/create#webpage\",\"url\":\"https://docs.trysignalbase.com/api-reference/webhooks/endpoint/create\",\"name\":\"Create Webhook\",\"description\":\"Create a webhook subscription for the authenticated team. The full signing secret is returned exactly once in this response — store it now, because every later read returns only a 4-character preview. Creating a webhook is free (0 API credits). A team may have at most 10 active webhooks.\",\"dateModified\":\"2026-06-02T08:50:22.111Z\",\"isPartOf\":{\"@id\":\"https://docs.trysignalbase.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.trysignalbase.com/api-reference/webhooks/endpoint/create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.trysignalbase.com/api-reference/webhooks/endpoint/create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Signalbase Documentation\",\"item\":\"https://docs.trysignalbase.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Webhook\",\"item\":\"https://docs.trysignalbase.com/api-reference/webhooks/endpoint/create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.trysignalbase.com/api-reference/webhooks/endpoint/create#apireference\",\"headline\":\"Create Webhook\",\"name\":\"Create Webhook\",\"description\":\"Create a webhook subscription for the authenticated team. The full signing secret is returned exactly once in this response — store it now, because every later read returns only a 4-character preview. Creating a webhook is free (0 API credits). A team may have at most 10 active webhooks.\",\"url\":\"https://docs.trysignalbase.com/api-reference/webhooks/endpoint/create\",\"mainEntityOfPage\":{\"@id\":\"https://docs.trysignalbase.com/api-reference/webhooks/endpoint/create#webpage\"},\"dateModified\":\"2026-06-02T08:50:22.111Z\",\"publisher\":{\"@id\":\"https://docs.trysignalbase.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.trysignalbase.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Signalbase Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Signalbase Documentation","nav":{"global":{},"tabs":[{"tab":"Signalbase API","pages":[{"title":"Signalbase API","href":""}]},{"tab":"Funding Signals","pages":[{"title":"Funding Signals","href":"/api-reference/funding-signals/introduction"}]},{"tab":"Acquisition Signals","pages":[{"title":"Acquisition Signals","href":"/api-reference/acquisition-signals/introduction"}]},{"tab":"Job Change Signals","pages":[{"title":"Job Change Signals","href":"/api-reference/job-change-signals/introduction"}]},{"tab":"Hiring Signals","pages":[{"title":"Hiring Signals","href":"/api-reference/hiring-signals/introduction"}]},{"tab":"Investors","pages":[{"title":"Investors","href":"/api-reference/investors/introduction"}]},{"tab":"Companies","pages":[{"title":"Companies","href":"/api-reference/companies/introduction"}]},{"tab":"People","pages":[{"title":"People","href":"/api-reference/people/introduction"}]},{"tab":"CSV Enrichment","pages":[{"title":"CSV Enrichment","href":"/api-reference/csv-enrichment/introduction"}]},{"tab":"Webhooks","groups":[{"group":"Webhooks API","pages":[{"title":"Introduction","description":"Manage webhook subscriptions as a first-class API resource — create, configure, test, and debug real-time signal delivery entirely over REST","href":"/api-reference/webhooks/introduction"}]},{"group":"Endpoints","pages":[{"title":"Create Webhook","openapi":"POST /webhooks","href":"/api-reference/webhooks/endpoint/create"},{"title":"List Webhooks","openapi":"GET /webhooks","description":"List the authenticated team's active webhook subscriptions, newest first. Secrets are never returned here — each item includes only secret_preview. Free (0 credits).","href":"/api-reference/webhooks/endpoint/list"},{"title":"Retrieve Webhook","openapi":"GET /webhooks/{id}","href":"/api-reference/webhooks/endpoint/retrieve"},{"title":"Update Webhook","openapi":"PUT /webhooks/{id}","href":"/api-reference/webhooks/endpoint/update"},{"title":"Delete Webhook","openapi":"DELETE /webhooks/{id}","href":"/api-reference/webhooks/endpoint/delete"},{"title":"Send Test Event","openapi":"POST /webhooks/{id}/test","href":"/api-reference/webhooks/endpoint/test"},{"title":"List Deliveries","openapi":"GET /webhooks/{id}/deliveries","href":"/api-reference/webhooks/endpoint/deliveries"},{"title":"Retry Delivery","openapi":"POST /webhooks/{id}/deliveries/{deliveryId}/retry","href":"/api-reference/webhooks/endpoint/retry"}]}]},{"tab":"Monitoring","pages":[{"title":"Monitoring","href":"/api-reference/monitors/introduction"}]}]},"basePath":"","title":"Create Webhook - Signalbase Documentation","buildId":"dpl_2gSLkbMoF5kkLsBqYzq9KWtDyJRo","deploymentId":"dpl_2gSLkbMoF5kkLsBqYzq9KWtDyJRo","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-hfTk6MZX.js","utils-Bfp7HcY4.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D8dSW7yV.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CFgQXcZO.js","snippetPresets-dMW1-pV3.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-DyrCOido.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Bwwdcyh3.js","shallow-drVXTg79.js","getApiPlaygroundDisplay-GMPxUzWV.js","CodeSnippet-wTmV0wP6.js","CodeSnippets-D_QxCJEq.js","Page-BsZAA8xk.js","getPastedJson-Dev-X0Xy.js","icon-7L2WL0jD.js","MethodPill-Ble59Dl_.js","DuplicateIcon-r-98uLGh.js","createIcon-DaFzipjW.js","DynamicMarkdown-Jk8YAWGN.js","SectionHeading-nLgrCDOg.js","axios-vUo_bRtp.js","Markdown-_QGow1Wo.js","clsx-v8ssfMzu.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CjboTi0T.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DkAyo-p5.js"]}