In order to start listening to messages, you will need to configure your endpoints. Adding an endpoint is as simple as providing a URL that you control and selecting the event types that you want to listen to. The endpoint can be whatever you want, and you can just add them from your webhooks portal. If you don’t specify any event types, by default, your endpoint will receive all events, regardless of type.For example, if you receive webhooks from Sendoso, you can structure your URL like: https://www.example.com/sendoso/webhooks/.Visit the Security tab to learn more about verifying the webhooks from your endpoint application.
Once you’ve added an endpoint, you’ll want to make sure its working. The “Testing” tab lets you send test events to your endpoint. After sending an example event, you can click into the message to view the message payload, all of the message attempts, and whether it succeeded or failed.
⌘I
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Sendoso API","colors":{"primary":"#017481","light":"#80C0C7","dark":"#016772"},"logo":{"light":"https://mintcdn.com/sendoso-39/TWkZIS2yn_Pgh5qO/logo/sendosologo.svg?fit=max\u0026auto=format\u0026n=TWkZIS2yn_Pgh5qO\u0026q=85\u0026s=0059025a44c20c989be9d6e4e7977804","dark":"https://mintcdn.com/sendoso-39/TWkZIS2yn_Pgh5qO/logo/sendosologo.svg?fit=max\u0026auto=format\u0026n=TWkZIS2yn_Pgh5qO\u0026q=85\u0026s=0059025a44c20c989be9d6e4e7977804"},"favicon":"https://mintcdn.com/sendoso-39/TWkZIS2yn_Pgh5qO/favicon.png?fit=max\u0026auto=format\u0026n=TWkZIS2yn_Pgh5qO\u0026q=85\u0026s=2fc2c33a8ed0fb9bb6f80d4f6a10fd9e","api":{"playground":{"display":"interactive"},"mdx":{"auth":{"method":"bearer"},"server":["https://app.staging.sendo.so","https://app.sendoso.com"]}},"background":{"color":{"light":"#FCFDFE","dark":"#1B2630"}},"navbar":{"links":[{"href":"https://sendoso.github.io/technology-radar/index.html","label":"Tech Radar"},{"href":"mailto:developers@sendoso.com","label":"Support"}]},"fonts":{"family":"Bricolage Grotesque"},"icons":{"library":"lucide"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sendoso-39","hasAudioNarration":false,"actualSubdomain":"sendoso-39","customDomains":["developer.sendoso.com"],"gitSource":{"type":"gitlab","owner":"sendoso","repo":"mintlifyapi","deployBranch":"main","contentDirectory":"","isPrivate":true,"projectId":72405615,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adbc53a7715b1982b0bd913","collectionId":"34dec642-79aa-4f87-86c5-3551caff30a6","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adbc53a7715b1982b0bd913"},"entitlements":{},"buildId":"6adbc53a7715b1982b0bd913","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"Getting Started","count":20},{"language":"default","tag":"Sendoso Core API","count":18},{"language":"default","tag":"API Reference","count":16},{"language":"default","tag":"SCIM API","count":8},{"language":"default","tag":"SmartSend / Marketplace API","count":7},{"language":"default","tag":"Webhooks","count":6},{"language":"default","tag":"Sends","count":5},{"language":"default","tag":"Create a Send","count":4},{"language":"default","tag":"SCIM Reference","count":4},{"language":"default","tag":"Users","count":3}]},"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":true},"customCss":[{"filePath":"styles.css","content":":root{--sx-teal:#80C0C7;--sx-teal-strong:#017481;--sx-teal-wash:#E1F0F2;--sx-teal-line:#B3D9DD;--sx-orange:#F37021;--sx-ground:#FCFDFE;--sx-ink:#1F2D37;--sx-active-bg:#E1F0F2;--sx-hover-bg:#E8F4F5}h1,h2,h3,h4{letter-spacing:-.03em}.dark,[data-theme=dark],html.dark{--sx-active-bg:rgba(128, 192, 199, 0.16);--sx-hover-bg:rgba(128, 192, 199, 0.10)}#sidebar a[aria-current=page],#sidebar-content a[aria-current=page],aside a[aria-current=page],nav[aria-label*=idebar] a[aria-current=page]{background-color:var(--sx-active-bg)!important;border-radius:8px!important}#sidebar a:hover,#sidebar-content a:hover,aside nav a:hover,nav[aria-label*=idebar] a:hover{background-color:var(--sx-hover-bg)!important;border-radius:8px!important}"}],"page":{"pagePath":"webhooks/endpoints","slug":"/webhooks/endpoints","pageMetadata":{"title":"Endpoints","icon":"ear","description":null,"href":"/webhooks/endpoints"},"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`,p:`p`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`adding-an-endpoint`,children:`Adding an Endpoint`}),`\n`,_jsx(_components.p,{children:`In order to start listening to messages, you will need to configure your endpoints. Adding an endpoint is as simple as providing a URL that you control and selecting the event types that you want to listen to. The endpoint can be whatever you want, and you can just add them from your webhooks portal. If you don’t specify any event types, by default, your endpoint will receive all events, regardless of type.`}),`\n`,_jsxs(_components.p,{children:[`For example, if you receive webhooks from Sendoso, you can structure your URL like: `,_jsx(_components.a,{href:`https://www.example.com/sendoso/webhooks/`,children:`https://www.example.com/sendoso/webhooks/`}),`.`]}),`\n`,_jsx(_components.p,{children:`Visit the Security tab to learn more about verifying the webhooks from your endpoint application.`}),`\n`,_jsx(Heading,{level:`2`,id:`testing-an-endpoint`,children:`Testing an Endpoint`}),`\n`,_jsx(_components.p,{children:`Once you’ve added an endpoint, you’ll want to make sure its working. The “Testing” tab lets you send test events to your endpoint. After sending an example event, you can click into the message to view the message payload, all of the message attempts, and whether it succeeded or failed.`})]})}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":"Endpoints","icon":"ear","description":null,"href":"/webhooks/endpoints"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Adding an Endpoint","slug":"adding-an-endpoint","depth":2,"children":[]},{"title":"Testing an Endpoint","slug":"testing-an-endpoint","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"sendoso-39","siteName":"Sendoso API","title":"Endpoints - Sendoso API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T20:36:18.540Z","originalFileLocation":"webhooks/endpoints.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=\"application-name\" content=\"Sendoso API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sendoso-39/f5c4CQXU7fHcq7-2/_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/sendoso-39/f5c4CQXU7fHcq7-2/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sendoso-39/f5c4CQXU7fHcq7-2/_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/sendoso-39/f5c4CQXU7fHcq7-2/_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/sendoso-39/f5c4CQXU7fHcq7-2/_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/sendoso-39/f5c4CQXU7fHcq7-2/_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/sendoso-39/f5c4CQXU7fHcq7-2/_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/sendoso-39/f5c4CQXU7fHcq7-2/_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/sendoso-39/f5c4CQXU7fHcq7-2/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Endpoints - Sendoso API\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sendoso API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.sendoso.com/webhooks/endpoints\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sendoso-39.mintlify.app/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Endpoints\u0026amp;theme=65390d924712370c9a5ae392\u0026amp;signature=4640b61d5f5395d1212eda4bcebc3b4478878634a5cbefc1ad4bef7d64cb96d2\">\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=\"Endpoints - Sendoso API\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sendoso-39.mintlify.app/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Endpoints\u0026amp;theme=65390d924712370c9a5ae392\u0026amp;signature=4640b61d5f5395d1212eda4bcebc3b4478878634a5cbefc1ad4bef7d64cb96d2\">\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/sendoso-39/f5c4CQXU7fHcq7-2/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sendoso API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#017481\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.sendoso.com/webhooks/endpoints\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/webhooks/endpoints.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.sendoso.com/#organization\",\"name\":\"Sendoso API\",\"url\":\"https://developer.sendoso.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sendoso-39/TWkZIS2yn_Pgh5qO/logo/sendosologo.svg?fit=max\u0026auto=format\u0026n=TWkZIS2yn_Pgh5qO\u0026q=85\u0026s=0059025a44c20c989be9d6e4e7977804\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.sendoso.com#website\",\"name\":\"Sendoso API\",\"url\":\"https://developer.sendoso.com\",\"publisher\":{\"@id\":\"https://developer.sendoso.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.sendoso.com/webhooks/endpoints#webpage\",\"url\":\"https://developer.sendoso.com/webhooks/endpoints\",\"name\":\"Endpoints\",\"dateModified\":\"2026-10-23T20:36:18.540Z\",\"isPartOf\":{\"@id\":\"https://developer.sendoso.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.sendoso.com/webhooks/endpoints#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.sendoso.com/webhooks/endpoints#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting Started\",\"item\":\"https://developer.sendoso.com/webhooks/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Endpoints\",\"item\":\"https://developer.sendoso.com/webhooks/endpoints\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developer.sendoso.com/webhooks/endpoints#article\",\"headline\":\"Endpoints\",\"name\":\"Endpoints\",\"url\":\"https://developer.sendoso.com/webhooks/endpoints\",\"mainEntityOfPage\":{\"@id\":\"https://developer.sendoso.com/webhooks/endpoints#webpage\"},\"dateModified\":\"2026-10-23T20:36:18.540Z\",\"publisher\":{\"@id\":\"https://developer.sendoso.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.sendoso.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sendoso API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Sendoso API","nav":{"global":null,"tabs":[{"tab":"Sendoso Core API","pages":[{"title":"Sendoso Core API","href":"/rest-api/overview/introduction"}]},{"tab":"SCIM API","pages":[{"title":"SCIM API","href":"/scim/overview/introduction"}]},{"tab":"SmartSend / Marketplace API","pages":[{"title":"SmartSend / Marketplace API","href":"/marketplace/overview/introduction"}]},{"tab":"iFrame","pages":[{"title":"iFrame","href":"/iframe/abouttheiframe"}]},{"tab":"Webhooks","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","icon":"book-open-text","href":"/webhooks/introduction"},{"title":"Events","icon":"webhook","description":null,"href":"/webhooks/events"},{"title":"Endpoints","icon":"ear","href":"/webhooks/endpoints"},{"title":"Security","icon":"shield-check","description":null,"href":"/webhooks/security"},{"title":"Retries","icon":"repeat","href":"/webhooks/retries"},{"title":"Troubleshooting","icon":"wrench","href":"/webhooks/troubleshooting"}]}]},{"tab":"API v5","hidden":true,"pages":[{"title":"API v5","href":"/v5/introduction"}]}]},"title":"Endpoints - Sendoso API","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":[],"chunks":[]}