Build NPS, rating, choice, and text surveys, publish them by API, and distribute over SMS, WhatsApp, email, or embeds with consent checks and attribution.
Surveys is a standalone Contact Button product with its own dashboard, side-menu destination, public experience, and API v1 resources. The dashboard and API both read and write the same survey definition, including stable question IDs, brand design, respondent fields, conditional routing, publishing state, and distribution settings.
Question types
nps accepts a score from 0 through 10.
rating accepts a configured scale from 2 through 10.
choice accepts one configured option.
multiple_choice accepts one or more configured options.
text accepts an open response.
Each question has a stable ID. Persist those IDs in integrations instead of relying on question order or copy. A question can optionally route forward to another question when an answer matches its branching rule.
Publish and collect
Create or update a survey under /v1/workspaces/{workspace}/surveys. Setting status to published activates its browser URL and the unauthenticated /v1/public/surveys/{survey} representation. Public responses are rate limited and accept an Idempotency-Key, so a client can safely retry after a network failure.The response endpoint validates every answer against the live survey definition. Respondent identity is optional and a matching existing workspace contact is linked without copying data across tenant boundaries.
SMS and WhatsApp preflight
Use /distribution-preview before handing a message to a channel adapter. The preflight validates the E.164 recipient, consent source and capture time, locale, SMS sender readiness, and WhatsApp Business template requirements. It returns the final attributed survey URL and message but does not send anything.
Never infer consent from the presence of a phone number. Store the channel-specific consent source and capture time with every delivery request, and continue to enforce opt-out and quiet-hour rules in the provider adapter.
Survey links include channel=sms, channel=whatsapp, channel=email, channel=embed, or another allowed source. The response stores that channel for attribution and results reporting.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Contact Button","description":"Create contact buttons and button.contact pages that people and AI agents can discover, understand, and use safely.","colors":{"primary":"#1D4ED8","light":"#60A5FA","dark":"#3B82F6"},"logo":{"light":"https://mintcdn.com/contact-button/IEzJIBz0xg-pMM5T/assets/contact-button-logo-blue.svg?fit=max\u0026auto=format\u0026n=IEzJIBz0xg-pMM5T\u0026q=85\u0026s=e977bf528648cb6c541e8d965b89b727","dark":"https://mintcdn.com/contact-button/IEzJIBz0xg-pMM5T/assets/contact-button-logo-white.svg?fit=max\u0026auto=format\u0026n=IEzJIBz0xg-pMM5T\u0026q=85\u0026s=677791adf371fc479066aa6e50da89b9","href":"https://app.contactbutton.com"},"favicon":"https://mintcdn.com/contact-button/plqKUjitvU8FjEe3/assets/contact-button.png?fit=max\u0026auto=format\u0026n=plqKUjitvU8FjEe3\u0026q=85\u0026s=69d1d22b4f12647b87ef9a2c1d09080f","appearance":{"default":"system"},"background":{"color":{"light":"#FFFFFF","dark":"#1E1E2D"}},"navbar":{"links":[{"href":"https://agents.contactbutton.com","label":"Agents"},{"href":"https://learn.contactbutton.com","label":"Learn"},{"href":"https://app.contactbutton.com","label":"Dashboard"}],"primary":{"type":"button","label":"Create an account","href":"https://app.contactbutton.com/register"}},"footer":{"socials":{"x":"https://x.com/contactbutton"}},"seo":{"metatags":{"canonical":"https://docs.contactbutton.com"}},"fonts":{"family":"Inter"},"styling":{"eyebrows":"breadcrumbs","latex":true},"contextual":{"options":["copy","view","chatgpt","claude","mcp"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"contact-button","hasAudioNarration":false,"actualSubdomain":"contact-button","customDomains":["docs.contactbutton.com"],"gitSource":{"type":"github","owner":"letail","repo":"contact-button","deployBranch":"main","contentDirectory":"mintlify","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afb62a9128103744c737246","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API Reference","count":236},{"language":"default","tag":"Conversations","count":30},{"language":"default","tag":"Agents","count":27},{"language":"default","tag":"Engagement inbox","count":27},{"language":"default","tag":"Knowledge","count":27},{"language":"default","tag":"Documentation","count":26},{"language":"default","tag":"Commerce","count":26},{"language":"default","tag":"Public actions","count":19},{"language":"default","tag":"Telephony","count":14},{"language":"default","tag":"Build","count":13}]},"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":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"guides/surveys","slug":"/guides/surveys","pageMetadata":{"title":"Surveys","description":"Build NPS, rating, choice, and text surveys, publish them by API, and distribute over SMS, WhatsApp, email, or embeds with consent checks and attribution.","href":"/guides/surveys"},"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: \"Build NPS, rating, choice, and text surveys, publish them by API, and distribute over SMS, WhatsApp, email, or embeds with consent checks and attribution.\"\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={code:`code`,li:`li`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Surveys is a standalone Contact Button product with its own dashboard, side-menu destination, public experience, and API v1 resources. The dashboard and API both read and write the same survey definition, including stable question IDs, brand design, respondent fields, conditional routing, publishing state, and distribution settings.`}),`\n`,_jsx(Heading,{level:`2`,id:`question-types`,children:`Question types`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`nps`}),` accepts a score from 0 through 10.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`rating`}),` accepts a configured scale from 2 through 10.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`choice`}),` accepts one configured option.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`multiple_choice`}),` accepts one or more configured options.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`text`}),` accepts an open response.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Each question has a stable ID. Persist those IDs in integrations instead of relying on question order or copy. A question can optionally route forward to another question when an answer matches its branching rule.`}),`\n`,_jsx(Heading,{level:`2`,id:`publish-and-collect`,children:`Publish and collect`}),`\n`,_jsxs(_components.p,{children:[`Create or update a survey under `,_jsx(_components.code,{children:`/v1/workspaces/{workspace}/surveys`}),`. Setting `,_jsx(_components.code,{children:`status`}),` to `,_jsx(_components.code,{children:`published`}),` activates its browser URL and the unauthenticated `,_jsx(_components.code,{children:`/v1/public/surveys/{survey}`}),` representation. Public responses are rate limited and accept an `,_jsx(_components.code,{children:`Idempotency-Key`}),`, so a client can safely retry after a network failure.`]}),`\n`,_jsx(_components.p,{children:`The response endpoint validates every answer against the live survey definition. Respondent identity is optional and a matching existing workspace contact is linked without copying data across tenant boundaries.`}),`\n`,_jsx(Heading,{level:`2`,id:`sms-and-whatsapp-preflight`,children:`SMS and WhatsApp preflight`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`/distribution-preview`}),` before handing a message to a channel adapter. The preflight validates the E.164 recipient, consent source and capture time, locale, SMS sender readiness, and WhatsApp Business template requirements. It returns the final attributed survey URL and message but does not send anything.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Never infer consent from the presence of a phone number. Store the channel-specific consent source and capture time with every delivery request, and continue to enforce opt-out and quiet-hour rules in the provider adapter.`})}),`\n`,_jsxs(_components.p,{children:[`Survey links include `,_jsx(_components.code,{children:`channel=sms`}),`, `,_jsx(_components.code,{children:`channel=whatsapp`}),`, `,_jsx(_components.code,{children:`channel=email`}),`, `,_jsx(_components.code,{children:`channel=embed`}),`, or another allowed source. The response stores that channel for attribution and results reporting.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Surveys","description":"Build NPS, rating, choice, and text surveys, publish them by API, and distribute over SMS, WhatsApp, email, or embeds with consent checks and attribution.","href":"/guides/surveys"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Question types","slug":"question-types","depth":2,"children":[]},{"title":"Publish and collect","slug":"publish-and-collect","depth":2,"children":[]},{"title":"SMS and WhatsApp preflight","slug":"sms-and-whatsapp-preflight","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"contact-button","siteName":"Contact Button","title":"Surveys - Contact Button","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-23T16:57:07.587Z","originalFileLocation":"guides/surveys.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=\"Build NPS, rating, choice, and text surveys, publish them by API, and distribute over SMS, WhatsApp, email, or embeds with consent checks and attribution.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Contact Button\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/contact-button/qj_MNR2p2anKNWgL/_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/contact-button/qj_MNR2p2anKNWgL/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/contact-button/qj_MNR2p2anKNWgL/_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/contact-button/qj_MNR2p2anKNWgL/_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/contact-button/qj_MNR2p2anKNWgL/_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/contact-button/qj_MNR2p2anKNWgL/_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/contact-button/qj_MNR2p2anKNWgL/_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/contact-button/qj_MNR2p2anKNWgL/_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/contact-button/qj_MNR2p2anKNWgL/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Surveys - Contact Button\">\u003cmeta data-mint-head property=\"og:description\" content=\"Build NPS, rating, choice, and text surveys, publish them by API, and distribute over SMS, WhatsApp, email, or embeds with consent checks and attribution.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Contact Button\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.contactbutton.com/guides/surveys\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://contact-button.mintlify.site/_mintlify/api/og/v2?division=Build\u0026amp;title=Surveys\u0026amp;description=Build+NPS%2C+rating%2C+choice%2C+and+text+surveys%2C+publish+them+by+API%2C+and+distribute+over+SMS%2C+WhatsApp%2C+email%2C+or+embeds+with+consent+checks+and+attribution.\u0026amp;theme=2ec528e58d900f8944ffed7d\u0026amp;signature=85690f57bcd0095bc1006d5209454bdd9f56fc2024eeb02caa5f2c0dbb02223e\">\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=\"Surveys - Contact Button\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Build NPS, rating, choice, and text surveys, publish them by API, and distribute over SMS, WhatsApp, email, or embeds with consent checks and attribution.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://contact-button.mintlify.site/_mintlify/api/og/v2?division=Build\u0026amp;title=Surveys\u0026amp;description=Build+NPS%2C+rating%2C+choice%2C+and+text+surveys%2C+publish+them+by+API%2C+and+distribute+over+SMS%2C+WhatsApp%2C+email%2C+or+embeds+with+consent+checks+and+attribution.\u0026amp;theme=2ec528e58d900f8944ffed7d\u0026amp;signature=85690f57bcd0095bc1006d5209454bdd9f56fc2024eeb02caa5f2c0dbb02223e\">\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/contact-button/qj_MNR2p2anKNWgL/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Contact Button\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1D4ED8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.contactbutton.com/guides/surveys\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/surveys.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.contactbutton.com/#organization\",\"name\":\"Contact Button\",\"url\":\"https://docs.contactbutton.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/contact-button/IEzJIBz0xg-pMM5T/assets/contact-button-logo-blue.svg?fit=max\u0026auto=format\u0026n=IEzJIBz0xg-pMM5T\u0026q=85\u0026s=e977bf528648cb6c541e8d965b89b727\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.contactbutton.com#website\",\"name\":\"Contact Button\",\"url\":\"https://docs.contactbutton.com\",\"publisher\":{\"@id\":\"https://docs.contactbutton.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.contactbutton.com/guides/surveys#webpage\",\"url\":\"https://docs.contactbutton.com/guides/surveys\",\"name\":\"Surveys\",\"description\":\"Build NPS, rating, choice, and text surveys, publish them by API, and distribute over SMS, WhatsApp, email, or embeds with consent checks and attribution.\",\"dateModified\":\"2026-07-23T16:57:07.587Z\",\"isPartOf\":{\"@id\":\"https://docs.contactbutton.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.contactbutton.com/guides/surveys#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.contactbutton.com/guides/surveys#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Build\",\"item\":\"https://docs.contactbutton.com/guides/pages-domains\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Surveys\",\"item\":\"https://docs.contactbutton.com/guides/surveys\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.contactbutton.com/guides/surveys#article\",\"headline\":\"Surveys\",\"name\":\"Surveys\",\"description\":\"Build NPS, rating, choice, and text surveys, publish them by API, and distribute over SMS, WhatsApp, email, or embeds with consent checks and attribution.\",\"url\":\"https://docs.contactbutton.com/guides/surveys\",\"mainEntityOfPage\":{\"@id\":\"https://docs.contactbutton.com/guides/surveys#webpage\"},\"dateModified\":\"2026-07-23T16:57:07.587Z\",\"publisher\":{\"@id\":\"https://docs.contactbutton.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.contactbutton.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Contact Button\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Contact Button\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/guides/surveys.md","siteName":"Contact Button","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","groups":[{"group":"Get started","pages":[{"title":"Contact infrastructure for people and agents","href":""},{"title":"API quickstart","href":"/quickstart"},{"title":"Authentication","href":"/authentication"},{"title":"API and MCP surfaces","href":"/reference/api-surfaces"},{"title":"API-first architecture","href":"/concepts/api-first"}]},{"group":"Contact Button CLI","pages":[{"title":"Contact Button CLI","href":"/cli/overview"},{"title":"Install the CLI","href":"/cli/install"},{"title":"CLI authentication","href":"/cli/authentication"},{"title":"CLI command reference","href":"/cli/commands"},{"title":"CLI automation and coding agents","href":"/cli/automation"}]},{"group":"Build","pages":[{"title":"Pages and custom domains","href":"/guides/pages-domains"},{"title":"Buttons, apps, and forms","href":"/guides/buttons-apps-forms"},{"title":"AI and support in your app","description":"Copy the AI \u0026 Support button template and open its screens from your application's header.","href":"/guides/portal-help-widget"},{"title":"Surveys","href":"/guides/surveys"},{"title":"Bookings and callbacks","description":"Publish native booking event types, expose public availability by timezone, and let agents request confirmed bookings or callbacks with emailed OTPs.","href":"/guides/booking-callbacks"},{"title":"Contact Button webhooks","href":"/guides/webhooks"},{"title":"Customer Follow-ups","href":"/guides/customer-followups"},{"title":"Connect Telnyx","href":"/guides/telnyx"},{"title":"Products, support, and memberships","href":"/guides/creator-commerce"},{"title":"Reviews","href":"/guides/reviews"},{"title":"Knowledge lists","href":"/guides/knowledge"},{"title":"Human and agent chat","href":"/guides/chat"},{"title":"Conversations API","href":"/guides/conversations-api"}]},{"group":"Operate","pages":[{"title":"API errors","href":"/reference/errors"},{"title":"Backwards compatibility","href":"/guides/backwards-compatibility"},{"title":"Rollout and rollback","href":"/guides/rollout"}]}]},{"tab":"Agents","icon":"robot","pages":[{"title":"Agents","href":"/agents/overview"}]},{"tab":"API Reference","icon":"square-terminal","pages":[{"title":"API Reference","href":"/api-reference/onboarding/inspect-the-public-api-entry-point"}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Surveys - Contact Button","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":[],"chunks":[]}