When iklim.co delivers an alarm to your webhook endpoint, it attaches the credentials you configured during alarm registration. The exact mechanism depends on the authentication type you selected:
After receiving an alarm payload, your webhook endpoint must respond with HTTP 200 and a JSON body conforming to the AlarmReceived schema. iklim.co uses both the HTTP status code and the body-level status field to decide whether delivery was successful or should be retried.
Echo back the id from the received alarm payload exactly as-is. iklim.co compares this value against the dispatched alarm’s id for correlation — a mismatch is treated as a transient failure and triggers a retry.
status
enum
Processing outcome reported by your endpoint (see status table below).
timeEpochMillis
number
Unix epoch timestamp in milliseconds at which your endpoint processed the alarm.
Your system has opted out of further deliveries for this alarm.
Stop retrying, move to the next alarm.
FAILURE
Transient error on your side (e.g. downstream service unavailable).
Run retry policy.
TIMEOUT
Your endpoint timed out internally while processing the alarm.
Run retry policy.
UNKNOWN
Unexpected condition; cause is unclear.
Run retry policy.
iklim.co evaluates the HTTP status code before inspecting the response body. Non-2xx responses never reach body-level evaluation.
HTTP
Body status
Reason
Action
200
SUCCESS
Processed successfully
Stop retrying
200
CANCELLED
Endpoint opted out
Stop retrying
200
FAILURE
Transient recipient-side error
Retry
200
TIMEOUT
Recipient-side timeout
Retry
200
UNKNOWN
Unexpected recipient-side error
Retry
200
id mismatch or null body
Correlation check failed
Retry
400
—
Payload corrupted / missing fields
Retry
401
—
Authorization invalid or missing
Stop retrying
403
—
Access denied
Stop retrying
404
—
Endpoint resource not found
Stop retrying
405
—
HTTP method not allowed
Stop retrying
429
—
Rate limit exceeded
Retry
500
—
Unexpected server-side error
Retry
502
—
Invalid upstream response
Retry
503
—
Service temporarily unavailable
Retry
504
—
Upstream gateway timeout
Retry
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"iklim.co API Documentation","colors":{"primary":"#0066FF","light":"#cce0ff","dark":"#0552c8"},"logo":{"light":"https://mintcdn.com/iklimco/LsrMAyjk3mTN665c/logo/logo-primary.svg?fit=max\u0026auto=format\u0026n=LsrMAyjk3mTN665c\u0026q=85\u0026s=91b7252444bc2f59317716cac1669e20","dark":"https://mintcdn.com/iklimco/LsrMAyjk3mTN665c/logo/logo-white.svg?fit=max\u0026auto=format\u0026n=LsrMAyjk3mTN665c\u0026q=85\u0026s=9da1fec16b3ebbccaf5b1eff6175e5e7"},"favicon":"https://mintcdn.com/iklimco/_DMLSo5goc8NgvQb/favicon.ico?fit=max\u0026auto=format\u0026n=_DMLSo5goc8NgvQb\u0026q=85\u0026s=8d9e76919402195bfd85a160afcc075a","api":{"playground":{"display":"simple"}},"navbar":{"links":[{"href":"mailto:info@iklim.co","label":"Support"}],"primary":{"type":"button","label":"Production Status","href":"https://uptime.tarla.io/status/iklim-prod-ops"}},"footer":{"socials":{"x":"https://x.com/iklimco","github":"https://github.com/iklim-co","linkedin":"https://www.linkedin.com/company/iklim.co"}},"styling":{"eyebrows":"breadcrumbs","latex":false},"navigation":{"global":{"anchors":[]},"languages":[{"language":"en","href":"before-start/en/introduction"},{"language":"tr","href":"before-start/tr/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"iklimco","hasAudioNarration":false,"actualSubdomain":"iklimco","customDomains":["api-docs.iklim.co"],"gitSource":{"type":"github","owner":"iklim-co","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ac64fb15f9d0a6c52acadc1","collectionId":"3749f3e5-ba3e-439b-9a12-b053149e2302","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ac64fb15f9d0a6c52acadc1"},"entitlements":{},"buildId":"6ac64fb15f9d0a6c52acadc1","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"en","tag":"Auth \u0026 User APIs","count":13},{"language":"tr","tag":"Kimlik Doğrulama \u0026 Kullanıcılar","count":13},{"language":"en","tag":"Region Alarm API","count":12},{"language":"en","tag":"Geo Alarm Registrations","count":12},{"language":"tr","tag":"Coğrafi Alan Alarm API","count":12},{"language":"tr","tag":"Coğrafi Alarm Kayıtları","count":12},{"language":"en","tag":"Forecast Alarm API","count":10},{"language":"en","tag":"Forecast Point Alarm Registrations","count":10},{"language":"tr","tag":"Tahnin Alarm API","count":10},{"language":"tr","tag":"Tahmin Nokta Alarm Kayıtları","count":10},{"language":"en","tag":"User Service","count":9},{"language":"tr","tag":"Kullanıcı Servisi","count":9},{"language":"en","tag":"Accounts API","count":8},{"language":"en","tag":"User Accounts Service","count":8},{"language":"tr","tag":"Hesaplar","count":8},{"language":"tr","tag":"Kullanıcı Hesapları Servisi","count":8},{"language":"en","tag":"Precipitation API","count":7},{"language":"en","tag":"Point Alarm API","count":6},{"language":"tr","tag":"Nokta Alarm API","count":6},{"language":"tr","tag":"Nokta Alarmları","count":6}]},"assistantConfig":{},"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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"html.dark[data-current-path^=\"/api-reference/\"] #content-area header .prose pre.shiki{background-color:var(--shiki-dark-bg, #0b0c0e)!important;color:var(--shiki-dark, #d4d4d4)!important}"}],"page":{"pagePath":"webhook-messages/en/webhook-endpoint-guide","slug":"/webhook-messages/en/webhook-endpoint-guide","pageMetadata":{"title":"Webhook Endpoint Guide","icon":"server","description":"Authentication and response requirements shared across all iklim.co webhook alarm deliveries.","href":"/webhook-messages/en/webhook-endpoint-guide"},"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: \"Authentication and response requirements shared across all iklim.co webhook alarm deliveries.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,hr:`hr`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Tab,Table,Tabs,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`incoming-request-authentication`,children:`Incoming request authentication`}),`\n`,_jsx(_components.p,{children:`When iklim.co delivers an alarm to your webhook endpoint, it attaches the credentials you configured during alarm registration. The exact mechanism depends on the authentication type you selected:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Auth type`}),_jsx(_components.th,{children:`How credentials are sent`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Basic`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Authorization: Basic \u003cbase64(username:password)>`}),` header`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`API Key — as header`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`X-API-Key: \u003cyour-api-key>`}),` header`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`API Key — as query parameter`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`?apiKey=\u003cyour-api-key>`}),` appended to the URL`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`JWT`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Authorization: Bearer \u003cjwt-token>`}),` header`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`HMAC Signature`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`X-Client-Id`}),`, `,_jsx(_components.code,{children:`X-Signature`}),`, `,_jsx(_components.code,{children:`X-HmacAlgorithm`}),`, `,_jsx(_components.code,{children:`X-Timestamp`}),`, `,_jsx(_components.code,{children:`X-Nonce`}),` headers`]})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`If you chose `,_jsx(_components.strong,{children:`API Key`}),` authentication, exactly one of the two delivery modes (`,_jsx(_components.code,{children:`asHeader`}),` or `,_jsx(_components.code,{children:`asQueryParameter`}),`) is active — never both at the same time.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`your-endpoint’s-response`,children:`Your endpoint’s response`}),`\n`,_jsxs(_components.p,{children:[`After receiving an alarm payload, your webhook endpoint must respond with HTTP `,_jsx(_components.code,{children:`200`}),` and a JSON body conforming to the `,_jsx(_components.code,{children:`AlarmReceived`}),` schema. iklim.co uses both the HTTP status code and the body-level `,_jsx(_components.code,{children:`status`}),` field to decide whether delivery was successful or should be retried.`]}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`Expected response 💾`,icon:`code`,id:`expected-response-%F0%9F%92%BE`,children:_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"a1b2c3d4-0000-4e5f-9876-000000000001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"SUCCESS\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timeEpochMillis\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1726286415123`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})}),_jsxs(Tab,{title:`Response fields 📚`,icon:`table-list`,id:`response-fields-%F0%9F%93%9A`,\"data-child-heading-ids\":`[\"status-values\"]`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`id`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Echo back the `,_jsx(_components.code,{children:`id`}),` from the received alarm payload exactly as-is. iklim.co compares this value against the dispatched alarm’s `,_jsx(_components.code,{children:`id`}),` for correlation — a mismatch is treated as a transient failure and triggers a retry.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.td,{children:`enum`}),_jsx(_components.td,{children:`Processing outcome reported by your endpoint (see status table below).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`timeEpochMillis`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Unix epoch timestamp in milliseconds at which your endpoint processed the alarm.`})]})]})]}),_jsxs(Heading,{level:`4`,id:`status-values`,children:[_jsx(_components.code,{children:`Status`}),` values`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Meaning`}),_jsx(_components.th,{children:`iklim.co action`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`SUCCESS`})}),_jsx(_components.td,{children:`Alarm was received and processed successfully.`}),_jsx(_components.td,{children:`Stop retrying, move to the next alarm.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`CANCELLED`})}),_jsx(_components.td,{children:`Your system has opted out of further deliveries for this alarm.`}),_jsx(_components.td,{children:`Stop retrying, move to the next alarm.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`FAILURE`})}),_jsx(_components.td,{children:`Transient error on your side (e.g. downstream service unavailable).`}),_jsx(_components.td,{children:`Run retry policy.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`TIMEOUT`})}),_jsx(_components.td,{children:`Your endpoint timed out internally while processing the alarm.`}),_jsx(_components.td,{children:`Run retry policy.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`UNKNOWN`})}),_jsx(_components.td,{children:`Unexpected condition; cause is unclear.`}),_jsx(_components.td,{children:`Run retry policy.`})]})]})]})]}),_jsxs(Tab,{title:`HTTP status matrix 🔍`,icon:`list-check`,id:`http-status-matrix-%F0%9F%94%8D`,children:[_jsxs(_components.p,{children:[`iklim.co evaluates the HTTP status code `,_jsx(_components.strong,{children:`before`}),` inspecting the response body. Non-2xx responses never reach body-level evaluation.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:`Body status`}),_jsx(_components.th,{children:`Reason`}),_jsx(_components.th,{children:`Action`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`200`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`SUCCESS`})}),_jsx(_components.td,{children:`Processed successfully`}),_jsx(_components.td,{children:`Stop retrying`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`200`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`CANCELLED`})}),_jsx(_components.td,{children:`Endpoint opted out`}),_jsx(_components.td,{children:`Stop retrying`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`200`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`FAILURE`})}),_jsx(_components.td,{children:`Transient recipient-side error`}),_jsx(_components.td,{children:`Retry`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`200`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`TIMEOUT`})}),_jsx(_components.td,{children:`Recipient-side timeout`}),_jsx(_components.td,{children:`Retry`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`200`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`UNKNOWN`})}),_jsx(_components.td,{children:`Unexpected recipient-side error`}),_jsx(_components.td,{children:`Retry`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`200`}),_jsx(_components.td,{children:`id mismatch or null body`}),_jsx(_components.td,{children:`Correlation check failed`}),_jsx(_components.td,{children:`Retry`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Payload corrupted / missing fields`}),_jsx(_components.td,{children:`Retry`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Authorization invalid or missing`}),_jsx(_components.td,{children:`Stop retrying`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Access denied`}),_jsx(_components.td,{children:`Stop retrying`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Endpoint resource not found`}),_jsx(_components.td,{children:`Stop retrying`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`405`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`HTTP method not allowed`}),_jsx(_components.td,{children:`Stop retrying`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Rate limit exceeded`}),_jsx(_components.td,{children:`Retry`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Unexpected server-side error`}),_jsx(_components.td,{children:`Retry`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`502`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Invalid upstream response`}),_jsx(_components.td,{children:`Retry`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`503`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Service temporarily unavailable`}),_jsx(_components.td,{children:`Retry`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`504`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Upstream gateway timeout`}),_jsx(_components.td,{children:`Retry`})]})]})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Webhook Endpoint Guide","icon":"server","description":"Authentication and response requirements shared across all iklim.co webhook alarm deliveries.","href":"/webhook-messages/en/webhook-endpoint-guide"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Incoming request authentication","slug":"incoming-request-authentication","depth":2,"children":[]},{"title":"Your endpoint’s response","slug":"your-endpoint’s-response","depth":2,"children":[{"title":"Status values","slug":"status-values","depth":4,"children":[],"tabId":"response-fields-%F0%9F%93%9A"}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"iklimco","siteName":"iklim.co API Documentation","title":"Webhook Endpoint Guide - iklim.co API Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/webhook-messages/en/webhook-endpoint-guide","matchLevel":0},"tr":{"href":"/webhook-messages/tr/webhook-endpoint-guide","matchLevel":1}}},"lastModified":"2026-09-20T16:17:50.969Z","originalFileLocation":"webhook-messages/en/webhook-endpoint-guide.mdx","locale":"en"},"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=\"system\"}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=\"Authentication and response requirements shared across all iklim.co webhook alarm deliveries.\">\u003cmeta data-mint-head name=\"application-name\" content=\"iklim.co API 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/iklimco/s7XYvTG33QJSx4wx/_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/iklimco/s7XYvTG33QJSx4wx/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/iklimco/s7XYvTG33QJSx4wx/_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/iklimco/s7XYvTG33QJSx4wx/_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/iklimco/s7XYvTG33QJSx4wx/_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/iklimco/s7XYvTG33QJSx4wx/_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/iklimco/s7XYvTG33QJSx4wx/_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/iklimco/s7XYvTG33QJSx4wx/_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/iklimco/s7XYvTG33QJSx4wx/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Webhook Endpoint Guide - iklim.co API Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Authentication and response requirements shared across all iklim.co webhook alarm deliveries.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"iklim.co API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://api-docs.iklim.co/webhook-messages/en/webhook-endpoint-guide\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://iklimco.mintlify.app/_mintlify/api/og/v2?division=Webhook+Alarms\u0026amp;title=Webhook+Endpoint+Guide\u0026amp;description=Authentication+and+response+requirements+shared+across+all+iklim.co+webhook+alarm+deliveries.\u0026amp;theme=393d0c1a864ee38939794074\u0026amp;signature=f682495691aec5f3915cc174fc5dbe6e2672bdaec1998998554fb157d8d8a60e\">\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=\"Webhook Endpoint Guide - iklim.co API Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Authentication and response requirements shared across all iklim.co webhook alarm deliveries.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://iklimco.mintlify.app/_mintlify/api/og/v2?division=Webhook+Alarms\u0026amp;title=Webhook+Endpoint+Guide\u0026amp;description=Authentication+and+response+requirements+shared+across+all+iklim.co+webhook+alarm+deliveries.\u0026amp;theme=393d0c1a864ee38939794074\u0026amp;signature=f682495691aec5f3915cc174fc5dbe6e2672bdaec1998998554fb157d8d8a60e\">\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/iklimco/s7XYvTG33QJSx4wx/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"iklim.co API Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0066FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://api-docs.iklim.co/webhook-messages/en/webhook-endpoint-guide\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/webhook-messages/en/webhook-endpoint-guide.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://api-docs.iklim.co/webhook-messages/en/webhook-endpoint-guide\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"tr\" href=\"https://api-docs.iklim.co/webhook-messages/tr/webhook-endpoint-guide\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://api-docs.iklim.co/webhook-messages/en/webhook-endpoint-guide\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://api-docs.iklim.co/#organization\",\"name\":\"iklim.co API Documentation\",\"url\":\"https://api-docs.iklim.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/iklimco/LsrMAyjk3mTN665c/logo/logo-primary.svg?fit=max\u0026auto=format\u0026n=LsrMAyjk3mTN665c\u0026q=85\u0026s=91b7252444bc2f59317716cac1669e20\"}},{\"@type\":\"WebSite\",\"@id\":\"https://api-docs.iklim.co#website\",\"name\":\"iklim.co API Documentation\",\"url\":\"https://api-docs.iklim.co\",\"publisher\":{\"@id\":\"https://api-docs.iklim.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://api-docs.iklim.co/webhook-messages/en/webhook-endpoint-guide#webpage\",\"url\":\"https://api-docs.iklim.co/webhook-messages/en/webhook-endpoint-guide\",\"name\":\"Webhook Endpoint Guide\",\"description\":\"Authentication and response requirements shared across all iklim.co webhook alarm deliveries.\",\"dateModified\":\"2026-09-20T16:17:50.969Z\",\"isPartOf\":{\"@id\":\"https://api-docs.iklim.co#website\"},\"breadcrumb\":{\"@id\":\"https://api-docs.iklim.co/webhook-messages/en/webhook-endpoint-guide#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://api-docs.iklim.co/webhook-messages/en/webhook-endpoint-guide#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"iklim.co API Documentation\",\"item\":\"https://api-docs.iklim.co\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Webhook Endpoint Guide\",\"item\":\"https://api-docs.iklim.co/webhook-messages/en/webhook-endpoint-guide\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://api-docs.iklim.co/webhook-messages/en/webhook-endpoint-guide#article\",\"headline\":\"Webhook Endpoint Guide\",\"name\":\"Webhook Endpoint Guide\",\"description\":\"Authentication and response requirements shared across all iklim.co webhook alarm deliveries.\",\"url\":\"https://api-docs.iklim.co/webhook-messages/en/webhook-endpoint-guide\",\"mainEntityOfPage\":{\"@id\":\"https://api-docs.iklim.co/webhook-messages/en/webhook-endpoint-guide#webpage\"},\"dateModified\":\"2026-09-20T16:17:50.969Z\",\"publisher\":{\"@id\":\"https://api-docs.iklim.co/#organization\"},\"isPartOf\":{\"@id\":\"https://api-docs.iklim.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"iklim.co API Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"iklim.co API Documentation","nav":{"global":{"anchors":[]},"languages":[{"language":"en","groups":[{"group":"Before You Start","icon":"book","pages":[{"title":"API Security","icon":"shield-halved","href":"/before-start/en/introduction"},{"title":"Authentication","icon":"fingerprint","href":"/before-start/en/authentication"},{"title":"User Settings","icon":"circle-user","description":"This page provides important information about the details required to make API requests, such as language selection, user registration, account activation and account subscription processes.","href":"/before-start/en/final-briefing"}]},{"group":"Webhook Alarms","icon":"comment-dots","pages":[{"title":"Webhook Endpoint Guide","icon":"server","href":"/webhook-messages/en/webhook-endpoint-guide"},{"title":"Lightning Notification","icon":"cloud-bolt","description":"Deep dive into iklim.co lightning strike webhook payloads for automation-ready apps.","href":"/webhook-messages/en/lightning"},{"title":"Thunderstorm Notification","icon":"hurricane","href":"/webhook-messages/en/thunderstorm"},{"title":"Precipitation Notification","icon":"cloud-rain","href":"/webhook-messages/en/precipitation"},{"title":"Forecast Notification","icon":"cloud-sun","href":"/webhook-messages/en/forecast"}]},{"group":"MCP Server","icon":"robot","tag":"NEW","pages":[{"title":"MCP Server","icon":"robot","href":"/pages/en/mcp-server"}]},{"group":"Auth \u0026 User APIs","icon":"user-lock","pages":[{"group":"User Service","pages":[{"title":"Password Reset Operation","deprecated":null,"version":null,"openapi":"/open-api/en/auth-version-1.json post /v1/users/password-reset","href":"/api-reference/user-service/password-reset-operation"},{"title":"Password Reset Request Operation","deprecated":null,"version":null,"openapi":"/open-api/en/auth-version-1.json post /v1/users/password-reset-request","href":"/api-reference/user-service/password-reset-request-operation"},{"title":"Pageable User Listing Operation","deprecated":null,"version":null,"openapi":"/open-api/en/auth-version-1.json post /v1/users/page","href":"/api-reference/user-service/pageable-user-listing-operation"},{"title":"New User Creation Operation","deprecated":null,"version":null,"openapi":"/open-api/en/auth-version-1.json post /v1/users/create","href":"/api-reference/user-service/new-user-creation-operation"},{"title":"Change Password Operation","deprecated":null,"version":null,"openapi":"/open-api/en/auth-version-1.json post /v1/users/change-password","href":"/api-reference/user-service/change-password-operation"},{"title":"User Update Operation","deprecated":null,"version":null,"openapi":"/open-api/en/auth-version-1.json patch /v1/users/update","href":"/api-reference/user-service/user-update-operation"},{"title":"Get User Operation","deprecated":null,"version":null,"openapi":"/open-api/en/auth-version-1.json get /v1/users/{userId}","href":"/api-reference/user-service/get-user-operation"},{"title":"User Unblocking Operation","deprecated":null,"version":null,"openapi":"/open-api/en/auth-version-1.json get /v1/users/unblock/{userId}","href":"/api-reference/user-service/user-unblocking-operation"},{"title":"Get Own User Information Operation","deprecated":null,"version":null,"openapi":"/open-api/en/auth-version-1.json get /v1/users/me","href":"/api-reference/user-service/get-own-user-information-operation"}]},{"group":"Authentication Service","pages":[{"title":"New User Registration","deprecated":null,"version":null,"openapi":"/open-api/en/auth-version-1.json post /v1/auth/register","href":"/api-reference/authentication-service/new-user-registration"},{"title":"Authentication Token Refresh Operation","deprecated":null,"version":null,"openapi":"/open-api/en/auth-version-1.json post /v1/auth/refresh","href":"/api-reference/authentication-service/authentication-token-refresh-operation"},{"title":"Logout Operation","deprecated":null,"version":null,"openapi":"/open-api/en/auth-version-1.json post /v1/auth/logout","href":"/api-reference/authentication-service/logout-operation"},{"title":"Login Operation","deprecated":null,"version":null,"openapi":"/open-api/en/auth-version-1.json post /v1/auth/login","href":"/api-reference/authentication-service/login-operation"}]}]},{"group":"Accounts API","icon":"id-card","pages":[{"group":"User Accounts Service","pages":[{"title":"Update Subscription Plan","deprecated":null,"version":null,"openapi":"/open-api/en/accounts-version-1.json post /v1/accounts/update-subscription","href":"/api-reference/user-accounts-service/update-subscription-plan"},{"title":"Request Phone Number Activation","deprecated":null,"version":null,"openapi":"/open-api/en/accounts-version-1.json post /v1/accounts/phone-number-activation-request","href":"/api-reference/user-accounts-service/request-phone-number-activation"},{"title":"Create Account","deprecated":null,"version":null,"openapi":"/open-api/en/accounts-version-1.json post /v1/accounts/create","href":"/api-reference/user-accounts-service/create-account"},{"title":"Request Account Activation","deprecated":null,"version":null,"openapi":"/open-api/en/accounts-version-1.json post /v1/accounts/account-activation-request","href":"/api-reference/user-accounts-service/request-account-activation"},{"title":"Update Account","deprecated":null,"version":null,"openapi":"/open-api/en/accounts-version-1.json patch /v1/accounts/update","href":"/api-reference/user-accounts-service/update-account"},{"title":"Get Account Details","deprecated":null,"version":null,"openapi":"/open-api/en/accounts-version-1.json get /v1/accounts/{userId}","href":"/api-reference/user-accounts-service/get-account-details"},{"title":"Activate Phone Number","deprecated":null,"version":null,"openapi":"/open-api/en/accounts-version-1.json get /v1/accounts/activate-phone-number","href":"/api-reference/user-accounts-service/activate-phone-number"},{"title":"Activate Account","deprecated":null,"version":null,"openapi":"/open-api/en/accounts-version-1.json get /v1/accounts/activate-account","href":"/api-reference/user-accounts-service/activate-account"}]}]},{"group":"Lightning API","icon":"cloud-bolt","pages":[{"group":"Lightning Service","pages":[{"title":"Within Operation","deprecated":null,"version":null,"openapi":"/open-api/en/lightnings_version-1.json post /v1/lightnings/within","href":"/api-reference/lightning-service/within-operation"},{"title":"Page Operation","deprecated":null,"version":null,"openapi":"/open-api/en/lightnings_version-1.json post /v1/lightnings/page","href":"/api-reference/lightning-service/page-operation"}]}]},{"group":"Thunderstorm API","icon":"hurricane","pages":[{"group":"Thunderstorm Service","pages":[{"title":"Thunderstorm List (Within Radius)","deprecated":null,"version":null,"openapi":"/open-api/en/thunderstorms_version-1.json post /v1/thunderstorms/within","href":"/api-reference/thunderstorm-service/thunderstorm-list-within-radius"},{"title":"Thunderstorm List (Paged)","deprecated":null,"version":null,"openapi":"/open-api/en/thunderstorms_version-1.json post /v1/thunderstorms/page","href":"/api-reference/thunderstorm-service/thunderstorm-list-paged"},{"title":"Get Thunderstorm Details","deprecated":null,"version":null,"openapi":"/open-api/en/thunderstorms_version-1.json post /v1/thunderstorms/get","href":"/api-reference/thunderstorm-service/get-thunderstorm-details"}]}]},{"group":"Precipitation API","icon":"cloud-rain","tag":"UPDATED","pages":[{"title":"Precipitation Geometry","icon":"draw-polygon","tag":"NEW","href":"/pages/en/precipitation-geometry"},{"group":"Precipitation API","pages":[{"title":"Within Operation","deprecated":null,"version":null,"openapi":"/open-api/en/precipitations_version-1.json post /v1/precipitations/within","href":"/api-reference/precipitation-api/within-operation"},{"title":"Page Operation","deprecated":null,"version":null,"openapi":"/open-api/en/precipitations_version-1.json post /v1/precipitations/page","href":"/api-reference/precipitation-api/page-operation"},{"title":"Geometry Operation","deprecated":null,"version":null,"openapi":"/open-api/en/precipitations_version-1.json post /v1/precipitations/geometry","href":"/api-reference/precipitation-api/geometry-operation"}]}]},{"group":"Forecast API","icon":"cloud-sun","tag":"","pages":[{"group":"Forecast Service","pages":[{"title":"Hourly Forecast Operation","deprecated":null,"version":null,"openapi":"/open-api/en/forecasts_version-1.json post /v1/forecasts/hourly","href":"/api-reference/forecast-service/hourly-forecast-operation"},{"title":"Daily Forecast Operation","deprecated":null,"version":null,"openapi":"/open-api/en/forecasts_version-1.json post /v1/forecasts/daily","href":"/api-reference/forecast-service/daily-forecast-operation"},{"title":"Current Forecast Operation","deprecated":null,"version":null,"openapi":"/open-api/en/forecasts_version-1.json post /v1/forecasts/current","href":"/api-reference/forecast-service/current-forecast-operation"}]},{"group":"Weather Icons","pages":[{"title":"Get Weather Icon","deprecated":null,"version":null,"openapi":"/open-api/en/forecasts_version-1.json get /v1/weather-icons/{dayOrNight}/{iconName}","href":"/api-reference/weather-icons/get-weather-icon"}]}]},{"group":"Point Alarm API","icon":"map-pin","tag":"","pages":[{"group":"Point Alarms","pages":[{"title":"Create a point alarm registration","deprecated":null,"version":null,"openapi":"/open-api/en/point-alarm_version-1.json post /v1/alarms/points/register","href":"/api-reference/point-alarms/create-a-point-alarm-registration"},{"title":"List point alarm registrations (paged)","deprecated":null,"version":null,"openapi":"/open-api/en/point-alarm_version-1.json post /v1/alarms/points/page","href":"/api-reference/point-alarms/list-point-alarm-registrations-paged"},{"title":"Update a point alarm registration","deprecated":null,"version":null,"openapi":"/open-api/en/point-alarm_version-1.json patch /v1/alarms/points/update","href":"/api-reference/point-alarms/update-a-point-alarm-registration"},{"title":"List registrations by recipientId","deprecated":null,"version":null,"openapi":"/open-api/en/point-alarm_version-1.json get /v1/alarms/points/get-by-recipient-id/{recipientId}","href":"/api-reference/point-alarms/list-registrations-by-recipientid"},{"title":"Get registration by ID","deprecated":null,"version":null,"openapi":"/open-api/en/point-alarm_version-1.json get /v1/alarms/points/get-by-id/{registrationId}","href":"/api-reference/point-alarms/get-registration-by-id"},{"title":"Delete (unregister) a point alarm registration","deprecated":null,"version":null,"openapi":"/open-api/en/point-alarm_version-1.json delete /v1/alarms/points/unregister/{registrationId}","href":"/api-reference/point-alarms/delete-unregister-a-point-alarm-registration"}]}]},{"group":"Region Alarm API","icon":"vector-square","tag":"","pages":[{"group":"Geo Alarm Registrations","pages":[{"title":"Create registration","deprecated":null,"version":null,"openapi":"/open-api/en/geo-alarm_version-1.json post /v1/alarms/geometries/register","href":"/api-reference/geo-alarm-registrations/create-registration"},{"title":"List registrations (paged)","deprecated":null,"version":null,"openapi":"/open-api/en/geo-alarm_version-1.json post /v1/alarms/geometries/page","href":"/api-reference/geo-alarm-registrations/list-registrations-paged"},{"title":"Update registration","deprecated":null,"version":null,"openapi":"/open-api/en/geo-alarm_version-1.json patch /v1/alarms/geometries/update","href":"/api-reference/geo-alarm-registrations/update-registration"},{"title":"List cities","deprecated":null,"version":null,"openapi":"/open-api/en/geo-alarm_version-1.json get /v1/alarms/geometries/{countryCode}/cities","href":"/api-reference/geo-alarm-registrations/list-cities"},{"title":"List neighbourhoods","deprecated":null,"version":null,"openapi":"/open-api/en/geo-alarm_version-1.json get /v1/alarms/geometries/neighborhoods/{districtId}","href":"/api-reference/geo-alarm-registrations/list-neighbourhoods"},{"title":"Get neighbourhood","deprecated":null,"version":null,"openapi":"/open-api/en/geo-alarm_version-1.json get /v1/alarms/geometries/neighborhood/{neighborhoodId}","href":"/api-reference/geo-alarm-registrations/get-neighbourhood"},{"title":"Get by recipient ID","deprecated":null,"version":null,"openapi":"/open-api/en/geo-alarm_version-1.json get /v1/alarms/geometries/get-by-recipient-id/{recipientId}","href":"/api-reference/geo-alarm-registrations/get-by-recipient-id"},{"title":"Get by registration ID","deprecated":null,"version":null,"openapi":"/open-api/en/geo-alarm_version-1.json get /v1/alarms/geometries/get-by-id/{registrationId}","href":"/api-reference/geo-alarm-registrations/get-by-registration-id"},{"title":"List districts","deprecated":null,"version":null,"openapi":"/open-api/en/geo-alarm_version-1.json get /v1/alarms/geometries/districts/{cityId}","href":"/api-reference/geo-alarm-registrations/list-districts"},{"title":"Get district","deprecated":null,"version":null,"openapi":"/open-api/en/geo-alarm_version-1.json get /v1/alarms/geometries/district/{districtId}","href":"/api-reference/geo-alarm-registrations/get-district"},{"title":"Get city","deprecated":null,"version":null,"openapi":"/open-api/en/geo-alarm_version-1.json get /v1/alarms/geometries/city/{cityId}","href":"/api-reference/geo-alarm-registrations/get-city"},{"title":"Delete registration","deprecated":null,"version":null,"openapi":"/open-api/en/geo-alarm_version-1.json delete /v1/alarms/geometries/unregister/{registrationId}","href":"/api-reference/geo-alarm-registrations/delete-registration"}]}]},{"group":"Forecast Alarm API","icon":"location-dot","pages":[{"group":"Forecast Point Alarm Registrations","pages":[{"title":"Create registration","deprecated":null,"version":null,"openapi":"/open-api/en/forecast-alarm_version-1.json post /v1/alarms/forecasts/register","href":"/api-reference/forecast-point-alarm-registrations/create-registration"},{"title":"List registrations (paged)","deprecated":null,"version":null,"openapi":"/open-api/en/forecast-alarm_version-1.json post /v1/alarms/forecasts/page","href":"/api-reference/forecast-point-alarm-registrations/list-registrations-paged"},{"title":"Update registration","deprecated":null,"version":null,"openapi":"/open-api/en/forecast-alarm_version-1.json patch /v1/alarms/forecasts/update","href":"/api-reference/forecast-point-alarm-registrations/update-registration"},{"title":"List cities","deprecated":null,"version":null,"openapi":"/open-api/en/forecast-alarm_version-1.json get /v1/alarms/forecasts/{countryCode}/cities","href":"/api-reference/forecast-point-alarm-registrations/list-cities"},{"title":"Get by recipient ID","deprecated":null,"version":null,"openapi":"/open-api/en/forecast-alarm_version-1.json get /v1/alarms/forecasts/get-by-recipient-id/{recipientId}","href":"/api-reference/forecast-point-alarm-registrations/get-by-recipient-id"},{"title":"Get by registration ID","deprecated":null,"version":null,"openapi":"/open-api/en/forecast-alarm_version-1.json get /v1/alarms/forecasts/get-by-id/{registrationId}","href":"/api-reference/forecast-point-alarm-registrations/get-by-registration-id"},{"title":"List districts","deprecated":null,"version":null,"openapi":"/open-api/en/forecast-alarm_version-1.json get /v1/alarms/forecasts/districts/{cityId}","href":"/api-reference/forecast-point-alarm-registrations/list-districts"},{"title":"Get district","deprecated":null,"version":null,"openapi":"/open-api/en/forecast-alarm_version-1.json get /v1/alarms/forecasts/district/{districtId}","href":"/api-reference/forecast-point-alarm-registrations/get-district"},{"title":"Get city","deprecated":null,"version":null,"openapi":"/open-api/en/forecast-alarm_version-1.json get /v1/alarms/forecasts/city/{cityId}","href":"/api-reference/forecast-point-alarm-registrations/get-city"},{"title":"Delete registration","deprecated":null,"version":null,"openapi":"/open-api/en/forecast-alarm_version-1.json delete /v1/alarms/forecasts/unregister/{registrationId}","href":"/api-reference/forecast-point-alarm-registrations/delete-registration"}]}]},{"group":"Enroute API","icon":"route","tag":"NEW","pages":[{"title":"Service Details","icon":"route","tag":"NEW","href":"/pages/en/enroute"},{"group":"Enroute","pages":[{"title":"Get route weather","deprecated":null,"version":null,"openapi":"/open-api/en/enroute_version-1.json post /v1/enroute/weather","href":"/api-reference/enroute/get-route-weather"},{"title":"Register a route","deprecated":null,"version":null,"openapi":"/open-api/en/enroute_version-1.json post /v1/enroute/register","href":"/api-reference/enroute/register-a-route"}]}]}]},{"language":"tr","pages":[{"title":"tr","href":"/webhook-messages/tr/webhook-endpoint-guide"}]}]},"title":"Webhook Endpoint Guide - iklim.co API Documentation","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":[],"chunks":[]}
