Attaches a note to a signal, an account or a list.
Workspace-visible, deliberately: a colleague who cannot see that somebody already called them will call again. A note on a signal also notifies everyone already in that conversation, minus the author.
A workspace API key, created in workspace settings and sent as Authorization: Bearer op_live_…. Session cookies are not accepted. Scopes: signals:read, accounts:read, listeners:read, listeners:analyse, pipeline:read, pipeline:write, collections:write, export:read.
The note itself. Trimmed on write. Long enough for a real handover note, short enough that nobody pastes a transcript into a list view.
Required string length: 1 - 5000
Response
The note, as written.
A note on a signal, an account or a list. Workspace-visible, deliberately: a colleague who cannot see that somebody already called them will call again.
Set only when the body changed after it was first written.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Open Pulse","description":"Open Pulse finds public conversations that are evidence somebody has a budgeted problem, and scores each one against what you sell.","colors":{"primary":"#446317","light":"#C6E868","dark":"#446317"},"logo":{"light":"https://mintcdn.com/open-pulse/2lhu05m2dSiIFlof/logo/light.svg?fit=max\u0026auto=format\u0026n=2lhu05m2dSiIFlof\u0026q=85\u0026s=a403a5531b58270dadb02f1862164683","dark":"https://mintcdn.com/open-pulse/2lhu05m2dSiIFlof/logo/dark.svg?fit=max\u0026auto=format\u0026n=2lhu05m2dSiIFlof\u0026q=85\u0026s=518fb339322cbf15840dff18d8da3847"},"favicon":"https://mintcdn.com/open-pulse/P8LbHWHUpEv-R7cz/favicon.svg?fit=max\u0026auto=format\u0026n=P8LbHWHUpEv-R7cz\u0026q=85\u0026s=4f377ad25662c68808d611467995875a","navbar":{"links":[{"href":"https://openpulse.cloud/sign-in","label":"Sign in"}],"primary":{"type":"button","label":"Get started","href":"https://openpulse.cloud/pricing"}},"footer":{"links":[{"header":"Open Pulse","items":[{"label":"Product","href":"https://openpulse.cloud"},{"label":"Pricing","href":"https://openpulse.cloud/pricing"},{"label":"Developers","href":"https://openpulse.cloud/developers"}]},{"header":"Follow","items":[{"label":"TikTok","href":"https://www.tiktok.com/@getopenpulse"},{"label":"X","href":"https://x.com/getopenpulse"},{"label":"Instagram","href":"https://www.instagram.com/getopenpulse"}]}]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"open-pulse","hasAudioNarration":false,"actualSubdomain":"open-pulse","customDomains":["docs.openpulse.cloud"],"gitSource":{"type":"github","owner":"optiqlabs","repo":"open-pulse","deployBranch":"develop","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ae17d044eb6f5188cc094f4","collectionId":"88fa9485-d841-4c17-9d70-2fa1eaff8c23","liveDeploymentHistoryId":"6ae17d044eb6f5188cc094f4","schemaVersion":"v3"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ae17d044eb6f5188cc094f4","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"Guides","count":22},{"language":"default","tag":"API Reference","count":20},{"language":"default","tag":"Integrations","count":5},{"language":"default","tag":"Pipeline","count":5},{"language":"default","tag":"Selling Surfaces","count":4},{"language":"default","tag":"Results","count":4},{"language":"default","tag":"Working Leads","count":3},{"language":"default","tag":"Delivering \u0026 Managing","count":3},{"language":"default","tag":"Listeners \u0026 Runs","count":3},{"language":"default","tag":"Exports","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/notes/write-a-note","slug":"/api-reference/notes/write-a-note","pageMetadata":{"title":"Write a note","description":"Attaches a note to a signal, an account or a list.\n\n**Workspace-visible**, deliberately: a colleague who cannot see that somebody already called them will call again. A note on a signal also notifies everyone already in that conversation, minus the author.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/notes","href":"/api-reference/notes/write-a-note","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Attaches a note to a signal, an account or a list.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Workspace-visible\"\n }), \", deliberately: a colleague who cannot see that somebody already called them will call again. A note on a signal also notifies everyone already in that conversation, minus the author.\"]\n })]\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}=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":{"title":"Write a note","description":"Attaches a note to a signal, an account or a list.\n\n**Workspace-visible**, deliberately: a colleague who cannot see that somebody already called them will call again. A note on a signal also notifies everyone already in that conversation, minus the author.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/notes","href":"/api-reference/notes/write-a-note","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"postV1Notes","summary":"Write a note","description":"Attaches a note to a signal, an account or a list.\n\n**Workspace-visible**, deliberately: a colleague who cannot see that somebody already called them will call again. A note on a signal also notifies everyone already in that conversation, minus the author.","tags":["notes"],"security":["2b6ded13-2d6e-4059-bfbb-5fb056f850da"],"parameters":[],"requestBody":"7ac4106f-abd9-49a7-8cde-dbeaf99d62ea","responses":{"201":"2b7bbef9-89ca-4874-b0a0-c10858002850","400":"94fa33dc-b180-4d9d-aaa2-b4e0c13ac611","401":"f48fd6c1-c196-4550-8195-56427e6f273d","402":"6d5f9ecb-29f2-4cfe-a707-66af177f66ba","403":"1b4f858a-acdb-4b3e-9498-b8f70395e3ac","429":"290a2304-618d-46ec-93ae-fc9df4845d45"},"method":"post","type":"path","servers":["15b4899c-a482-4812-8f0c-fad24a079ee3"],"path":"/v1/notes","baseUrlOptions":["https://api.openpulse.cloud"],"title":"Write a note","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"description":"What the note says, and what it is about.","content":{"application/json":{"schema":{"type":"object","required":["subject","body"],"properties":{"subject":{"type":"object","description":"What to attach it to.","required":["type","id"],"properties":{"type":{"type":"string","enum":["signal","account","collection"],"description":"Which kind of thing. Note that `collection` is the vocabulary here — there is no `pipeline` subject.","isRequired":true,"uniqueKey":"subject.type","typeLabel":"enum\u003cstring>"},"id":{"type":"string","description":"Its id: a signal id for `signal`, an `accountKey` for `account`, a list id for `collection`. **Not validated against the thing it names** — a note on an id that does not exist is accepted and simply never shown.","minLength":1,"maxLength":200,"isRequired":true,"uniqueKey":"subject.id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"subject","typeLabel":"object"},"body":{"type":"string","description":"The note itself. Trimmed on write. Long enough for a real handover note, short enough that nobody pastes a transcript into a list view.","minLength":1,"maxLength":5000,"isRequired":true,"uniqueKey":"body","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"subject":{"id":"\u003cstring>"},"body":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"2b7bbef9-89ca-4874-b0a0-c10858002850":{"description":"The note, as written.","content":{"application/json":{"schema":{"type":"object","description":"A note on a signal, an account or a list. **Workspace-visible**, deliberately: a colleague who cannot see that somebody already called them will call again.","required":["id","orgId","subject","body","authorId","createdAt","updatedAt"],"properties":{"id":{"type":"string","description":"Stable identifier.","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"orgId":{"type":"string","description":"The workspace this belongs to (`org_…`).","isRequired":true,"uniqueKey":"orgId","typeLabel":"string"},"subject":{"type":"object","description":"What the note is attached to.","required":["type","id"],"properties":{"type":{"type":"string","enum":["signal","account","collection"],"description":"Which kind of thing.","isRequired":true,"uniqueKey":"subject.type","typeLabel":"enum\u003cstring>"},"id":{"type":"string","description":"Its id — a signal id, an `accountKey`, or a collection id.","isRequired":true,"uniqueKey":"subject.id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"subject","typeLabel":"object"},"body":{"type":"string","description":"The note, trimmed. Up to 5,000 characters.","isRequired":true,"uniqueKey":"body","typeLabel":"string"},"authorId":{"type":"string","description":"Clerk user id of whoever wrote it.","isRequired":true,"uniqueKey":"authorId","typeLabel":"string"},"createdAt":{"type":"string","format":"date-time","description":"When it was written.","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","description":"When the row last changed.","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time>"},"editedAt":{"type":"string","format":"date-time","description":"Set only when the body changed after it was first written.","uniqueKey":"editedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","orgId":"\u003cstring>","subject":{"type":"signal","id":"\u003cstring>"},"body":"\u003cstring>","authorId":"\u003cstring>","createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","editedAt":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"94fa33dc-b180-4d9d-aaa2-b4e0c13ac611":{"description":"`subject` or `body` is missing, empty, or fails validation.","content":{"application/json":{"schema":{"type":"object","description":"What went wrong, in a shape every failing route shares.","required":["message"],"properties":{"message":{"type":"string","description":"Human-readable explanation, safe to show a user.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code, when the failure has one worth branching on. `website_unreadable` and `forbidden` are the two a caller acts on.","uniqueKey":"code","typeLabel":"string"},"detail":{"description":"Validator output on a 400, as an array of issues naming the offending field. Diagnostic only: the shape comes from the validation library and is not part of the contract.","uniqueKey":"detail","typeLabel":"any"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"\u003cstring>","detail":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"},"f48fd6c1-c196-4550-8195-56427e6f273d":{"description":"The key is missing, malformed, expired or revoked.","content":{"application/json":{"schema":{"type":"object","description":"What went wrong, in a shape every failing route shares.","required":["message"],"properties":{"message":{"type":"string","description":"Human-readable explanation, safe to show a user.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code, when the failure has one worth branching on. `website_unreadable` and `forbidden` are the two a caller acts on.","uniqueKey":"code","typeLabel":"string"},"detail":{"description":"Validator output on a 400, as an array of issues naming the offending field. Diagnostic only: the shape comes from the validation library and is not part of the contract.","uniqueKey":"detail","typeLabel":"any"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"\u003cstring>","detail":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"},"6d5f9ecb-29f2-4cfe-a707-66af177f66ba":{"description":"The workspace's plan does not include notes. The body names the plan it holds and the entitlement it is missing. **Not a 403**: the key is fine, the subscription is not, and widening the key will not help.","content":{"application/json":{"schema":{"type":"object","description":"A refusal about entitlement: the workspace's plan does not include this. The fix is a subscription change, never a change to the key.","required":["message","code","plan"],"properties":{"message":{"type":"string","description":"Human-readable explanation, safe to show a user. Names the plan where one would help.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","enum":["plan_required","listener_limit_reached","webhook_limit_reached","cadence_not_allowed","competitor_access_required","competitor_limit_reached","competitor_collect_cooldown","analyse_quota_reached","run_quota_reached","source_not_allowed","custom_scoring_access_required","collection_limit_reached","notes_access_required","account_access_required","territory_access_required","pipeline_access_required","assignment_access_required","export_quota_reached","crm_export_access_required","urgency_alert_access_required","draft_quota_reached","api_key_limit_reached","content_channel_access_required","image_draw_limit_reached","refinement_limit_reached","content_quota_reached"],"description":"Which entitlement was missing. Branch on this rather than on `message`.","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"plan":{"type":"string","enum":["op_go","op_growth","op_pro","op_enterprise","none"],"description":"What the workspace holds today. `none` means no subscription.","isRequired":true,"uniqueKey":"plan","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"plan_required","plan":"op_go"}}},"exampleType":"generated"}},"exampleType":"generated"},"1b4f858a-acdb-4b3e-9498-b8f70395e3ac":{"description":"The key lacks the `collections:write` scope.","content":{"application/json":{"schema":{"type":"object","description":"What went wrong, in a shape every failing route shares.","required":["message"],"properties":{"message":{"type":"string","description":"Human-readable explanation, safe to show a user.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code, when the failure has one worth branching on. `website_unreadable` and `forbidden` are the two a caller acts on.","uniqueKey":"code","typeLabel":"string"},"detail":{"description":"Validator output on a 400, as an array of issues naming the offending field. Diagnostic only: the shape comes from the validation library and is not part of the contract.","uniqueKey":"detail","typeLabel":"any"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"\u003cstring>","detail":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"},"290a2304-618d-46ec-93ae-fc9df4845d45":{"description":"Too many requests from this key. `Retry-After` carries the seconds to wait.","content":{"application/json":{"schema":{"type":"object","description":"What went wrong, in a shape every failing route shares.","required":["message"],"properties":{"message":{"type":"string","description":"Human-readable explanation, safe to show a user.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code, when the failure has one worth branching on. `website_unreadable` and `forbidden` are the two a caller acts on.","uniqueKey":"code","typeLabel":"string"},"detail":{"description":"Validator output on a 400, as an array of issues naming the offending field. Diagnostic only: the shape comes from the validation library and is not part of the contract.","uniqueKey":"detail","typeLabel":"any"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"\u003cstring>","detail":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"2b6ded13-2d6e-4059-bfbb-5fb056f850da":{"apiKey":{"type":"http","scheme":"bearer","description":"A workspace API key, created in workspace settings and sent as `Authorization: Bearer op_live_…`. Session cookies are not accepted. Scopes: signals:read, accounts:read, listeners:read, listeners:analyse, pipeline:read, pipeline:write, collections:write, export:read.","scopes":["collections:write"],"schemeName":"apiKey"}}},"servers":{"15b4899c-a482-4812-8f0c-fad24a079ee3":{"url":"https://api.openpulse.cloud","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"A workspace API key, created in workspace settings and sent as `Authorization: Bearer op_live_…`. Session cookies are not accepted. Scopes: signals:read, accounts:read, listeners:read, listeners:analyse, pipeline:read, pipeline:write, collections:write, export:read.","scopes":["collections:write"],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A workspace API key, created in workspace settings and sent as `Authorization: Bearer op_live_…`. Session cookies are not accepted. Scopes: signals:read, accounts:read, listeners:read, listeners:analyse, pipeline:read, pipeline:write, collections:write, export:read.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"open-pulse","siteName":"Open Pulse","title":"Write a note - Open Pulse","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T06:52:28.557Z","originalFileLocation":"api-reference/notes/write-a-note.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Attaches a note to a signal, an account or a list. Workspace-visible, deliberately: a colleague who cannot see that somebody already called them will call again. A note on a signal also notifies everyone already in that conversation, minus the author.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Open Pulse\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/open-pulse/_XSUl-ciJBzq3c0r/_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/open-pulse/_XSUl-ciJBzq3c0r/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/open-pulse/_XSUl-ciJBzq3c0r/_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/open-pulse/_XSUl-ciJBzq3c0r/_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/open-pulse/_XSUl-ciJBzq3c0r/_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/open-pulse/_XSUl-ciJBzq3c0r/_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/open-pulse/_XSUl-ciJBzq3c0r/_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/open-pulse/_XSUl-ciJBzq3c0r/_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/open-pulse/_XSUl-ciJBzq3c0r/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Write a note - Open Pulse\">\u003cmeta data-mint-head property=\"og:description\" content=\"Attaches a note to a signal, an account or a list. Workspace-visible, deliberately: a colleague who cannot see that somebody already called them will call again. A note on a signal also notifies everyone already in that conversation, minus the author.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Open Pulse\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.openpulse.cloud/api-reference/notes/write-a-note\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://open-pulse.mintlify.site/_mintlify/api/og/v2?division=Collections+%26+Notes\u0026amp;title=Write+a+note\u0026amp;description=Attaches+a+note+to+a+signal%2C+an+account+or+a+list.%0A%0A**Workspace-visible**%2C+deliberately%3A+a+colleague+who+cannot+see+that+somebody+already+called+them+will+call+\u0026amp;theme=d63bc05a3d20cd1eea42e14a\u0026amp;signature=e312d43619534433332433ce51326b3f8ca71396a032c7827f4210fae1b6d2f2\">\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=\"Write a note - Open Pulse\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Attaches a note to a signal, an account or a list. Workspace-visible, deliberately: a colleague who cannot see that somebody already called them will call again. A note on a signal also notifies everyone already in that conversation, minus the author.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://open-pulse.mintlify.site/_mintlify/api/og/v2?division=Collections+%26+Notes\u0026amp;title=Write+a+note\u0026amp;description=Attaches+a+note+to+a+signal%2C+an+account+or+a+list.%0A%0A**Workspace-visible**%2C+deliberately%3A+a+colleague+who+cannot+see+that+somebody+already+called+them+will+call+\u0026amp;theme=d63bc05a3d20cd1eea42e14a\u0026amp;signature=e312d43619534433332433ce51326b3f8ca71396a032c7827f4210fae1b6d2f2\">\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/open-pulse/_XSUl-ciJBzq3c0r/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Open Pulse\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#446317\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.openpulse.cloud/api-reference/notes/write-a-note\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/notes/write-a-note.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.openpulse.cloud/#organization\",\"name\":\"Open Pulse\",\"url\":\"https://docs.openpulse.cloud\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/open-pulse/2lhu05m2dSiIFlof/logo/light.svg?fit=max\u0026auto=format\u0026n=2lhu05m2dSiIFlof\u0026q=85\u0026s=a403a5531b58270dadb02f1862164683\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.openpulse.cloud#website\",\"name\":\"Open Pulse\",\"url\":\"https://docs.openpulse.cloud\",\"publisher\":{\"@id\":\"https://docs.openpulse.cloud/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.openpulse.cloud/api-reference/notes/write-a-note#webpage\",\"url\":\"https://docs.openpulse.cloud/api-reference/notes/write-a-note\",\"name\":\"Write a note\",\"description\":\"Attaches a note to a signal, an account or a list. Workspace-visible, deliberately: a colleague who cannot see that somebody already called them will call again. A note on a signal also notifies everyone already in that conversation, minus the author.\",\"dateModified\":\"2026-10-27T06:52:28.557Z\",\"isPartOf\":{\"@id\":\"https://docs.openpulse.cloud#website\"},\"breadcrumb\":{\"@id\":\"https://docs.openpulse.cloud/api-reference/notes/write-a-note#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.openpulse.cloud/api-reference/notes/write-a-note#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Collections \u0026 Notes\",\"item\":\"https://docs.openpulse.cloud/api-reference/collections/create-a-list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Write a note\",\"item\":\"https://docs.openpulse.cloud/api-reference/notes/write-a-note\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.openpulse.cloud/api-reference/notes/write-a-note#apireference\",\"headline\":\"Write a note\",\"name\":\"Write a note\",\"description\":\"Attaches a note to a signal, an account or a list. Workspace-visible, deliberately: a colleague who cannot see that somebody already called them will call again. A note on a signal also notifies everyone already in that conversation, minus the author.\",\"url\":\"https://docs.openpulse.cloud/api-reference/notes/write-a-note\",\"mainEntityOfPage\":{\"@id\":\"https://docs.openpulse.cloud/api-reference/notes/write-a-note#webpage\"},\"dateModified\":\"2026-10-27T06:52:28.557Z\",\"publisher\":{\"@id\":\"https://docs.openpulse.cloud/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.openpulse.cloud#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Open Pulse\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Open Pulse","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Listeners","pages":[{"title":"List listeners","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/listeners","href":"/api-reference/listeners/list-listeners"},{"title":"Get one listener","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/listeners/{id}","href":"/api-reference/listeners/get-one-listener"},{"title":"Derive a listener plan from a website","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/listeners/analyse-website","href":"/api-reference/listeners/derive-a-listener-plan-from-a-website"}]},{"group":"Results","pages":[{"title":"List signals","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/results","href":"/api-reference/results/list-signals"},{"title":"Get one signal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/results/{id}","href":"/api-reference/results/get-one-signal"},{"title":"Count signals in a window","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/results/stats","href":"/api-reference/results/count-signals-in-a-window"},{"title":"Save a signal to a list","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/signals/{id}/save","href":"/api-reference/signals/save-a-signal-to-a-list"}]},{"group":"Accounts","pages":[{"title":"List accounts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/accounts","href":"/api-reference/accounts/list-accounts"},{"title":"Get one account","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/accounts/{key}","href":"/api-reference/accounts/get-one-account"}]},{"group":"Pipeline","pages":[{"title":"List deals","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/pipeline","href":"/api-reference/pipeline/list-deals"},{"title":"Add a deal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/pipeline","href":"/api-reference/pipeline/add-a-deal"},{"title":"Update a deal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/pipeline/{id}","href":"/api-reference/pipeline/update-a-deal"},{"title":"Add several deals at once","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/pipeline/bulk","href":"/api-reference/pipeline/add-several-deals-at-once"},{"title":"Pipeline return over a window","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/pipeline/roi","href":"/api-reference/pipeline/pipeline-return-over-a-window"}]},{"group":"Collections \u0026 Notes","pages":[{"title":"Create a list","description":"A named list to save signals into, shared across the workspace — a colleague who cannot see a list does the work twice, so `createdBy` is attribution rather than access control.\n\nCounts against the plan's list cap. The workspace's `saved` collection does not: it is a system list created on first use, and charging for it would be charging for a star.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/collections","href":"/api-reference/collections/create-a-list"},{"title":"Write a note","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/notes","href":"/api-reference/notes/write-a-note"}]},{"group":"Content","pages":[{"title":"Download a push's content as a zip","description":"Every piece written for one push, plus its assets, as a zip archive.\n\nUnlike the CSV exports this has **no admin gate and no quota**: one push is already one thing somebody is looking at, so the narrowing rule has nothing to protect, and the pieces inside were paid for per target when they were generated. Charging a second time to read what you already own would be charging twice for one thing.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/content/pushes/{id}/export.zip","href":"/api-reference/content/download-a-pushs-content-as-a-zip"}]},{"group":"Exports","pages":[{"title":"Export accounts as CSV","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/exports/accounts.csv","href":"/api-reference/exports/export-accounts-as-csv"},{"title":"Export the pipeline as CSV","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/exports/pipeline.csv","href":"/api-reference/exports/export-the-pipeline-as-csv"},{"title":"Export signals as CSV","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/exports/signals.csv","href":"/api-reference/exports/export-signals-as-csv"}]}]}]},"basePath":"","title":"Write a note - Open Pulse","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js","Markdown-D7Ofw1oz.js","clsx-eKJ4rcii.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CwjSCXIK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-9EK5IAXV.js"]}