Arbitrary key-value string pairs to associate with the monitor, echoed back in monitor responses and in every monitor.notification webhook. Use it to map notifications back to your internal records (e.g. a case ID). Calling POST /v2/monitors again for the same company replaces the stored metadata when the field is provided. Limits: max 50 keys, keys up to 40 chars (longer keys are skipped), values up to 500 chars (longer values are truncated).
Present when one or more monitored datapoints for this account are currently blocked on missing account credentials. The monitor is still created (other datapoints are unaffected) but these will not be fetched until resolved.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Topograph","colors":{"primary":"#0D9373","light":"#07C983","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/semaphore/ChRp9mNNuCx3xt6W/logo/logo-dark.svg?fit=max\u0026auto=format\u0026n=ChRp9mNNuCx3xt6W\u0026q=85\u0026s=e6ce7b79992dddb6e7039eeceb3a0789","dark":"https://mintcdn.com/semaphore/ChRp9mNNuCx3xt6W/logo/logo-white.svg?fit=max\u0026auto=format\u0026n=ChRp9mNNuCx3xt6W\u0026q=85\u0026s=d2f2d6ec4b9b9ce743f9fb636e960c61"},"favicon":"https://mintcdn.com/semaphore/VQGxb8ZspQ9IKdXE/logo/icon-dark.svg?fit=max\u0026auto=format\u0026n=VQGxb8ZspQ9IKdXE\u0026q=85\u0026s=7696fde22b7a31bdfaf7bc85ac494e2c","navbar":{"links":[{"href":"https://topograph.co/pricing","label":"Pricing"},{"href":"https://app.topograph.co","label":"Dashboard"},{"href":"https://status.topograph.co","label":"Status"},{"href":"mailto:contact@topograph.co","label":"Support"}]},"footer":{"socials":{"x":"https://x.com/gettopograph","linkedin":"https://www.linkedin.com/company/topograph-data"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"semaphore","hasAudioNarration":false,"actualSubdomain":"semaphore","customDomains":["docs.topograph.co"],"gitSource":{"type":"github","owner":"getsemaphore","repo":"semaphore-api","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae0d5a683d301a35cf5933a","collectionId":"32e11908-01ae-4b46-b61e-466a0ecd3d36","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae0d5a683d301a35cf5933a"},"feedback":{"thumbs":false,"agentFeedback":true},"entitlements":{},"buildId":"6ae0d5a683d301a35cf5933a","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"Country Guides","count":112},{"language":"default","tag":"North America","count":63},{"language":"default","tag":"Documentation","count":38},{"language":"default","tag":"Europe","count":36},{"language":"default","tag":"API Reference","count":33},{"language":"default","tag":"Core Features","count":21},{"language":"default","tag":"Offshore Centers","count":10},{"language":"default","tag":"Behavior \u0026 Operations","count":7},{"language":"default","tag":"Billing Notifications","count":6},{"language":"default","tag":"Monitors","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/monitors/add-monitoring-for-a-company","slug":"/api-reference/monitors/add-monitoring-for-a-company","pageMetadata":{"openapi":"post /v2/monitors","title":"Add monitoring for a company","description":null,"href":"/api-reference/monitors/add-monitoring-for-a-company"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"post /v2/monitors","title":"Add monitoring for a company","description":null,"href":"/api-reference/monitors/add-monitoring-for-a-company"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/semaphore/6431d896b4d06b6a/snitcher.js"],"openApiReferenceData":{"operation":{"operationId":"MonitoringController_createMonitor_v2","parameters":[],"requestBody":"f3a25dc7-36ad-4ec0-8a0f-a6cea098107b","responses":{"201":"3b04f9a4-e74f-451f-8898-3dc54ab77da8","400":"bf243ecb-e305-46ca-9aa8-b053cdafdfba","401":"7fb88f3a-9c53-4308-8a4b-e3f964edbfdf"},"security":["9e91e8b9-cabd-4513-9f84-00ef16637b04"],"summary":"Add monitoring for a company","tags":["Monitors"],"method":"post","type":"path","servers":["34c73fc6-8de7-4b68-b031-f48f396cbc99"],"path":"/v2/monitors","baseUrlOptions":["https://api.topograph.co"],"title":"Add monitoring for a company","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"companyId":{"type":"string","description":"The company ID to monitor","example":"123456789","isRequired":true,"uniqueKey":"companyId","typeLabel":"string"},"countryCode":{"type":"string","description":"The country code for the company","enum":["AT","BE","BG","CH","CN","CZ","CY","DE","DK","EE","ES","FI","FR","GB","GG","GR","HK","HR","HU","IE","IS","IT","JE","LI","LU","LV","MC","MT","MU","NL","NO","PL","PT","RO","RU","SE","SG","SI","SK","VG","PA","MX","CO","EC","BM","AR","AU","AG","BA","BR","GI","IM","KY","US-FL","US-CO","US-IL","US-MA","US-MD","US-MI","US-TX","US-DE","UA","US-NY","US-NJ","US-NM","US-OH","US-WA","US-TN","US-GA","US-MN","US-MO","US-NV","RS","US-PA","US-WY","US-CT","US-UT","US-IA","US-ID","US-AZ","US-VA","US-MS","US-CA","US-OR","US-KY","US-NE","US-NC","US-AR","US-WI","US-SC","US-AL","US-AK","US-DC","US-IN","US-ME","US-MT","US-OK","US-SD","US-LA","US-WV","US-ND","US-VT","US-KS","US-RI","US-HI","LT","MD","MH","US-NH","CA-FED","CA-ON","CA-QC","CA-BC","CA-AB","CA-MB","CA-SK","CA-NS","CA-NL","CA-PE","CA-YT","CA-NT","NC","PF","NZ"],"example":"DE","isRequired":true,"uniqueKey":"countryCode","typeLabel":"enum\u003cstring>"},"metadata":{"type":"object","additionalProperties":{"type":"string","maxLength":500,"uniqueKey":"metadata.additionalProperties","typeLabel":"string"},"example":{"caseId":"case-12345"},"description":"Arbitrary key-value string pairs to associate with the monitor, echoed back in monitor responses and in every monitor.notification webhook. Use it to map notifications back to your internal records (e.g. a case ID). Calling POST /v2/monitors again for the same company replaces the stored metadata when the field is provided. Limits: max 50 keys, keys up to 40 chars (longer keys are skipped), values up to 500 chars (longer values are truncated).","uniqueKey":"metadata","typeLabel":"object"}},"required":["companyId","countryCode"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"companyId":"123456789","countryCode":"DE","metadata":{"caseId":"case-12345"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"3b04f9a4-e74f-451f-8898-3dc54ab77da8":{"description":"Monitor created or retrieved","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier for the monitor","example":"cmfzlu1dt000j12ldeqrfszq0","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"companyId":{"type":"string","description":"The company ID being monitored","example":"123456789","isRequired":true,"uniqueKey":"companyId","typeLabel":"string"},"countryCode":{"type":"string","description":"The country code for the monitored company","example":"DE","isRequired":true,"uniqueKey":"countryCode","typeLabel":"string"},"metadata":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"metadata.additionalProperties","typeLabel":"string"},"example":{"caseId":"case-12345"},"description":"Key-value pairs provided at monitor creation, echoed back in responses and monitor.notification webhooks.","uniqueKey":"metadata","typeLabel":"object"},"datapointNotices":{"description":"Present when one or more monitored datapoints for this account are currently blocked on missing account credentials. The monitor is still created (other datapoints are unaffected) but these will not be fetched until resolved.","type":"array","items":{"type":"object","properties":{"datapoint":{"type":"string","description":"Datapoint affected","example":"ultimateBeneficialOwners","isRequired":true,"uniqueKey":"datapointNotices.items.[INDEX].datapoint","typeLabel":"string"},"status":{"type":"string","description":"This datapoint will not be included in scheduled rechecks until the account configures its own credentials.","example":"blocked_missing_credentials","isRequired":true,"uniqueKey":"datapointNotices.items.[INDEX].status","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation, safe to display to the account admin.","example":"This datapoint requires account-specific credentials that have not been configured. Configure them in the workspace vault, or contact support@topograph.co.","isRequired":true,"uniqueKey":"datapointNotices.items.[INDEX].message","typeLabel":"string"}},"required":["datapoint","status","message"],"uniqueKey":"datapointNotices.items.[INDEX]","typeLabel":"object"},"uniqueKey":"datapointNotices","typeLabel":"object[]"}},"required":["id","companyId","countryCode"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"cmfzlu1dt000j12ldeqrfszq0","companyId":"123456789","countryCode":"DE","metadata":{"caseId":"case-12345"},"datapointNotices":[{"datapoint":"ultimateBeneficialOwners","status":"blocked_missing_credentials","message":"This datapoint requires account-specific credentials that have not been configured. Configure them in the workspace vault, or contact support@topograph.co."}]}}},"exampleType":"generated"}},"exampleType":"generated"},"bf243ecb-e305-46ca-9aa8-b053cdafdfba":{"description":"Invalid request or monitoring not supported for country","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"7fb88f3a-9c53-4308-8a4b-e3f964edbfdf":{"description":"Invalid or missing API key","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"9e91e8b9-cabd-4513-9f84-00ef16637b04":{"x-api-key":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"x-api-key"}}},"servers":{"34c73fc6-8de7-4b68-b031-f48f396cbc99":{"url":"https://api.topograph.co"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"x-api-key"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"x-api-key","name":"x-api-key"}],"title":"x-api-key"}]},"originalFileLocation":"openapi.json"},"subdomain":"semaphore","siteName":"Topograph","title":"Add monitoring for a company - Topograph","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T15:59:02.066Z","originalFileLocation":"api-reference/monitors/add-monitoring-for-a-company.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=\"Topograph\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/semaphore/dO1LV7k9tlVmoSjK/_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/semaphore/dO1LV7k9tlVmoSjK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/semaphore/dO1LV7k9tlVmoSjK/_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/semaphore/dO1LV7k9tlVmoSjK/_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/semaphore/dO1LV7k9tlVmoSjK/_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/semaphore/dO1LV7k9tlVmoSjK/_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/semaphore/dO1LV7k9tlVmoSjK/_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/semaphore/dO1LV7k9tlVmoSjK/_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/semaphore/dO1LV7k9tlVmoSjK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Add monitoring for a company - Topograph\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Topograph\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.topograph.co/api-reference/monitors/add-monitoring-for-a-company\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://semaphore.mintlify.app/_mintlify/api/og/v2?division=Monitors\u0026amp;title=Add+monitoring+for+a+company\u0026amp;theme=996e54fd174205253948e175\u0026amp;signature=c201ba9b846eaed196b28c2fe7d1f7ab7aeaad48c753193ff7188bace6377141\">\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=\"Add monitoring for a company - Topograph\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://semaphore.mintlify.app/_mintlify/api/og/v2?division=Monitors\u0026amp;title=Add+monitoring+for+a+company\u0026amp;theme=996e54fd174205253948e175\u0026amp;signature=c201ba9b846eaed196b28c2fe7d1f7ab7aeaad48c753193ff7188bace6377141\">\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/semaphore/dO1LV7k9tlVmoSjK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Topograph\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.topograph.co/api-reference/monitors/add-monitoring-for-a-company\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/monitors/add-monitoring-for-a-company.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.topograph.co/#organization\",\"name\":\"Topograph\",\"url\":\"https://docs.topograph.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/semaphore/ChRp9mNNuCx3xt6W/logo/logo-dark.svg?fit=max\u0026auto=format\u0026n=ChRp9mNNuCx3xt6W\u0026q=85\u0026s=e6ce7b79992dddb6e7039eeceb3a0789\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.topograph.co#website\",\"name\":\"Topograph\",\"url\":\"https://docs.topograph.co\",\"publisher\":{\"@id\":\"https://docs.topograph.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.topograph.co/api-reference/monitors/add-monitoring-for-a-company#webpage\",\"url\":\"https://docs.topograph.co/api-reference/monitors/add-monitoring-for-a-company\",\"name\":\"Add monitoring for a company\",\"dateModified\":\"2026-10-27T15:59:02.066Z\",\"isPartOf\":{\"@id\":\"https://docs.topograph.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.topograph.co/api-reference/monitors/add-monitoring-for-a-company#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.topograph.co/api-reference/monitors/add-monitoring-for-a-company#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Monitors\",\"item\":\"https://docs.topograph.co/api-reference/monitors/list-monitored-companies\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Add monitoring for a company\",\"item\":\"https://docs.topograph.co/api-reference/monitors/add-monitoring-for-a-company\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.topograph.co/api-reference/monitors/add-monitoring-for-a-company#apireference\",\"headline\":\"Add monitoring for a company\",\"name\":\"Add monitoring for a company\",\"url\":\"https://docs.topograph.co/api-reference/monitors/add-monitoring-for-a-company\",\"mainEntityOfPage\":{\"@id\":\"https://docs.topograph.co/api-reference/monitors/add-monitoring-for-a-company#webpage\"},\"dateModified\":\"2026-10-27T15:59:02.066Z\",\"publisher\":{\"@id\":\"https://docs.topograph.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.topograph.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Topograph\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Topograph","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"Country Guides","pages":[{"title":"Country Guides","href":"/essentials/austria"}]},{"tab":"API Reference","groups":[{"group":"Search","pages":[{"openapi":"get /v2/search","title":"Search for companies","href":"/api-reference/search/search-for-companies"},{"openapi":"post /v2/search/global","title":"Find a company across countries from its name","href":"/api-reference/search/global-search"}]},{"group":"Data","pages":[{"openapi":"post /v2/company","title":"Get Company Data and Documents","href":"/api-reference/data/get-company-data-and-documents"},{"openapi":"get /v2/company/{requestId}","title":"Get Company Request Result","href":"/api-reference/data/get-company-request-result"},{"openapi":"get /v2/company/{requestId}/pdf","title":"Download Company Extract as PDF","href":"/api-reference/data/download-company-extract-pdf"},{"openapi":"post /v2/onboarding","deprecated":true,"title":"Get Onboarding Data (Deprecated)","href":"/api-reference/data/get-onboarding-data-deprecated"}]},{"group":"Pricing","pages":[{"openapi":"get /v2/pricing","title":"Get pricing for a country","href":"/api-reference/pricing/get-pricing-for-a-country"}]},{"group":"Workspaces","pages":[{"openapi":"get /v2/workspaces","title":"List all workspaces","href":"/api-reference/workspaces/list-all-workspaces"},{"openapi":"post /v2/workspaces","title":"Create a new workspace","href":"/api-reference/workspaces/create-a-new-workspace"},{"openapi":"patch /v2/workspaces/{name}","title":"Update a workspace","href":"/api-reference/workspaces/update-a-workspace"},{"openapi":"delete /v2/workspaces/{name}","title":"Delete a workspace","href":"/api-reference/workspaces/delete-a-workspace"},{"openapi":"get /v2/workspaces/usage","title":"Get usage report per workspace","href":"/api-reference/workspaces/get-usage-report-per-workspace"}]},{"group":"Monitors","pages":[{"openapi":"get /v2/monitors","title":"List monitored companies","description":null,"href":"/api-reference/monitors/list-monitored-companies"},{"openapi":"post /v2/monitors","title":"Add monitoring for a company","href":"/api-reference/monitors/add-monitoring-for-a-company"},{"openapi":"get /v2/monitors/{id}","title":"Get monitor details","description":null,"href":"/api-reference/monitors/get-monitor-details"},{"openapi":"get /v2/monitors/{id}/logs","title":"Get monitor change logs","href":"/api-reference/monitors/get-monitor-change-logs"},{"title":"Send a test notification for a monitor","href":"/api-reference/monitors/send-a-test-notification-for-a-monitor"},{"openapi":"delete /v2/monitors/{id}","title":"Stop monitoring a company","href":"/api-reference/monitors/stop-monitoring-a-company"}]},{"group":"Discrepancy reports (Beta)","pages":[{"openapi":"post /v2/discrepancy-reports","tag":"BETA","title":"File a discrepancy report (Beta)","href":"/api-reference/discrepancy-reports/file-a-discrepancy-report"},{"openapi":"get /v2/discrepancy-reports/{id}","tag":"BETA","title":"Get a discrepancy report (Beta)","href":"/api-reference/discrepancy-reports/get-a-discrepancy-report"},{"openapi":"get /v2/discrepancy-reports","tag":"BETA","title":"List discrepancy reports (Beta)","href":"/api-reference/discrepancy-reports/list-discrepancy-reports"},{"openapi":"get /v2/discrepancy-reports/usage","tag":"BETA","title":"Get discrepancy report usage (Beta)","href":"/api-reference/discrepancy-reports/get-discrepancy-report-usage"}]},{"group":"Vault","pages":[{"openapi":"get /v2/vault/sources","title":"List supported credential sources","href":"/api-reference/vault/list-supported-credential-sources"},{"openapi":"get /v2/workspaces/{name}/vault","title":"List vault entries on the workspace (metadata only)","href":"/api-reference/vault/list-vault-entries-on-the-workspace-metadata-only"},{"openapi":"get /v2/workspaces/{name}/vault/{sourceKey}","title":"Get one vault entry by sourceKey (metadata only)","href":"/api-reference/vault/get-one-vault-entry-by-sourcekey-metadata-only"},{"openapi":"put /v2/workspaces/{name}/vault/{sourceKey}","title":"Create or replace a credential","href":"/api-reference/vault/create-or-replace-a-credential"},{"openapi":"delete /v2/workspaces/{name}/vault/{sourceKey}","title":"Delete a credential","href":"/api-reference/vault/delete-a-credential"}]},{"group":"Billing","pages":[{"openapi":"get /v2/billing/balance","title":"Get the current account credit balance","href":"/api-reference/billing/get-the-current-account-credit-balance"}]},{"group":"Billing Notifications","pages":[{"openapi":"get /v2/billing/notifications/config","title":"Get resolved billing notification config (defaults merged)","href":"/api-reference/billing-notifications/get-resolved-billing-notification-config-defaults-merged"},{"openapi":"get /v2/billing/notifications/workspaces/{workspaceId}/config","title":"Get resolved workspace billing notification view (override + account)","href":"/api-reference/billing-notifications/get-resolved-workspace-billing-notification-view-override-+-account"},{"openapi":"get /v2/billing/notifications/recent","title":"List recent billing notification events","href":"/api-reference/billing-notifications/list-recent-billing-notification-events"},{"openapi":"delete /v2/billing/notifications/workspaces/{workspaceId}/config","title":"Remove workspace high-usage override","href":"/api-reference/billing-notifications/remove-workspace-high-usage-override"},{"openapi":"patch /v2/billing/notifications/config","title":"Upsert billing notification config","href":"/api-reference/billing-notifications/upsert-billing-notification-config"},{"openapi":"patch /v2/billing/notifications/workspaces/{workspaceId}/config","title":"Upsert workspace high-usage override","href":"/api-reference/billing-notifications/upsert-workspace-high-usage-override"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"title":"Add monitoring for a company - Topograph","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}