Send Cimento’s phishing, training and Agent Hub events to your own systems as they happen: who can set it up, what your endpoint needs, and how to add one.
A webhook endpoint is a URL on your side that Cimento sends an HTTPS request to each time something happens, such as an employee clicking a simulation or finishing a training. Use webhooks to feed a SIEM, open tickets, or keep another system in step with Cimento without polling.Each request carries one event as JSON and is signed, so you can check it came from Cimento.
In this guide
Receiving events
What a request looks like, how to answer it, and what to expect about duplicates, order and timing.
Verifying signatures
Check each request with your signing secret, using a Cimento SDK or code you can copy.
Delivery and retries
What happens when your endpoint fails, and how to send events again.
Cimento publishes SDKs for Go and TypeScript. Each verifies a request and returns the event with its data typed.
go get github.com/cimento-ai/cimento-sdk/go/webhooks
npm install @cimento/webhooks
Verifying signatures shows a receiver in each. For other languages, the same page covers the Standard Webhooks libraries and the check itself.
Before you start
Webhooks turned on. Webhooks are turned on for each organization. If you don’t see Webhooks under Admin → Integrations, ask your Cimento contact to turn it on.
A Cimento admin. People in the Admin and Integrations Admin permission groups can manage webhooks. If you were just added to one of those groups, sign out and back in.
An endpoint that meets the requirements below.
Endpoint requirements
Requirement
Detail
HTTPS
The URL must start with https://, with a certificate a browser would trust.
Port 443
No other port is supported.
A public address
The host must be a public name or address. Cimento refuses private, loopback and internal addresses, including when a public name resolves to one.
No credentials in the URL
A URL with a username or password, such as https://user:pass@example.com, is refused. So is one with a # fragment.
Answers within 10 seconds
Respond with any 2xx status within 10 seconds. See Receiving events.
No redirects
Cimento does not follow redirects. A 3xx response counts as a failure.
The URL can be up to 2,048 characters. A query string is allowed, but don’t put a secret in it: use the signature to check that a request is genuine. If your receiver expects a token instead, send it in a custom header.
Add an endpoint
1
Open Webhooks
Go to Admin → Integrations. Under Data & tooling, open Webhooks, then click Add endpoint.
2
Enter the URL
Enter your Endpoint URL. The Description is optional and only shown to your admins, so use it to say what the endpoint is for.
3
Choose the events
Under Events to send, choose one:
All events, including any added later. Your endpoint receives every event, and new kinds of event as Cimento adds them.
Choose events. Tick the events you want. They are grouped under Phishing, Training and Agent Hub, and each group’s checkbox selects all of it.
Webhooks › Add endpoint › Choose events
4
Add custom headers, if your receiver needs them
Under Custom headers, click Add header and enter a name and value for each header your receiver expects. See Custom headers.
5
Copy the signing secret
Click Add endpoint. Cimento shows Your signing secret. Click Copy and store it somewhere safe, such as your secrets manager, then click Done.
The signing secret is shown once
The secret is shown once. If you lose it, rotate the secret to get a new one.
6
Send a test event
On the endpoint’s row, open the ⋯ menu and choose Send test event. Cimento sends a webhook.test event, signed like any other. Click View delivery on the confirmation to see how your endpoint answered.
Your endpoint starts receiving events as they happen. Events from before you added it are not sent.
Each endpoint with its events and status
Custom headers
Some receivers can’t check a signature and expect a token in a request header instead, such as x-api-client-token or X-RunReveal-Token. Add the header to the endpoint, and Cimento sends it with every delivery, including test events and retries. The request is still signed, so a receiver that can check the signature should.
Rule
Details
Up to 10 headers
Each endpoint can have 10 custom headers.
Names
Up to 64 characters: letters, digits, hyphens and the other characters HTTP allows in a header name. Each name can be used once. Case doesn’t matter.
Values
Up to 2,048 printable ASCII characters.
Reserved names
You can’t set Content-Type, Content-Length, Content-Encoding, Host, User-Agent, Connection, Transfer-Encoding, TE, Trailer, Upgrade, Keep-Alive or Expect, or any name that starts with webhook- or proxy-.
Cimento encrypts header values and never shows them again. When you edit an endpoint, each saved header shows Value saved:
To change a value, click Replace and enter the new one.
To stop sending a header, click the ✕ beside it.
If you change the endpoint URL, you must enter every header value again. This stops a saved token from being sent to a receiver it wasn’t meant for.
Manage an endpoint
Each endpoint’s ⋯ menu has:
Action
What it does
View deliveries
Opens the endpoint’s delivery log. Clicking the endpoint’s URL does the same.
Edit
Changes the URL, description, events or custom headers. The signing secret stays the same.
Send test event
Sends a webhook.test event. Available while the endpoint is active.
Rotate secret
Creates a new signing secret. The old one keeps working for 24 hours. See Rotate the secret.
Disable / Enable
Stops or restarts events to the endpoint.
Delete
Removes the endpoint for good.
Things to know
Up to 10 endpoints. Disabled endpoints count toward the limit. Delete one to add another.
Each endpoint gets its own copy. If two endpoints subscribe to the same event, both receive it, with the same event id.
Events aren’t saved up for you. Cimento records an event only if an active endpoint subscribes to it at that moment. Events that happen while an endpoint is disabled, or before you subscribe it to that kind of event, are not sent later.
Disabling or deleting cancels what’s waiting. Deliveries that haven’t been sent yet are cancelled. After you enable an endpoint again, you can retry them.
No fixed source address. Don’t rely on the IP address requests come from to decide whether they are genuine. Verify the signature instead.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Cimento","description":"Setup documentation for security administrators deploying Cimento phishing simulation and security training.","colors":{"primary":"#ef7025","light":"#eec9bc","dark":"#4fa1ab"},"logo":{"light":"https://mintcdn.com/cimento/v0wi2YRA3DkT313c/logo/light.svg?fit=max\u0026auto=format\u0026n=v0wi2YRA3DkT313c\u0026q=85\u0026s=7a3436b9d20a014e858cd2d35957fd63","dark":"https://mintcdn.com/cimento/v0wi2YRA3DkT313c/logo/dark.svg?fit=max\u0026auto=format\u0026n=v0wi2YRA3DkT313c\u0026q=85\u0026s=bff2e924b88020e33c963684ca2925ae"},"favicon":"https://mintcdn.com/cimento/v0wi2YRA3DkT313c/favicon.svg?fit=max\u0026auto=format\u0026n=v0wi2YRA3DkT313c\u0026q=85\u0026s=2f138a61172e2852f8157e6332119c75","navbar":{"links":[{"href":"https://cimento.ai","label":"cimento.ai"}]},"footer":{"links":[{"header":"Legal","items":[{"label":"Privacy policy","href":"https://cimento.ai/privacy-policy"}]}]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cimento","hasAudioNarration":false,"actualSubdomain":"cimento","customDomains":["docs.cimento.ai"],"gitSource":{"type":"github","owner":"cimento-ai","repo":"cimento-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afe24f316d36d907c4230cd","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Agent Hub","count":7},{"language":"default","tag":"Integrations","count":7},{"language":"default","tag":"Phishing","count":7},{"language":"default","tag":"Webhooks","count":7},{"language":"default","tag":"Training","count":5},{"language":"default","tag":"Deploy with your MDM","count":4},{"language":"default","tag":"Getting Started","count":3},{"language":"default","tag":"Event reference","count":3},{"language":"default","tag":"Updates","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"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":"editor-metadata","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},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"webhooks/overview","slug":"/webhooks/overview","pageMetadata":{"title":"Webhooks","sidebarTitle":"Overview","description":"Send Cimento's phishing, training and Agent Hub events to your own systems as they happen: who can set it up, what your endpoint needs, and how to add one.","href":"/webhooks/overview"},"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: \"Send Cimento’s phishing, training and Agent Hub events to your own systems as they happen: who can set it up, what your endpoint needs, and how to add one.\"\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={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,CodeGroup,Frame,Heading,Note,OptimizedImage,Step,Steps,Table,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`A webhook endpoint is a URL on your side that Cimento sends an HTTPS request to each time something happens, such as an employee clicking a simulation or finishing a training. Use webhooks to feed a SIEM, open tickets, or keep another system in step with Cimento without polling.`}),`\n`,_jsx(_components.p,{children:`Each request carries one event as JSON and is signed, so you can check it came from Cimento.`}),`\n`,_jsx(Heading,{level:`2`,id:`in-this-guide`,children:`In this guide`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Receiving events`,href:`/webhooks/receiving-events`,children:_jsx(_components.p,{children:`What a request looks like, how to answer it, and what to expect about duplicates, order and timing.`})}),_jsx(Card,{title:`Verifying signatures`,href:`/webhooks/verifying-signatures`,children:_jsx(_components.p,{children:`Check each request with your signing secret, using a Cimento SDK or code you can copy.`})}),_jsx(Card,{title:`Delivery and retries`,href:`/webhooks/delivery-and-retries`,children:_jsx(_components.p,{children:`What happens when your endpoint fails, and how to send events again.`})}),_jsx(Card,{title:`Event reference`,href:`/webhooks/phishing-events`,children:_jsxs(_components.p,{children:[`Every event, with its fields and an example: `,_jsx(_components.a,{href:`/webhooks/phishing-events`,children:`Phishing`}),`, `,_jsx(_components.a,{href:`/webhooks/training-events`,children:`Training`}),` and `,_jsx(_components.a,{href:`/webhooks/agent-hub-events`,children:`Agent Hub`}),`.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`sdks`,children:`SDKs`}),`\n`,_jsxs(_components.p,{children:[`Cimento publishes SDKs for Go and TypeScript. Each verifies a request and returns the event with its `,_jsx(_components.code,{children:`data`}),` typed.`]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Go`,numberOfLines:`1`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`go`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` get`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` github.com/cimento-ai/cimento-sdk/go/webhooks`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`TypeScript`,numberOfLines:`1`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`npm`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` @cimento/webhooks`})]}),`\n`]})})})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/webhooks/verifying-signatures#verify-with-a-cimento-sdk`,children:`Verifying signatures`}),` shows a receiver in each. For other languages, the same page covers the Standard Webhooks libraries and the check itself.`]}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Webhooks turned on.`}),` Webhooks are turned on for each organization. If you don’t see `,_jsx(_components.strong,{children:`Webhooks`}),` under `,_jsx(_components.strong,{children:`Admin → Integrations`}),`, ask your Cimento contact to turn it on.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A Cimento admin.`}),` People in the `,_jsx(_components.strong,{children:`Admin`}),` and `,_jsx(_components.strong,{children:`Integrations Admin`}),` permission groups can manage webhooks. If you were just added to one of those groups, sign out and back in.`]}),`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`An endpoint that meets the requirements below.`})}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`endpoint-requirements`,children:`Endpoint requirements`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Requirement`}),_jsx(_components.th,{children:`Detail`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`HTTPS`}),_jsxs(_components.td,{children:[`The URL must start with `,_jsx(_components.code,{children:`https://`}),`, with a certificate a browser would trust.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Port 443`}),_jsx(_components.td,{children:`No other port is supported.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A public address`}),_jsx(_components.td,{children:`The host must be a public name or address. Cimento refuses private, loopback and internal addresses, including when a public name resolves to one.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`No credentials in the URL`}),_jsxs(_components.td,{children:[`A URL with a username or password, such as `,_jsx(_components.code,{children:`https://user:pass@example.com`}),`, is refused. So is one with a `,_jsx(_components.code,{children:`#`}),` fragment.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Answers within 10 seconds`}),_jsxs(_components.td,{children:[`Respond with any `,_jsx(_components.code,{children:`2xx`}),` status within 10 seconds. See `,_jsx(_components.a,{href:`/webhooks/receiving-events#respond-quickly`,children:`Receiving events`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`No redirects`}),_jsxs(_components.td,{children:[`Cimento does not follow redirects. A `,_jsx(_components.code,{children:`3xx`}),` response counts as a failure.`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`The URL can be up to 2,048 characters. A query string is allowed, but don’t put a secret in it: use the `,_jsx(_components.a,{href:`/webhooks/verifying-signatures`,children:`signature`}),` to check that a request is genuine. If your receiver expects a token instead, send it in a `,_jsx(_components.a,{href:`#custom-headers`,children:`custom header`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`add-an-endpoint`,children:`Add an endpoint`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Webhooks`,children:_jsxs(_components.p,{children:[`Go to `,_jsx(_components.strong,{children:`Admin → Integrations`}),`. Under `,_jsx(_components.strong,{children:`Data \u0026 tooling`}),`, open `,_jsx(_components.strong,{children:`Webhooks`}),`, then click `,_jsx(_components.strong,{children:`Add endpoint`}),`.`]})}),_jsx(Step,{title:`Enter the URL`,children:_jsxs(_components.p,{children:[`Enter your `,_jsx(_components.strong,{children:`Endpoint URL`}),`. The `,_jsx(_components.strong,{children:`Description`}),` is optional and only shown to your admins, so use it to say what the endpoint is for.`]})}),_jsxs(Step,{title:`Choose the events`,children:[_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Events to send`}),`, choose one:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`All events, including any added later.`}),` Your endpoint receives every event, and new kinds of event as Cimento adds them.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Choose events.`}),` Tick the events you want. They are grouped under `,_jsx(_components.strong,{children:`Phishing`}),`, `,_jsx(_components.strong,{children:`Training`}),` and `,_jsx(_components.strong,{children:`Agent Hub`}),`, and each group’s checkbox selects all of it.`]}),`\n`]}),_jsx(Frame,{caption:`Webhooks › Add endpoint › Choose events`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/add-endpoint.png?fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=8fdfc9e0a19fe5125cdfec9a0b8bd4cd`,alt:`The Add endpoint dialog with an endpoint URL and description entered, Choose events selected, and the Phishing events ticked`,\"data-og-width\":`1064`,width:`1064`,\"data-og-height\":`1132`,height:`1132`,\"data-path\":`images/webhooks/add-endpoint.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/add-endpoint.png?w=280\u0026fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=bc1e835f6e0726c76fdd8cf2758fc7c8 280w, https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/add-endpoint.png?w=560\u0026fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=8fac0141c3fbefa8b847184a1e1b2511 560w, https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/add-endpoint.png?w=840\u0026fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=4c7da2671797f7c2ce7a1e019a87871a 840w, https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/add-endpoint.png?w=1100\u0026fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=d141e6e14b8fd9cf66b775876f9bec3e 1100w, https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/add-endpoint.png?w=1650\u0026fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=ec3a7599bd328ccf1a50abc398895bcc 1650w, https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/add-endpoint.png?w=2500\u0026fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=be02a95c3c89016dba3802247ce058f9 2500w`})})]}),_jsx(Step,{title:`Add custom headers, if your receiver needs them`,children:_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Custom headers`}),`, click `,_jsx(_components.strong,{children:`Add header`}),` and enter a name and value for each header your receiver expects. See `,_jsx(_components.a,{href:`#custom-headers`,children:`Custom headers`}),`.`]})}),_jsxs(Step,{title:`Copy the signing secret`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Add endpoint`}),`. Cimento shows `,_jsx(_components.strong,{children:`Your signing secret`}),`. Click `,_jsx(_components.strong,{children:`Copy`}),` and store it somewhere safe, such as your secrets manager, then click `,_jsx(_components.strong,{children:`Done`}),`.`]}),_jsx(Frame,{caption:`The signing secret is shown once`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/signing-secret.png?fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=efcad34e6656dcdd872e22ce7152aff6`,alt:`The Your signing secret dialog, with the secret hidden, Reveal and Copy buttons, and a Done button`,\"data-og-width\":`1066`,width:`1066`,\"data-og-height\":`538`,height:`538`,\"data-path\":`images/webhooks/signing-secret.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/signing-secret.png?w=280\u0026fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=e12c5e47f845bb8d369df4af37230fbc 280w, https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/signing-secret.png?w=560\u0026fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=167c54ecd37eeb357f665a1ea16f7c39 560w, https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/signing-secret.png?w=840\u0026fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=ae76bc833adee9564454f400b677cbd1 840w, https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/signing-secret.png?w=1100\u0026fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=7d227dadd7257f21aadc09780788ea42 1100w, https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/signing-secret.png?w=1650\u0026fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=ab0b5d06201e8e624e33b4d4d596192f 1650w, https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/signing-secret.png?w=2500\u0026fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=7afd6099fbb59ee787b3cfd691ba4388 2500w`})}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`The secret is shown once. If you lose it, `,_jsx(_components.a,{href:`/webhooks/verifying-signatures#rotate-the-secret`,children:`rotate the secret`}),` to get a new one.`]})})]}),_jsx(Step,{title:`Send a test event`,children:_jsxs(_components.p,{children:[`On the endpoint’s row, open the `,_jsx(_components.strong,{children:`⋯`}),` menu and choose `,_jsx(_components.strong,{children:`Send test event`}),`. Cimento sends a `,_jsx(_components.a,{href:`/webhooks/receiving-events#test-events`,children:_jsx(_components.code,{children:`webhook.test`})}),` event, signed like any other. Click `,_jsx(_components.strong,{children:`View delivery`}),` on the confirmation to see how your endpoint answered.`]})})]}),`\n`,_jsx(_components.p,{children:`Your endpoint starts receiving events as they happen. Events from before you added it are not sent.`}),`\n`,_jsx(Frame,{caption:`Each endpoint with its events and status`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/endpoints.png?fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=14c01d5a3b766943022cedd7f98b5682`,alt:`The Webhooks page listing one endpoint with its URL, description, All events and an Active status, and its actions menu open`,\"data-og-width\":`1568`,width:`1568`,\"data-og-height\":`578`,height:`578`,\"data-path\":`images/webhooks/endpoints.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/endpoints.png?w=280\u0026fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=02998ad0ff4f6eb7c9fe84d59a44f7a0 280w, https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/endpoints.png?w=560\u0026fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=47bd275e1eae81a02d413124409c2335 560w, https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/endpoints.png?w=840\u0026fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=029c0157e9cf84ddb68d83915b8b0057 840w, https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/endpoints.png?w=1100\u0026fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=fe22d1b99c9e8153a155ec40e8cf8b52 1100w, https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/endpoints.png?w=1650\u0026fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=e3b67bcb7b805cd8f7da1ef75a65de0d 1650w, https://mintcdn.com/cimento/n6nGSMtgFNGbPpHJ/images/webhooks/endpoints.png?w=2500\u0026fit=max\u0026auto=format\u0026n=n6nGSMtgFNGbPpHJ\u0026q=85\u0026s=d73682937d7e4388ae16f052fe72feb1 2500w`})}),`\n`,_jsx(Heading,{level:`2`,id:`custom-headers`,children:`Custom headers`}),`\n`,_jsxs(_components.p,{children:[`Some receivers can’t check a signature and expect a token in a request header instead, such as `,_jsx(_components.code,{children:`x-api-client-token`}),` or `,_jsx(_components.code,{children:`X-RunReveal-Token`}),`. Add the header to the endpoint, and Cimento sends it with every delivery, including test events and retries. The request is still signed, so a receiver that can check the signature should.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Rule`}),_jsx(_components.th,{children:`Details`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Up to 10 headers`}),_jsx(_components.td,{children:`Each endpoint can have 10 custom headers.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Names`}),_jsx(_components.td,{children:`Up to 64 characters: letters, digits, hyphens and the other characters HTTP allows in a header name. Each name can be used once. Case doesn’t matter.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Values`}),_jsx(_components.td,{children:`Up to 2,048 printable ASCII characters.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Reserved names`}),_jsxs(_components.td,{children:[`You can’t set `,_jsx(_components.code,{children:`Content-Type`}),`, `,_jsx(_components.code,{children:`Content-Length`}),`, `,_jsx(_components.code,{children:`Content-Encoding`}),`, `,_jsx(_components.code,{children:`Host`}),`, `,_jsx(_components.code,{children:`User-Agent`}),`, `,_jsx(_components.code,{children:`Connection`}),`, `,_jsx(_components.code,{children:`Transfer-Encoding`}),`, `,_jsx(_components.code,{children:`TE`}),`, `,_jsx(_components.code,{children:`Trailer`}),`, `,_jsx(_components.code,{children:`Upgrade`}),`, `,_jsx(_components.code,{children:`Keep-Alive`}),` or `,_jsx(_components.code,{children:`Expect`}),`, or any name that starts with `,_jsx(_components.code,{children:`webhook-`}),` or `,_jsx(_components.code,{children:`proxy-`}),`.`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Cimento encrypts header values and never shows them again. When you edit an endpoint, each saved header shows `,_jsx(_components.strong,{children:`Value saved`}),`:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`To change a value, click `,_jsx(_components.strong,{children:`Replace`}),` and enter the new one.`]}),`\n`,_jsxs(_components.li,{children:[`To stop sending a header, click the `,_jsx(_components.strong,{children:`✕`}),` beside it.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`If you change the endpoint URL, you must enter every header value again. This stops a saved token from being sent to a receiver it wasn’t meant for.`})}),`\n`,_jsx(Heading,{level:`2`,id:`manage-an-endpoint`,children:`Manage an endpoint`}),`\n`,_jsxs(_components.p,{children:[`Each endpoint’s `,_jsx(_components.strong,{children:`⋯`}),` menu has:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Action`}),_jsx(_components.th,{children:`What it does`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`View deliveries`})}),_jsxs(_components.td,{children:[`Opens the endpoint’s `,_jsx(_components.a,{href:`/webhooks/delivery-and-retries#the-delivery-log`,children:`delivery log`}),`. Clicking the endpoint’s URL does the same.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Edit`})}),_jsxs(_components.td,{children:[`Changes the URL, description, events or `,_jsx(_components.a,{href:`#custom-headers`,children:`custom headers`}),`. The signing secret stays the same.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Send test event`})}),_jsxs(_components.td,{children:[`Sends a `,_jsx(_components.code,{children:`webhook.test`}),` event. Available while the endpoint is active.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Rotate secret`})}),_jsxs(_components.td,{children:[`Creates a new signing secret. The old one keeps working for 24 hours. See `,_jsx(_components.a,{href:`/webhooks/verifying-signatures#rotate-the-secret`,children:`Rotate the secret`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Disable`}),` / `,_jsx(_components.strong,{children:`Enable`})]}),_jsx(_components.td,{children:`Stops or restarts events to the endpoint.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Delete`})}),_jsx(_components.td,{children:`Removes the endpoint for good.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`things-to-know`,children:`Things to know`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Up to 10 endpoints.`}),` Disabled endpoints count toward the limit. Delete one to add another.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Each endpoint gets its own copy.`}),` If two endpoints subscribe to the same event, both receive it, with the same event `,_jsx(_components.code,{children:`id`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Events aren’t saved up for you.`}),` Cimento records an event only if an active endpoint subscribes to it at that moment. Events that happen while an endpoint is disabled, or before you subscribe it to that kind of event, are not sent later.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Disabling or deleting cancels what’s waiting.`}),` Deliveries that haven’t been sent yet are cancelled. After you enable an endpoint again, you can `,_jsx(_components.a,{href:`/webhooks/delivery-and-retries#send-deliveries-again`,children:`retry them`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`No fixed source address.`}),` Don’t rely on the IP address requests come from to decide whether they are genuine. Verify the signature instead.`]}),`\n`]})]})}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":"Webhooks","sidebarTitle":"Overview","description":"Send Cimento's phishing, training and Agent Hub events to your own systems as they happen: who can set it up, what your endpoint needs, and how to add one.","href":"/webhooks/overview"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"In this guide","slug":"in-this-guide","depth":2,"children":[]},{"title":"SDKs","slug":"sdks","depth":2,"children":[]},{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"Endpoint requirements","slug":"endpoint-requirements","depth":2,"children":[]},{"title":"Add an endpoint","slug":"add-an-endpoint","depth":2,"children":[]},{"title":"Custom headers","slug":"custom-headers","depth":2,"children":[]},{"title":"Manage an endpoint","slug":"manage-an-endpoint","depth":2,"children":[]},{"title":"Things to know","slug":"things-to-know","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"cimento","siteName":"Cimento","title":"Webhooks - Cimento","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T22:14:10.040Z","originalFileLocation":"webhooks/overview.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=\"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=\"Send Cimento\u0026#x27;s phishing, training and Agent Hub events to your own systems as they happen: who can set it up, what your endpoint needs, and how to add one.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cimento\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cimento/qgeEwfTN-9uV7GQH/_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/cimento/qgeEwfTN-9uV7GQH/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cimento/qgeEwfTN-9uV7GQH/_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/cimento/qgeEwfTN-9uV7GQH/_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/cimento/qgeEwfTN-9uV7GQH/_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/cimento/qgeEwfTN-9uV7GQH/_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/cimento/qgeEwfTN-9uV7GQH/_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/cimento/qgeEwfTN-9uV7GQH/_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/cimento/qgeEwfTN-9uV7GQH/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Webhooks - Cimento\">\u003cmeta data-mint-head property=\"og:description\" content=\"Send Cimento\u0026#x27;s phishing, training and Agent Hub events to your own systems as they happen: who can set it up, what your endpoint needs, and how to add one.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cimento\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cimento.ai/webhooks/overview\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cimento.mintlify.site/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Webhooks\u0026amp;description=Send+Cimento%27s+phishing%2C+training+and+Agent+Hub+events+to+your+own+systems+as+they+happen%3A+who+can+set+it+up%2C+what+your+endpoint+needs%2C+and+how+to+add+one.\u0026amp;theme=252e6b1e81af8d9b3946c939\u0026amp;signature=3f09726f4a872829876ed23cf6c8e6c1166d9cbb9c8d1cbd48d162a3adc13900\">\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=\"Webhooks - Cimento\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Send Cimento\u0026#x27;s phishing, training and Agent Hub events to your own systems as they happen: who can set it up, what your endpoint needs, and how to add one.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cimento.mintlify.site/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Webhooks\u0026amp;description=Send+Cimento%27s+phishing%2C+training+and+Agent+Hub+events+to+your+own+systems+as+they+happen%3A+who+can+set+it+up%2C+what+your+endpoint+needs%2C+and+how+to+add+one.\u0026amp;theme=252e6b1e81af8d9b3946c939\u0026amp;signature=3f09726f4a872829876ed23cf6c8e6c1166d9cbb9c8d1cbd48d162a3adc13900\">\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/cimento/qgeEwfTN-9uV7GQH/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cimento\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ef7025\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cimento.ai/webhooks/overview\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/webhooks/overview.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cimento.ai/#organization\",\"name\":\"Cimento\",\"url\":\"https://docs.cimento.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cimento/v0wi2YRA3DkT313c/logo/light.svg?fit=max\u0026auto=format\u0026n=v0wi2YRA3DkT313c\u0026q=85\u0026s=7a3436b9d20a014e858cd2d35957fd63\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cimento.ai#website\",\"name\":\"Cimento\",\"url\":\"https://docs.cimento.ai\",\"publisher\":{\"@id\":\"https://docs.cimento.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cimento.ai/webhooks/overview#webpage\",\"url\":\"https://docs.cimento.ai/webhooks/overview\",\"name\":\"Webhooks\",\"description\":\"Send Cimento's phishing, training and Agent Hub events to your own systems as they happen: who can set it up, what your endpoint needs, and how to add one.\",\"dateModified\":\"2026-11-18T22:14:10.040Z\",\"isPartOf\":{\"@id\":\"https://docs.cimento.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cimento.ai/webhooks/overview#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cimento.ai/webhooks/overview#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cimento\",\"item\":\"https://docs.cimento.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Webhooks\",\"item\":\"https://docs.cimento.ai/webhooks/overview\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cimento.ai/webhooks/overview#article\",\"headline\":\"Webhooks\",\"name\":\"Webhooks\",\"description\":\"Send Cimento's phishing, training and Agent Hub events to your own systems as they happen: who can set it up, what your endpoint needs, and how to add one.\",\"url\":\"https://docs.cimento.ai/webhooks/overview\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cimento.ai/webhooks/overview#webpage\"},\"dateModified\":\"2026-11-18T22:14:10.040Z\",\"publisher\":{\"@id\":\"https://docs.cimento.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cimento.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cimento\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cimento\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/webhooks/overview.md","siteName":"Cimento","nav":{"global":null,"groups":[{"group":"Getting Started","icon":"rocket","pages":[{"title":"Cimento Documentation","sidebarTitle":"Welcome","icon":"house","href":"/index"},{"title":"Before you begin","href":"/getting-started/before-you-begin"},{"title":"Connect your employee directory","sidebarTitle":"Employee directory","href":"/getting-started/employee-directory"}]},{"group":"Integrations","icon":"plug","pages":[{"title":"Integrations","sidebarTitle":"Overview","href":"/integrations/overview"},{"title":"Connect Okta","sidebarTitle":"Okta","href":"/integrations/okta"},{"title":"Connect Microsoft Entra ID","sidebarTitle":"Microsoft Entra ID","href":"/integrations/microsoft-entra-id"},{"title":"Connect Google Workspace","sidebarTitle":"Google Workspace","href":"/integrations/google-workspace"},{"title":"Connect Microsoft 365","sidebarTitle":"Microsoft 365","href":"/integrations/microsoft-365"},{"title":"Phish Alert Button for Outlook","sidebarTitle":"Phish Alert Button for Outlook","href":"/integrations/outlook-phish-alert-button"},{"title":"Connect Slack","sidebarTitle":"Slack","description":"Send Cimento's training and remediation notifications as Slack direct messages, step by step, with every Slack permission explained.","href":"/integrations/slack"}]},{"group":"Webhooks","icon":"webhook","pages":[{"title":"Webhooks","sidebarTitle":"Overview","href":"/webhooks/overview"},{"title":"Receiving events","description":"What Cimento sends to your webhook endpoint, how to answer it, and what to expect about duplicates, order and timing.","href":"/webhooks/receiving-events"},{"title":"Verifying signatures","href":"/webhooks/verifying-signatures"},{"title":"Delivery and retries","href":"/webhooks/delivery-and-retries"},{"group":"Event reference","pages":[{"title":"Phishing events","href":"/webhooks/phishing-events"},{"title":"Training events","href":"/webhooks/training-events"},{"title":"Agent Hub events","href":"/webhooks/agent-hub-events"}]}]},{"group":"Phishing","icon":"fish","pages":[{"title":"Phishing simulation overview","sidebarTitle":"Overview","href":"/phishing/overview"},{"title":"AutoPhish","sidebarTitle":"AutoPhish","href":"/phishing/autophish"},{"title":"AutoPhish review and results","sidebarTitle":"AutoPhish results","href":"/phishing/autophish-results"},{"title":"Connect email delivery","sidebarTitle":"Email delivery","href":"/phishing/email-delivery"},{"title":"Mailbox permissions for direct delivery","sidebarTitle":"Mailbox permissions","href":"/phishing/mailbox-permissions"},{"title":"SMS and voice simulations","sidebarTitle":"SMS and voice","href":"/phishing/sms-and-voice"},{"title":"Templates and campaigns","sidebarTitle":"Campaigns","href":"/phishing/campaigns"}]},{"group":"Training","icon":"graduation-cap","pages":[{"title":"Training overview","sidebarTitle":"Overview","href":"/training/overview"},{"title":"Training content","sidebarTitle":"Content","href":"/training/content"},{"title":"Training campaigns","sidebarTitle":"Campaigns","href":"/training/campaigns"},{"title":"Send training emails from your domain","sidebarTitle":"Sending from your domain","href":"/training/sending-domain"},{"title":"Policy acknowledgments","sidebarTitle":"Policies","href":"/training/policies"}]},{"group":"Agent Hub","icon":"bot","pages":[{"title":"Agent Hub overview","sidebarTitle":"Overview","href":"/agent-hub/overview"},{"title":"How the Agent Hub endpoint agent works","sidebarTitle":"How it works","href":"/agent-hub/how-it-works"},{"title":"What data Agent Hub collects","sidebarTitle":"Data collected","href":"/agent-hub/data-collected"},{"group":"Deploy with your MDM","pages":[{"title":"Deploy Agent Hub with Jamf Pro","sidebarTitle":"Jamf Pro","href":"/agent-hub/deploy/jamf"},{"title":"Deploy Agent Hub with Iru","sidebarTitle":"Iru","href":"/agent-hub/deploy/iru"},{"title":"Deploy Agent Hub with SimpleMDM","sidebarTitle":"SimpleMDM","href":"/agent-hub/deploy/simplemdm"},{"title":"Deploy Agent Hub with Microsoft Intune","sidebarTitle":"Microsoft Intune","href":"/agent-hub/deploy/intune"}]}]},{"group":"Updates","icon":"clock-rotate-left","pages":[{"title":"Changelog","icon":"clock-rotate-left","href":"/changelog"}]}]},"basePath":"","title":"Webhooks - Cimento","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-BRsfsIIG.js","DynamicMarkdown-NFqqduU7.js","zoom-image-lightbox-BguUeq2N.js","lightbox-handle-r17bVUz3.js"]}