Follow up to 100 LinkedIn company pages and profiles and receive the people who react to or comment on their posts, with one results table and an optional webhook. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.
Post engagement monitoring requires a V2 workspace API key. Legacy V1 API keys are not supported by these endpoints. Monitors and their credits belong to the V2 workspace associated with the key.
Create an active monitor with Bearer authentication. A post engagement monitor follows LinkedIn company pages and personal profiles. On every check it reads the recent posts of each source and finds the people who reacted to or commented on them. Each newly detected engager is added as a row to the monitor’s results table and, when configured, pushed to your webhook.Each successful request creates a new monitor, and creation has no idempotency key. If a network failure leaves the result unknown, list your monitors before retrying; otherwise you may create a second monitor that charges the same people again.
Sources are company pages and profiles only.sources takes 1 to 100 LinkedIn company (/company/...) or profile (/in/...) URLs; they are canonicalized and de-duplicated. Single post URLs are rejected with 422 invalid_monitor; use Post likers or Post commenters for one post.
engagement_types: any of reactions and comments; default both.
include_existing_engagers: default false, so the first check only records a baseline. true also delivers and charges people who engaged before the monitor existed.
filters: titles and locations (case-insensitive contains matches, up to 50 each) and excluded_company_urls (LinkedIn company URLs, up to 100). Engagers that do not match are not delivered or charged.
webhook_url: a public HTTPS URL without embedded credentials. Private, loopback, and internal hosts are rejected with 422 before creation and checked again at every send.
Unknown fields are rejected with 422 invalid_monitor. The JSON request body must be at most 256 KiB (262,144 bytes); a larger body returns 413.
A workspace can hold at most 25 monitors (422 monitor_limit_reached), counting monitors created in the Airscale app. Creation requires at least 0.2 credits (402 insufficient_credits). While post engagement monitoring is closed, creation returns 503 monitoring_not_enabled.The 202 Accepted response contains monitor, sources, signing_secret, and signing_secret_warning. Store signing_secret immediately; it is encrypted at rest and never returned again. Checks run asynchronously: the first check is due immediately and runs within a few minutes. Monitors share a check queue, so under load next_check_at can slip, but nothing is lost.
Each engager delivered to the results table costs 0.2 credits, charged once per person per monitor however many posts they engage with later. Reading posts and engagement pages is free, and reads, webhook deliveries, redeliveries, mark-read, and configuration changes never spend credits. When credits run out, checks keep running but new engagers wait unpaid: the monitor shows results_status: "blocked" and results_error: "insufficient_credits", and they are charged and delivered within a few minutes of a top-up. Monitors are independent: the same person engaging with sources of two monitors is delivered and charged by each.
Each monitor owns a regular Airscale results table named <name> — Post engagement. If the table is deleted or full in the app, delivery stops without charging and the monitor reports results_status: "blocked" with the reason. Deleting the monitor keeps its results table.
One webhook is sent per delivered engager, including existing engagers imported on request. The JSON body has "type": "post_engagement.engager_detected", id (the engager ID), monitor_id, detected_at (the delivery time), engager (the engager object from List engagers without read_at and webhook), and engagements (up to the 25 most recent engagement objects from List engagements).The request includes X-Airscale-Event: post_engagement.engager_detected, X-Airscale-Event-Id: <engager_id>, X-Airscale-Timestamp, X-Airscale-Signature: sha256=<hex>, and Idempotency-Key: post-engagement-engager:<engager_id>. Compute HMAC-SHA256 with the signing_secret over <timestamp>.<raw request body>, compare it in constant time, and reject timestamps more than five minutes from the current time. This is the same scheme as job-change monitor webhooks. Deduplicate on the event ID and return a 2xx response only after durable handling.Deliveries are dispatched every couple of minutes with a 15-second timeout. Airscale makes up to five attempts with exponential backoff: 408, 425, 429, and 5xx responses are retried; other responses fail permanently (webhook_http_<status>); a blocked destination fails with webhook_url_rejected; timeouts and dropped connections become uncertain and are never resent automatically. Use Redeliver a webhook to send an engager again.
A public HTTPS URL without embedded credentials. Internal hostnames and private or reserved addresses are rejected, and destinations are checked again at every send.
Maximum string length: 2048
Response
The monitor was accepted and its first check scheduled. Checks run asynchronously; acceptance does not mean a check has completed.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Airschool","description":"Airscale product guides, integration workflows, MCP documentation, and public API reference.","colors":{"primary":"#4079FF","light":"#4079FF","dark":"#6F9BFF"},"logo":{"light":"https://mintcdn.com/airscale/T4fnFCkEZYFIfzlE/logo/light.svg?fit=max\u0026auto=format\u0026n=T4fnFCkEZYFIfzlE\u0026q=85\u0026s=77cac19c9833b1b4b3e8cc1a21fe7c04","dark":"https://mintcdn.com/airscale/T4fnFCkEZYFIfzlE/logo/dark.svg?fit=max\u0026auto=format\u0026n=T4fnFCkEZYFIfzlE\u0026q=85\u0026s=3fae4b34efca46e05ac0dcb7d1febe81","href":"/"},"favicon":"https://mintcdn.com/airscale/6bM8EcCHTBu_Tci4/favicon.svg?fit=max\u0026auto=format\u0026n=6bM8EcCHTBu_Tci4\u0026q=85\u0026s=0f5e216ce2f6809f53f85f184935b9d6","api":{"openapi":"openapi.json","playground":{"display":"simple"},"examples":{"defaults":"required","languages":["curl","node","python"],"prefill":true,"autogenerate":true}},"appearance":{"default":"light"},"navbar":{"links":[{"href":"https://airscale.io/","label":"Back to website"}],"primary":{"type":"button","label":"Open Dashboard","href":"https://app.airscale.io/dashboard"}},"search":{"prompt":"Search Airschool..."},"seo":{"metatags":{"robots":"index, follow","canonical":"https://docs.airscale.io"},"indexing":"navigable"},"fonts":{"family":"Poppins"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"airscale","hasAudioNarration":false,"actualSubdomain":"airscale","customDomains":["docs.airscale.io"],"gitSource":{"type":"github","owner":"vicescale","repo":"airscale-docs","deployBranch":"docs/production-release-20260923","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae8a846e4f1cb0cd68aed46","collectionId":"f4c5d82b-bf97-4f6b-a1be-e3717a2a85a2","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae8a846e4f1cb0cd68aed46"},"entitlements":{},"buildId":"6ae8aa5dca78e468455a17a8","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":68},{"language":"default","tag":"Documentation","count":48},{"language":"default","tag":"Intent signals","count":31},{"language":"default","tag":"Enrichments","count":26},{"language":"default","tag":"Post engagements","count":11},{"language":"default","tag":"Miscellaneous","count":10},{"language":"default","tag":"Job changes","count":10},{"language":"default","tag":"New hires","count":10},{"language":"default","tag":"Build lists","count":10},{"language":"default","tag":"Getting started","count":8}]},"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":"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":"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":"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":"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":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":"#navbar img.nav-logo:is([alt=\"light logo\"], [alt=\"dark logo\"]){height:38px!important}#navbar a[href=\"https://app.airscale.io/dashboard\"]{background-color:#111827!important;border-color:#111827!important;border-radius:10px!important;color:#fff!important}#navbar a[href=\"https://app.airscale.io/dashboard\"]:hover{background-color:#000!important;border-color:#000!important}#navbar a[href=\"https://app.airscale.io/dashboard\"] :is(span, svg){color:inherit!important}#navbar a[href=\"https://app.airscale.io/dashboard\"]>span.absolute.inset-0{background-color:inherit!important;border-radius:10px!important}html.dark #navbar a[href=\"https://app.airscale.io/dashboard\"]{background-color:#fff!important;border-color:#fff!important;color:#111827!important}html.dark #navbar a[href=\"https://app.airscale.io/dashboard\"]:hover{background-color:#e5e7eb!important;border-color:#e5e7eb!important}#sidebar button.sidebar-group-header[data-airscale-collapsible=true]{appearance:none;background:0 0;border:0;cursor:pointer;text-align:left;width:100%}#sidebar button.sidebar-group-header[data-airscale-collapsible=true]::after{content:\"›\";font-size:1.25rem;line-height:1;margin-left:auto;transition:transform 150ms ease}#sidebar button.sidebar-group-header[data-airscale-collapsible=true][aria-expanded=true]::after{transform:rotate(90deg)}"},{"filePath":"airschool.css","content":".airschool{--school-text:#121419;--school-muted:#697289;--school-border:#e2e7ee;--school-surface:#fff;--school-subtle:#f9fafb;color:var(--school-text);background:var(--school-surface) url(/images/airschool/grid.svg) center top/cover;padding:80px 0;font-family:Poppins,sans-serif}.airschool *{box-sizing:border-box}.airschool :is(h1, h2, h3, p){margin:0}.airschool a{color:inherit;text-decoration:none}.airschool a.link{border-bottom-color:var(--school-border)!important}.airschool a.link:hover{border-bottom-color:#aab6cb!important}.airschool-content{width:100%;max-width:1200px;margin:0 auto;padding:0 32px;display:grid;gap:80px}.airschool-hero{display:grid;justify-items:center;gap:40px;text-align:center}.airschool-intro,.airschool-search-area{max-width:768px;display:grid;justify-items:center;gap:20px}.airschool .airschool-badge{border:1px solid var(--school-border);border-radius:99px;padding:9px 16px;background:var(--school-surface);font-size:12px;line-height:16px;font-weight:500}.airschool h1{font-size:48px;line-height:56px;font-weight:600;letter-spacing:-1.8px}.airschool .airschool-description{max-width:600px;font-size:16px;line-height:28px;color:#333842}.airschool-search-area{width:100%;max-width:680px;gap:24px}.airschool-search{width:100%;max-width:550px;min-height:56px;padding:12px 16px;display:flex;align-items:center;gap:12px;border:1px solid var(--school-border);border-radius:16px;background:var(--school-surface);color:var(--school-muted);text-align:left;font:inherit;font-size:14px;cursor:pointer;box-shadow:0 3px 8px -5px #0003}.airschool-search>svg,.airschool-support-card>.airschool-link{flex:none}.airschool-shortcut-keys{margin-left:auto;display:flex;gap:4px}.airschool kbd,.airschool-shortcuts a{background:var(--school-subtle);border:1px solid var(--school-border);border-radius:8px}.airschool kbd{display:grid;place-items:center;width:28px;height:28px;font:inherit;font-size:12px}.airschool-shortcuts{display:flex;flex-wrap:wrap;gap:8px;align-items:center;justify-content:center;font-size:12px;line-height:18px;color:var(--school-muted)}.airschool-shortcuts a{padding:5px 10px;font-weight:500}.airschool-section{display:grid;gap:32px}.airschool h2,.airschool h3{font-size:20px;line-height:28px;font-weight:400;letter-spacing:-.5px}.airschool-categories{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:20px}.airschool-card{display:flex;flex-direction:column;gap:20px;padding:12px;border:1px solid var(--school-border);border-radius:36px;background:var(--school-surface);transition:border-color 150ms ease,box-shadow 150ms ease}.airschool-card img{display:block;width:100%;height:auto;aspect-ratio:2/1;object-fit:cover;border-radius:24px;margin:0}.airschool-card-content{flex:1;display:flex;flex-direction:column;justify-content:space-between;gap:16px;padding:0 16px 16px}.airschool h3{font-size:16px;line-height:24px;letter-spacing:-.4px}.airschool-card p,.airschool-support-card p{margin-top:6px;font-size:12px;line-height:18px;color:var(--school-muted)}.airschool-link{font-size:14px;line-height:20px;color:var(--school-muted);font-weight:500}.airschool-link>span{display:inline-block;margin-left:3px}.airschool-support-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:20px}.airschool-support-card{display:flex;align-items:center;gap:20px;padding:28px;border:1px solid var(--school-border);border-radius:32px;background:var(--school-surface);transition:border-color 150ms ease,box-shadow 150ms ease}.airschool-support-icon{display:grid;place-items:center;flex:none;width:50px;height:50px;border-radius:50%;background:var(--school-subtle);color:var(--school-muted)}.airschool-support-copy{flex:1}.airschool :is(.airschool-card, .airschool-support-card, .airschool-search, .airschool-shortcuts a):hover{border-color:#aab6cb;box-shadow:0 4px 16px -10px #33415555}.airschool :is(a, button):focus-visible{outline:3px solid #4079ff;outline-offset:4px}html.dark .airschool{--school-text:#f4f5f7;--school-muted:#aeb7c8;--school-border:#303640;--school-surface:#111316;--school-subtle:#1b1e24;background-image:none}html.dark .airschool .airschool-description{color:#c4cbd6}html.dark .airschool-card img{filter:brightness(.88)}@media (max-width:1000px){.airschool-support-card{flex-wrap:wrap;gap:16px;padding:24px}.airschool-support-card>.airschool-link{width:100%;padding-left:66px}}@media (max-width:700px){.airschool{padding:48px 0}.airschool-content{padding:0 20px;gap:48px}.airschool h1{font-size:36px;line-height:44px;letter-spacing:-1.2px}.airschool .airschool-description{font-size:15px;line-height:26px}.airschool-hero{gap:28px}.airschool-categories,.airschool-support-grid{grid-template-columns:minmax(0,1fr)}.airschool-section{gap:24px}.airschool-shortcut-keys{display:none}.airschool-shortcuts>span{width:100%}.airschool-card{border-radius:28px}.airschool-card-content{padding:0 12px 12px}}@media (prefers-reduced-motion:reduce){.airschool :is(.airschool-card, .airschool-support-card){transition:none}}"}],"page":{"pagePath":"api-reference/post-engagement-monitors/create","slug":"/api-reference/post-engagement-monitors/create","pageMetadata":{"title":"Create a post engagement monitor","description":"Follow up to 100 LinkedIn company pages and profiles and receive the people who react to or comment on their posts, with one results table and an optional webhook. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.","canonical":"https://docs.airscale.io/api-reference/post-engagement-monitors/create","openapi":"openapi.json POST /v1/post-engagement-monitors","href":"/api-reference/post-engagement-monitors/create"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Follow up to 100 LinkedIn company pages and profiles and receive the people who react to or comment on their posts, with one results table and an optional webhook. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.\"\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`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Note}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:_jsxs(_components.p,{children:[`Post engagement monitoring requires a `,_jsx(_components.strong,{children:`V2 workspace API key`}),`. Legacy V1 API keys are not supported by these endpoints. Monitors and their credits belong to the V2 workspace associated with the key.`]})}),`\n`,_jsxs(_components.p,{children:[`Create an active monitor with `,_jsx(_components.a,{href:`/api-reference/authentication`,children:`Bearer authentication`}),`. A post engagement monitor follows LinkedIn company pages and personal profiles. On every check it reads the recent posts of each source and finds the people who reacted to or commented on them. Each newly detected engager is added as a row to the monitor’s results table and, when configured, pushed to your webhook.`]}),`\n`,_jsxs(_components.p,{children:[`Each successful request creates a new monitor, and creation has no idempotency key. If a network failure leaves the result unknown, `,_jsx(_components.a,{href:`/api-reference/post-engagement-monitors/list`,children:`list your monitors`}),` before retrying; otherwise you may create a second monitor that charges the same people again.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Sources are company pages and profiles only.`}),` `,_jsx(_components.code,{children:`sources`}),` takes 1 to 100 LinkedIn company (`,_jsx(_components.code,{children:`/company/...`}),`) or profile (`,_jsx(_components.code,{children:`/in/...`}),`) URLs; they are canonicalized and de-duplicated. Single post URLs are rejected with `,_jsx(_components.code,{children:`422 invalid_monitor`}),`; use `,_jsx(_components.a,{href:`/api-reference/post-likers`,children:`Post likers`}),` or `,_jsx(_components.a,{href:`/api-reference/post-commenters`,children:`Post commenters`}),` for one post.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`settings`,children:`Settings`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`frequency`}),`: `,_jsx(_components.code,{children:`daily`}),` (default) or `,_jsx(_components.code,{children:`weekly`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`engagement_types`}),`: any of `,_jsx(_components.code,{children:`reactions`}),` and `,_jsx(_components.code,{children:`comments`}),`; default both.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`include_existing_engagers`}),`: default `,_jsx(_components.code,{children:`false`}),`, so the first check only records a baseline. `,_jsx(_components.code,{children:`true`}),` also delivers and charges people who engaged before the monitor existed.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`filters`}),`: `,_jsx(_components.code,{children:`titles`}),` and `,_jsx(_components.code,{children:`locations`}),` (case-insensitive contains matches, up to 50 each) and `,_jsx(_components.code,{children:`excluded_company_urls`}),` (LinkedIn company URLs, up to 100). Engagers that do not match are not delivered or charged.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`webhook_url`}),`: a public HTTPS URL without embedded credentials. Private, loopback, and internal hosts are rejected with `,_jsx(_components.code,{children:`422`}),` before creation and checked again at every send.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Unknown fields are rejected with `,_jsx(_components.code,{children:`422 invalid_monitor`}),`. The JSON request body must be at most `,_jsx(_components.strong,{children:`256 KiB (262,144 bytes)`}),`; a larger body returns `,_jsx(_components.code,{children:`413`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`limits-and-admission`,children:`Limits and admission`}),`\n`,_jsxs(_components.p,{children:[`A workspace can hold at most `,_jsx(_components.strong,{children:`25 monitors`}),` (`,_jsx(_components.code,{children:`422 monitor_limit_reached`}),`), counting monitors created in the Airscale app. Creation requires at least 0.2 credits (`,_jsx(_components.code,{children:`402 insufficient_credits`}),`). While post engagement monitoring is closed, creation returns `,_jsx(_components.code,{children:`503 monitoring_not_enabled`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`202 Accepted`}),` response contains `,_jsx(_components.code,{children:`monitor`}),`, `,_jsx(_components.code,{children:`sources`}),`, `,_jsx(_components.code,{children:`signing_secret`}),`, and `,_jsx(_components.code,{children:`signing_secret_warning`}),`. Store `,_jsx(_components.code,{children:`signing_secret`}),` immediately; it is encrypted at rest and never returned again. Checks run asynchronously: the first check is due immediately and runs within a few minutes. Monitors share a check queue, so under load `,_jsx(_components.code,{children:`next_check_at`}),` can slip, but nothing is lost.`]}),`\n`,_jsx(Heading,{level:`2`,id:`credits`,children:`Credits`}),`\n`,_jsxs(_components.p,{children:[`Each engager delivered to the results table costs `,_jsx(_components.strong,{children:`0.2 credits`}),`, charged once per person per monitor however many posts they engage with later. Reading posts and engagement pages is free, and reads, webhook deliveries, redeliveries, mark-read, and configuration changes never spend credits. When credits run out, checks keep running but new engagers wait unpaid: the monitor shows `,_jsx(_components.code,{children:`results_status: \"blocked\"`}),` and `,_jsx(_components.code,{children:`results_error: \"insufficient_credits\"`}),`, and they are charged and delivered within a few minutes of a top-up. Monitors are independent: the same person engaging with sources of two monitors is delivered and charged by each.`]}),`\n`,_jsx(Heading,{level:`2`,id:`results-table`,children:`Results table`}),`\n`,_jsxs(_components.p,{children:[`Each monitor owns a regular Airscale results table named `,_jsx(_components.code,{children:`\u003cname> — Post engagement`}),`. If the table is deleted or full in the app, delivery stops without charging and the monitor reports `,_jsx(_components.code,{children:`results_status: \"blocked\"`}),` with the reason. Deleting the monitor keeps its results table.`]}),`\n`,_jsx(Heading,{level:`2`,id:`verify-webhook-signatures`,children:`Verify webhook signatures`}),`\n`,_jsxs(_components.p,{children:[`One webhook is sent per delivered engager, including existing engagers imported on request. The JSON body has `,_jsx(_components.code,{children:`\"type\": \"post_engagement.engager_detected\"`}),`, `,_jsx(_components.code,{children:`id`}),` (the engager ID), `,_jsx(_components.code,{children:`monitor_id`}),`, `,_jsx(_components.code,{children:`detected_at`}),` (the delivery time), `,_jsx(_components.code,{children:`engager`}),` (the engager object from `,_jsx(_components.a,{href:`/api-reference/post-engagement-monitors/engagers`,children:`List engagers`}),` without `,_jsx(_components.code,{children:`read_at`}),` and `,_jsx(_components.code,{children:`webhook`}),`), and `,_jsx(_components.code,{children:`engagements`}),` (up to the 25 most recent engagement objects from `,_jsx(_components.a,{href:`/api-reference/post-engagement-monitors/engagements`,children:`List engagements`}),`).`]}),`\n`,_jsxs(_components.p,{children:[`The request includes `,_jsx(_components.code,{children:`X-Airscale-Event: post_engagement.engager_detected`}),`, `,_jsx(_components.code,{children:`X-Airscale-Event-Id: \u003cengager_id>`}),`, `,_jsx(_components.code,{children:`X-Airscale-Timestamp`}),`, `,_jsx(_components.code,{children:`X-Airscale-Signature: sha256=\u003chex>`}),`, and `,_jsx(_components.code,{children:`Idempotency-Key: post-engagement-engager:\u003cengager_id>`}),`. Compute HMAC-SHA256 with the `,_jsx(_components.code,{children:`signing_secret`}),` over `,_jsx(_components.code,{children:`\u003ctimestamp>.\u003craw request body>`}),`, compare it in constant time, and reject timestamps more than five minutes from the current time. This is the same scheme as job-change monitor webhooks. Deduplicate on the event ID and return a 2xx response only after durable handling.`]}),`\n`,_jsxs(_components.p,{children:[`Deliveries are dispatched every couple of minutes with a 15-second timeout. Airscale makes up to five attempts with exponential backoff: `,_jsx(_components.code,{children:`408`}),`, `,_jsx(_components.code,{children:`425`}),`, `,_jsx(_components.code,{children:`429`}),`, and `,_jsx(_components.code,{children:`5xx`}),` responses are retried; other responses fail permanently (`,_jsx(_components.code,{children:`webhook_http_\u003cstatus>`}),`); a blocked destination fails with `,_jsx(_components.code,{children:`webhook_url_rejected`}),`; timeouts and dropped connections become `,_jsx(_components.code,{children:`uncertain`}),` and are never resent automatically. Use `,_jsx(_components.a,{href:`/api-reference/post-engagement-monitors/engagers/redeliver`,children:`Redeliver a webhook`}),` to send an engager again.`]}),`\n`,_jsx(Heading,{level:`2`,id:`next-step`,children:`Next step`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.a,{href:`/api-reference/post-engagement-monitors/get`,children:`Get a post engagement monitor`}),` to follow the first check of each source.`]})]})}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":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Create a post engagement monitor","description":"Follow up to 100 LinkedIn company pages and profiles and receive the people who react to or comment on their posts, with one results table and an optional webhook. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.","canonical":"https://docs.airscale.io/api-reference/post-engagement-monitors/create","openapi":"openapi.json POST /v1/post-engagement-monitors","href":"/api-reference/post-engagement-monitors/create"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Settings","slug":"settings","depth":2,"children":[]},{"title":"Limits and admission","slug":"limits-and-admission","depth":2,"children":[]},{"title":"Credits","slug":"credits","depth":2,"children":[]},{"title":"Results table","slug":"results-table","depth":2,"children":[]},{"title":"Verify webhook signatures","slug":"verify-webhook-signatures","depth":2,"children":[]},{"title":"Next step","slug":"next-step","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/airscale/9fa3b93ce50bf4a8/custom.js"],"openApiReferenceData":{"operation":{"operationId":"createPostEngagementMonitor","tags":["Post engagement monitoring"],"summary":"Create a post engagement monitor","description":"Follow up to 100 LinkedIn company pages and profiles and receive the people who react to or comment on their posts, with one results table and an optional webhook. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.","x-airscale-rate-limit":"120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.","x-airscale-credit-cost":"0.2 credits per engager delivered to the results table, charged once per person per monitor. Creation requires at least 0.2 credits. Reading posts, webhook deliveries, redeliveries, mark-read and configuration changes are free.","requestBody":"b57025ca-0001-4dc7-a1c5-4c98c6903661","responses":{"202":"cd16a1df-7493-4425-ac4d-433ffbc5266c","400":"5765822d-ec8c-4149-9612-66f99dccb404","401":"1e39bb44-d949-4187-97a9-2ab0081d5217","402":"cfca0ce8-1ec7-43bc-b0fb-03503b0e523c","413":"34c5f736-1b89-40be-aba8-8729c17fab40","422":"ac0125ed-f255-42c8-a205-e802ef62e0fc","429":"6db3c994-89a0-48ce-bef5-57d923d8812d","503":"936d9b40-3f3c-412e-a9aa-733a97718bc9"},"method":"post","type":"path","servers":["b1097e1d-089e-45f3-97ef-ba0b9b6a9962"],"security":["18c92dab-d143-4697-9c89-a2c4c51573a4"],"path":"/v1/post-engagement-monitors","baseUrlOptions":["https://api.airscale.io"],"title":"Create a post engagement monitor","codeSamples":[],"requestExampleLanguages":["bash","node","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.name":"Competitor audiences","body.sources.items.0":"https://www.linkedin.com/company/example-company","body.sources.items.1":"https://www.linkedin.com/in/example-person","body.frequency":"daily","body.engagement_types.items.0":"reactions","body.engagement_types.items.1":"comments","body.include_existing_engagers":false,"body.filters.titles.items.0":"VP","body.filters.titles.items.1":"Head of","body.filters.locations.items.0":"France","body.filters.excluded_company_urls.items.0":"https://www.linkedin.com/company/example-company","body.webhook_url.oneOf.0":"https://hooks.example.com/airscale/engagers"}]},"dependencies":{"parameters":{},"requestBody":{"required":true,"description":"Provide a name and 1–100 LinkedIn company or profile URLs in a JSON body of at most 256 KiB (262,144 bytes). Unknown fields are rejected.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name","sources"],"properties":{"name":{"type":"string","minLength":1,"maxLength":120,"description":"Also names the results table: `\u003cname> — Post engagement`.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"sources":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"string","minLength":1,"maxLength":1000,"uniqueKey":"sources.items.[INDEX]","typeLabel":"string"},"description":"1–100 LinkedIn company (/company/...) or personal profile (/in/...) URLs. URLs are canonicalized and de-duplicated. Single post URLs are rejected.","isRequired":true,"uniqueKey":"sources","typeLabel":"string[]"},"frequency":{"type":"string","enum":["daily","weekly"],"default":"daily","uniqueKey":"frequency","typeLabel":"enum\u003cstring>"},"engagement_types":{"type":"array","minItems":1,"maxItems":2,"uniqueItems":true,"items":{"type":"string","enum":["reactions","comments"],"uniqueKey":"engagement_types.items.[INDEX]","typeLabel":"enum\u003cstring>"},"default":["reactions","comments"],"uniqueKey":"engagement_types","typeLabel":"enum\u003cstring>[]"},"include_existing_engagers":{"type":"boolean","default":false,"description":"false: the first check only records a baseline. true: people who engaged before the monitor existed are also delivered and charged.","uniqueKey":"include_existing_engagers","typeLabel":"boolean"},"filters":{"type":"object","additionalProperties":false,"description":"Engagers that do not match are not delivered or charged. Titles and locations are case-insensitive contains matches.","properties":{"titles":{"type":"array","maxItems":50,"items":{"type":"string","minLength":1,"maxLength":200,"uniqueKey":"filters.titles.items.[INDEX]","typeLabel":"string"},"default":[],"uniqueKey":"filters.titles","typeLabel":"string[]"},"locations":{"type":"array","maxItems":50,"items":{"type":"string","minLength":1,"maxLength":200,"uniqueKey":"filters.locations.items.[INDEX]","typeLabel":"string"},"default":[],"uniqueKey":"filters.locations","typeLabel":"string[]"},"excluded_company_urls":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":500,"uniqueKey":"filters.excluded_company_urls.items.[INDEX]","typeLabel":"string"},"default":[],"description":"LinkedIn company URLs whose employees are left out.","uniqueKey":"filters.excluded_company_urls","typeLabel":"string[]"}},"uniqueKey":"filters","typeLabel":"object"},"webhook_url":{"oneOf":[{"type":"string","format":"uri","maxLength":2048,"description":"A public HTTPS URL without embedded credentials. Internal hostnames and private or reserved addresses are rejected, and destinations are checked again at every send.","uniqueKey":"webhook_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","maxLength":2048,"description":"A public HTTPS URL without embedded credentials. Internal hostnames and private or reserved addresses are rejected, and destinations are checked again at every send.","uniqueKey":"webhook_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"webhook_url","typeLabel":"string\u003curi> | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"monitor":{"title":"monitor","value":{"name":"Competitor audiences","sources":["https://www.linkedin.com/company/example-company","https://www.linkedin.com/in/example-person"],"frequency":"daily","engagement_types":["reactions","comments"],"include_existing_engagers":false,"filters":{"titles":["VP","Head of"],"locations":["France"],"excluded_company_urls":["https://www.linkedin.com/company/example-company"]},"webhook_url":"https://hooks.example.com/airscale/engagers"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"cd16a1df-7493-4425-ac4d-433ffbc5266c":{"description":"The monitor was accepted and its first check scheduled. Checks run asynchronously; acceptance does not mean a check has completed.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["monitor","sources","signing_secret","signing_secret_warning"],"properties":{"monitor":{"type":"object","additionalProperties":false,"required":["id","name","status","frequency","engagement_types","include_existing_engagers","filters","results_table_id","results_status","results_error","next_check_at","last_checked_at","last_error","webhook_url","webhook_configured","source_count","engager_count","unread_engager_count","created_at","updated_at"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"monitor.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","isRequired":true,"uniqueKey":"monitor.name","typeLabel":"string"},"status":{"type":"string","enum":["active","paused"],"isRequired":true,"uniqueKey":"monitor.status","typeLabel":"enum\u003cstring>"},"frequency":{"type":"string","enum":["daily","weekly"],"isRequired":true,"uniqueKey":"monitor.frequency","typeLabel":"enum\u003cstring>"},"engagement_types":{"type":"array","items":{"type":"string","enum":["reactions","comments"],"uniqueKey":"monitor.engagement_types.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"monitor.engagement_types","typeLabel":"enum\u003cstring>[]"},"include_existing_engagers":{"type":"boolean","isRequired":true,"uniqueKey":"monitor.include_existing_engagers","typeLabel":"boolean"},"filters":{"type":"object","additionalProperties":false,"required":["titles","locations","excluded_company_urls"],"properties":{"titles":{"type":"array","items":{"type":"string","uniqueKey":"monitor.filters.titles.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"monitor.filters.titles","typeLabel":"string[]"},"locations":{"type":"array","items":{"type":"string","uniqueKey":"monitor.filters.locations.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"monitor.filters.locations","typeLabel":"string[]"},"excluded_company_urls":{"type":"array","items":{"type":"string","uniqueKey":"monitor.filters.excluded_company_urls.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"monitor.filters.excluded_company_urls","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"monitor.filters","typeLabel":"object"},"results_table_id":{"type":"string","description":"The Airscale results table that receives one row per delivered engager.","isRequired":true,"uniqueKey":"monitor.results_table_id","typeLabel":"string"},"results_status":{"type":"string","enum":["ready","pending","blocked"],"description":"ready, pending (engagers waiting for delivery) or blocked (see results_error).","isRequired":true,"uniqueKey":"monitor.results_status","typeLabel":"enum\u003cstring>"},"results_error":{"oneOf":[{"type":"string","description":"Why delivery is blocked, for example insufficient_credits, results_table_deleted, table_row_limit_reached or results_columns_missing.","isRequired":true,"uniqueKey":"monitor.results_error.oneOf.0","typeLabel":"string"},{"type":"null","description":"Why delivery is blocked, for example insufficient_credits, results_table_deleted, table_row_limit_reached or results_columns_missing.","isRequired":true,"uniqueKey":"monitor.results_error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"monitor.results_error","typeLabel":"string | null"},"next_check_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"monitor.next_check_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"monitor.next_check_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"monitor.next_check_at","typeLabel":"string\u003cdate-time> | null"},"last_checked_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"monitor.last_checked_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"monitor.last_checked_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"monitor.last_checked_at","typeLabel":"string\u003cdate-time> | null"},"last_error":{"oneOf":[{"type":"string","description":"A short code when the last check could not complete.","isRequired":true,"uniqueKey":"monitor.last_error.oneOf.0","typeLabel":"string"},{"type":"null","description":"A short code when the last check could not complete.","isRequired":true,"uniqueKey":"monitor.last_error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"monitor.last_error","typeLabel":"string | null"},"webhook_url":{"oneOf":[{"type":"string","format":"uri","isRequired":true,"uniqueKey":"monitor.webhook_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","isRequired":true,"uniqueKey":"monitor.webhook_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"monitor.webhook_url","typeLabel":"string\u003curi> | null"},"webhook_configured":{"type":"boolean","isRequired":true,"uniqueKey":"monitor.webhook_configured","typeLabel":"boolean"},"source_count":{"type":"integer","minimum":0,"description":"Active sources.","isRequired":true,"uniqueKey":"monitor.source_count","typeLabel":"integer"},"engager_count":{"type":"integer","minimum":0,"description":"Engagers delivered to the results table.","isRequired":true,"uniqueKey":"monitor.engager_count","typeLabel":"integer"},"unread_engager_count":{"type":"integer","minimum":0,"description":"Exact count, independent of any page size.","isRequired":true,"uniqueKey":"monitor.unread_engager_count","typeLabel":"integer"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"monitor.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"monitor.updated_at","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"monitor","typeLabel":"object"},"sources":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","linkedin_url","kind","status","last_checked_at","last_error"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"sources.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"linkedin_url":{"type":"string","isRequired":true,"uniqueKey":"sources.items.[INDEX].linkedin_url","typeLabel":"string"},"kind":{"type":"string","enum":["company","profile","post"],"description":"The API accepts company and profile sources only; post appears on single-post sources added in the Airscale app.","isRequired":true,"uniqueKey":"sources.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["pending","monitoring","removed"],"description":"pending until the source's first check, then monitoring. removed appears only in a remove response.","isRequired":true,"uniqueKey":"sources.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"last_checked_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"sources.items.[INDEX].last_checked_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"sources.items.[INDEX].last_checked_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sources.items.[INDEX].last_checked_at","typeLabel":"string\u003cdate-time> | null"},"last_error":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"sources.items.[INDEX].last_error.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"sources.items.[INDEX].last_error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sources.items.[INDEX].last_error","typeLabel":"string | null"}},"uniqueKey":"sources.items.[INDEX]","typeLabel":"object"},"description":"The monitor's active sources, sorted by URL.","isRequired":true,"uniqueKey":"sources","typeLabel":"object[]"},"signing_secret":{"oneOf":[{"type":"string","description":"Returned once when a webhook is configured; null otherwise.","isRequired":true,"uniqueKey":"signing_secret.oneOf.0","typeLabel":"string"},{"type":"null","description":"Returned once when a webhook is configured; null otherwise.","isRequired":true,"uniqueKey":"signing_secret.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"signing_secret","typeLabel":"string | null"},"signing_secret_warning":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"signing_secret_warning.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"signing_secret_warning.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"signing_secret_warning","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"success":{"title":"success","value":{"monitor":{"id":"71111111-1111-4111-8111-111111111111","name":"Competitor audiences","status":"active","frequency":"daily","engagement_types":["reactions","comments"],"include_existing_engagers":false,"filters":{"titles":["VP","Head of"],"locations":["France"],"excluded_company_urls":["https://www.linkedin.com/company/example-company"]},"results_table_id":"74444444-4444-4444-8444-444444444444","results_status":"ready","results_error":null,"next_check_at":"2026-11-02T08:58:00.000Z","last_checked_at":null,"last_error":null,"webhook_url":"https://hooks.example.com/airscale/engagers","webhook_configured":true,"source_count":2,"engager_count":0,"unread_engager_count":0,"created_at":"2026-11-02T08:58:00.000Z","updated_at":"2026-11-02T08:58:00.000Z"},"sources":[{"id":"72222222-2222-4222-8222-222222222222","linkedin_url":"https://www.linkedin.com/company/example-company","kind":"company","status":"pending","last_checked_at":null,"last_error":null},{"id":"72222223-2222-4222-8222-222222222223","linkedin_url":"https://www.linkedin.com/in/example-person","kind":"profile","status":"pending","last_checked_at":null,"last_error":null}],"signing_secret":"example-signing-secret","signing_secret_warning":"Store this secret now. It is not returned again."}}},"exampleType":"examples"}},"exampleType":"examples"},"5765822d-ec8c-4149-9612-66f99dccb404":{"description":"The request body is missing or is not valid JSON. The public API returns {\"error\":\"Invalid JSON\"}.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"error":{"title":"error","value":{"error":"Invalid JSON"}}},"exampleType":"examples"}},"exampleType":"examples"},"1e39bb44-d949-4187-97a9-2ab0081d5217":{"description":"A missing Bearer token returns {\"error\":\"Unauthorized\",\"message\":\"Missing or invalid bearer token\"}. An unknown API key returns invalid_api_key.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.0.error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","properties":{"error":{"type":"string","uniqueKey":"oneOf.1.error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"oneOf.1.message","typeLabel":"string"}},"additionalProperties":true,"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"invalidKey":{"title":"invalidKey","value":{"error":{"code":"invalid_api_key","message":"The API key is not valid"}}}},"exampleType":"examples"}},"exampleType":"examples"},"cfca0ce8-1ec7-43bc-b0fb-03503b0e523c":{"description":"insufficient_credits: creation requires at least 0.2 credits.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"34c5f736-1b89-40be-aba8-8729c17fab40":{"description":"The JSON request body exceeds the 256 KiB (262,144 bytes) limit.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"ac0125ed-f255-42c8-a205-e802ef62e0fc":{"description":"invalid_monitor (for example a missing name, an unknown field, a URL that is not a LinkedIn company or profile, a single post URL, invalid filters, or a webhook_url that is not a public HTTPS destination) or monitor_limit_reached when the workspace already has 25 monitors.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"6db3c994-89a0-48ce-bef5-57d923d8812d":{"description":"The API key has exceeded 120 requests in the current minute across post engagement monitor endpoints. Wait for the Retry-After seconds before retrying.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"error":{"title":"error","value":{"error":"Too Many Requests","message":"Rate limit exceeded: 120 requests per minute"}}},"exampleType":"examples"}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"string"},"example":"60"}},"exampleType":"examples"},"936d9b40-3f3c-412e-a9aa-733a97718bc9":{"description":"monitoring_not_enabled while post engagement monitoring is closed, or service_unavailable.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"18c92dab-d143-4697-9c89-a2c4c51573a4":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API key","description":"Use an Airscale workspace API key. Never expose the key in client-side code.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"b1097e1d-089e-45f3-97ef-ba0b9b6a9962":{"url":"https://api.airscale.io","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API key","description":"Use an Airscale workspace API key. Never expose the key in client-side code.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Use an Airscale workspace API key. Never expose the key in client-side code.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"airscale","siteName":"Airschool","title":"Create a post engagement monitor - Airschool","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-02T15:21:14.812Z","originalFileLocation":"api-reference/post-engagement-monitors/create.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Follow up to 100 LinkedIn company pages and profiles and receive the people who react to or comment on their posts, with one results table and an optional webhook. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Airschool\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/airscale/iIlUU29U7SNYsr3_/_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/airscale/iIlUU29U7SNYsr3_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/airscale/iIlUU29U7SNYsr3_/_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/airscale/iIlUU29U7SNYsr3_/_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/airscale/iIlUU29U7SNYsr3_/_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/airscale/iIlUU29U7SNYsr3_/_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/airscale/iIlUU29U7SNYsr3_/_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/airscale/iIlUU29U7SNYsr3_/_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/airscale/iIlUU29U7SNYsr3_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a post engagement monitor - Airschool\">\u003cmeta data-mint-head property=\"og:description\" content=\"Follow up to 100 LinkedIn company pages and profiles and receive the people who react to or comment on their posts, with one results table and an optional webhook. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Airschool\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.airscale.io/api-reference/post-engagement-monitors/create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://airscale.mintlify.app/_mintlify/api/og/v2?division=Post+engagements\u0026amp;title=Create+a+post+engagement+monitor\u0026amp;description=Follow+up+to+100+LinkedIn+company+pages+and+profiles+and+receive+the+people+who+react+to+or+comment+on+their+posts%2C+with+one+results+table+and+an+optional+webho\u0026amp;theme=89d1666b77f2d0da24a1804c\u0026amp;signature=2bbb4d7e1c22b2a0b363b7f3a9ba5dca9b8024dc251b9f0a323c3a6b56062361\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a post engagement monitor - Airschool\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Follow up to 100 LinkedIn company pages and profiles and receive the people who react to or comment on their posts, with one results table and an optional webhook. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://airscale.mintlify.app/_mintlify/api/og/v2?division=Post+engagements\u0026amp;title=Create+a+post+engagement+monitor\u0026amp;description=Follow+up+to+100+LinkedIn+company+pages+and+profiles+and+receive+the+people+who+react+to+or+comment+on+their+posts%2C+with+one+results+table+and+an+optional+webho\u0026amp;theme=89d1666b77f2d0da24a1804c\u0026amp;signature=2bbb4d7e1c22b2a0b363b7f3a9ba5dca9b8024dc251b9f0a323c3a6b56062361\">\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/airscale/iIlUU29U7SNYsr3_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Airschool\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4079FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.airscale.io/api-reference/post-engagement-monitors/create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/post-engagement-monitors/create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.airscale.io/#organization\",\"name\":\"Airschool\",\"url\":\"https://docs.airscale.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/airscale/T4fnFCkEZYFIfzlE/logo/light.svg?fit=max\u0026auto=format\u0026n=T4fnFCkEZYFIfzlE\u0026q=85\u0026s=77cac19c9833b1b4b3e8cc1a21fe7c04\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.airscale.io#website\",\"name\":\"Airschool\",\"url\":\"https://docs.airscale.io\",\"publisher\":{\"@id\":\"https://docs.airscale.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.airscale.io/api-reference/post-engagement-monitors/create#webpage\",\"url\":\"https://docs.airscale.io/api-reference/post-engagement-monitors/create\",\"name\":\"Create a post engagement monitor\",\"description\":\"Follow up to 100 LinkedIn company pages and profiles and receive the people who react to or comment on their posts, with one results table and an optional webhook. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.\",\"dateModified\":\"2026-11-02T15:21:14.812Z\",\"isPartOf\":{\"@id\":\"https://docs.airscale.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.airscale.io/api-reference/post-engagement-monitors/create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.airscale.io/api-reference/post-engagement-monitors/create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Intent signals\",\"item\":\"https://docs.airscale.io/api-reference/job-change-monitors/create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a post engagement monitor\",\"item\":\"https://docs.airscale.io/api-reference/post-engagement-monitors/create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.airscale.io/api-reference/post-engagement-monitors/create#apireference\",\"headline\":\"Create a post engagement monitor\",\"name\":\"Create a post engagement monitor\",\"description\":\"Follow up to 100 LinkedIn company pages and profiles and receive the people who react to or comment on their posts, with one results table and an optional webhook. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.\",\"url\":\"https://docs.airscale.io/api-reference/post-engagement-monitors/create\",\"mainEntityOfPage\":{\"@id\":\"https://docs.airscale.io/api-reference/post-engagement-monitors/create#webpage\"},\"dateModified\":\"2026-11-02T15:21:14.812Z\",\"publisher\":{\"@id\":\"https://docs.airscale.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.airscale.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Airschool\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Airschool","nav":{"global":null,"tabs":[{"tab":"Home","pages":[{"title":"Home","href":""}]},{"tab":"Documentation","pages":[{"title":"Documentation","href":"/docs/sales-navigator"}]},{"tab":"API Reference","groups":[{"group":"Start here","pages":[{"title":"API Overview","href":"/api-reference/api-overview"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Rate limits","href":"/api-reference/rate-limits"}]},{"group":"Account","pages":[{"title":"Credit count","openapi":"openapi.json POST /v1/credits","href":"/api-reference/credit-count"}]},{"group":"Search and discovery","pages":[{"title":"Find people","openapi":"openapi.json POST /v1/find-people","href":"/api-reference/find-people"},{"title":"Leads Finder","openapi":"openapi.json POST /v1/leads-finder","href":"/api-reference/leads-finder"},{"title":"Find companies","openapi":"openapi.json POST /v1/find-companies","href":"/api-reference/find-companies"},{"title":"Company filter values","openapi":"openapi.json GET /v1/find-companies/filter-values","href":"/api-reference/find-companies/filter-values"},{"title":"Company lookalikes","openapi":"openapi.json POST /v1/company-lookalikes","href":"/api-reference/company-lookalikes"},{"title":"Airsearch","openapi":"openapi.json POST /v1/airsearch","href":"/api-reference/airsearch"}]},{"group":"Contact data","pages":[{"title":"Email finder","openapi":"openapi.json POST /v1/email","href":"/api-reference/email-finder"},{"title":"Bulk email finder","openapi":"openapi.json POST /v1/email-bulk","href":"/api-reference/email-finder-(bulk)"},{"title":"Mobile finder","openapi":"openapi.json POST /v1/phone","href":"/api-reference/mobile-finder"},{"title":"Personal email","openapi":"openapi.json POST /v1/personal-email","href":"/api-reference/personal-email"},{"title":"People URL finder","openapi":"openapi.json POST /v1/url-search-people","href":"/api-reference/people-url-finder"}]},{"group":"Profiles and reverse lookup","pages":[{"title":"People profile","openapi":"openapi.json POST /v1/profile","href":"/api-reference/extract-people-profile"},{"title":"Company profile","openapi":"openapi.json POST /v1/company","href":"/api-reference/extract-company-profile"},{"title":"Domain to LinkedIn","openapi":"openapi.json POST /v1/domain-to-linkedin","href":"/api-reference/domain-to-linkedin"},{"title":"Reverse email","openapi":"openapi.json POST /v1/reverse-email","href":"/api-reference/reverse-email"},{"title":"Reverse phone","openapi":"openapi.json POST /v1/reverse-phone","href":"/api-reference/reverse-phone"}]},{"group":"Post engagement","expanded":false,"pages":[{"title":"Post likers","openapi":"openapi.json POST /v1/post-likers","href":"/api-reference/post-likers"},{"title":"Post commenters","openapi":"openapi.json POST /v1/post-commenters","href":"/api-reference/post-commenters"},{"title":"Post search","openapi":"openapi.json POST /v1/post-search","href":"/api-reference/post-search"},{"title":"Profile comments","openapi":"openapi.json POST /v1/profile-comments","href":"/api-reference/profile-comments"},{"title":"Comment likers","openapi":"openapi.json POST /v1/comment-likers","href":"/api-reference/comment-likers"},{"title":"Profile posts","openapi":"openapi.json POST /v1/profile-posts","href":"/api-reference/profile-posts"},{"title":"Company posts","openapi":"openapi.json POST /v1/company-posts","href":"/api-reference/company-posts"}]},{"group":"Intent signals","expanded":false,"pages":[{"group":"Job changes","expanded":false,"pages":[{"title":"Create a job-change monitor","openapi":"openapi.json POST /v1/job-change-monitors","href":"/api-reference/job-change-monitors/create"},{"title":"List job-change monitors","openapi":"openapi.json GET /v1/job-change-monitors","href":"/api-reference/job-change-monitors/list"},{"title":"Get a job-change monitor","openapi":"openapi.json GET /v1/job-change-monitors/{monitor_id}","href":"/api-reference/job-change-monitors/get"},{"title":"Update a job-change monitor","openapi":"openapi.json PATCH /v1/job-change-monitors/{monitor_id}","href":"/api-reference/job-change-monitors/update"},{"title":"Delete a job-change monitor","openapi":"openapi.json DELETE /v1/job-change-monitors/{monitor_id}","href":"/api-reference/job-change-monitors/delete"},{"title":"Add profiles to a job-change monitor","openapi":"openapi.json POST /v1/job-change-monitors/{monitor_id}/profiles","href":"/api-reference/job-change-monitors/profiles/add"},{"title":"Remove a profile from a job-change monitor","openapi":"openapi.json DELETE /v1/job-change-monitors/{monitor_id}/profiles/{profile_id}","href":"/api-reference/job-change-monitors/profiles/remove"},{"title":"List job-change events","openapi":"openapi.json GET /v1/job-change-monitors/{monitor_id}/events","href":"/api-reference/job-change-monitors/events"},{"title":"Mark a job-change event as read","openapi":"openapi.json POST /v1/job-change-monitors/{monitor_id}/events/{event_id}/read","href":"/api-reference/job-change-monitors/events/read"},{"title":"Redeliver a job-change webhook","openapi":"openapi.json POST /v1/job-change-monitors/{monitor_id}/events/{event_id}/webhook/redeliver","href":"/api-reference/job-change-monitors/events/redeliver"}]},{"group":"New hires","expanded":false,"pages":[{"title":"Create a new hire monitor","openapi":"openapi.json POST /v1/new-hire-monitors","href":"/api-reference/new-hire-monitors/create"},{"title":"List new hire monitors","openapi":"openapi.json GET /v1/new-hire-monitors","href":"/api-reference/new-hire-monitors/list"},{"title":"Get a new hire monitor","openapi":"openapi.json GET /v1/new-hire-monitors/{monitor_id}","href":"/api-reference/new-hire-monitors/get"},{"title":"Update a new hire monitor","openapi":"openapi.json PATCH /v1/new-hire-monitors/{monitor_id}","href":"/api-reference/new-hire-monitors/update"},{"title":"Delete a new hire monitor","openapi":"openapi.json DELETE /v1/new-hire-monitors/{monitor_id}","href":"/api-reference/new-hire-monitors/delete"},{"title":"Add companies to a new hire monitor","openapi":"openapi.json POST /v1/new-hire-monitors/{monitor_id}/companies","href":"/api-reference/new-hire-monitors/companies/add"},{"title":"Remove a company from a new hire monitor","openapi":"openapi.json DELETE /v1/new-hire-monitors/{monitor_id}/companies/{identifier}","href":"/api-reference/new-hire-monitors/companies/remove"},{"title":"List new hire events","openapi":"openapi.json GET /v1/new-hire-monitors/{monitor_id}/events","href":"/api-reference/new-hire-monitors/events"},{"title":"Mark a new hire event as read","openapi":"openapi.json POST /v1/new-hire-monitors/{monitor_id}/events/{event_id}/read","href":"/api-reference/new-hire-monitors/events/read"},{"title":"Redeliver a new hire webhook","description":"Send one new hire's webhook again after a failed or unconfirmed delivery. Rate limit: 120 requests per fixed minute per API key, shared by all new hire monitor endpoints.","openapi":"openapi.json POST /v1/new-hire-monitors/{monitor_id}/events/{event_id}/webhook/redeliver","href":"/api-reference/new-hire-monitors/events/redeliver"}]},{"group":"Post engagements","expanded":false,"pages":[{"title":"Create a post engagement monitor","openapi":"openapi.json POST /v1/post-engagement-monitors","href":"/api-reference/post-engagement-monitors/create"},{"title":"List post engagement monitors","description":"List the post engagement monitors in a workspace with their settings, results table, and source, engager and unread counts. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.","openapi":"openapi.json GET /v1/post-engagement-monitors","href":"/api-reference/post-engagement-monitors/list"},{"title":"Get a post engagement monitor","openapi":"openapi.json GET /v1/post-engagement-monitors/{monitor_id}","href":"/api-reference/post-engagement-monitors/get"},{"title":"Update a post engagement monitor","openapi":"openapi.json PATCH /v1/post-engagement-monitors/{monitor_id}","href":"/api-reference/post-engagement-monitors/update"},{"title":"Delete a post engagement monitor","openapi":"openapi.json DELETE /v1/post-engagement-monitors/{monitor_id}","href":"/api-reference/post-engagement-monitors/delete"},{"title":"Add sources to a post engagement monitor","openapi":"openapi.json POST /v1/post-engagement-monitors/{monitor_id}/sources","href":"/api-reference/post-engagement-monitors/sources/add"},{"title":"Remove a source from a post engagement monitor","openapi":"openapi.json DELETE /v1/post-engagement-monitors/{monitor_id}/sources/{source_id}","href":"/api-reference/post-engagement-monitors/sources/remove"},{"title":"List post engagers","openapi":"openapi.json GET /v1/post-engagement-monitors/{monitor_id}/engagers","href":"/api-reference/post-engagement-monitors/engagers"},{"title":"List post engagements","openapi":"openapi.json GET /v1/post-engagement-monitors/{monitor_id}/engagements","href":"/api-reference/post-engagement-monitors/engagements"},{"title":"Mark a post engager as read","openapi":"openapi.json POST /v1/post-engagement-monitors/{monitor_id}/engagers/{engager_id}/read","href":"/api-reference/post-engagement-monitors/engagers/read"},{"title":"Redeliver a post engager webhook","openapi":"openapi.json POST /v1/post-engagement-monitors/{monitor_id}/engagers/{engager_id}/webhook/redeliver","href":"/api-reference/post-engagement-monitors/engagers/redeliver"}]}]},{"group":"Miscellaneous","expanded":false,"pages":[{"title":"Business intent topics","openapi":"openapi.json POST /v1/business-intent-topics","href":"/api-reference/business-intent-topics"},{"title":"Website Technologies","openapi":"openapi.json POST /v1/technologies","href":"/api-reference/miscellaneous/website-technologies"},{"title":"WhatsApp checker","openapi":"openapi.json POST /v1/whatsapp-check","href":"/api-reference/miscellaneous/whatsapp-check"},{"title":"WhatsApp check status","openapi":"openapi.json GET /v1/whatsapp-check/operations/{operation_id}","href":"/api-reference/miscellaneous/whatsapp-check/status"},{"title":"Meta Ads","openapi":"openapi.json POST /v1/meta-ads","href":"/api-reference/miscellaneous/meta-ads"},{"title":"Google Ads","openapi":"openapi.json POST /v1/google-ads","href":"/api-reference/miscellaneous/google-ads"},{"title":"Google Maps","openapi":"openapi.json POST /v1/google-maps","href":"/api-reference/miscellaneous/google-maps"},{"title":"Email verifier","openapi":"openapi.json POST /v1/email-verifier","href":"/api-reference/miscellaneous/email-verifier"},{"title":"US DNC Checker","openapi":"openapi.json POST /v1/us-dnc-check","href":"/api-reference/dnc-checker"},{"title":"UK DNC Checker","openapi":"openapi.json POST /v1/uk-dnc-check","href":"/api-reference/uk-dnc-checker"}]}]},{"tab":"MCP \u0026 Agents","pages":[{"title":"MCP \u0026 Agents","href":"/mcp/how-to-use-the-airscale-mcp"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli/overview"}]},{"tab":"Use cases","pages":[{"title":"Use cases","href":"/usecases/quick-beginner-guide"}]}]},"basePath":"","title":"Create a post engagement monitor - Airschool","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}