Authenticate using HTTP Basic Auth with the Delighted API key as the username and an empty password field; no separate OAuth flow is required.
Send a GET to https://api.delighted.com/v1/survey_responses.json to list responses; the API returns up to 200 records per page.
Use the since and until Unix timestamp parameters to scope the pull to a date range, and use the page parameter (or the since cursor pattern for incremental pulls) to page through results.
Parse each response object for fields including id, person, survey_type (e.g., nps, csat, ces), score, comment, and person_properties for custom metadata.
To filter by survey channel or metric type, pass the survey_type parameter; Delighted supports multiple survey programs per account.
For webhook-driven ingestion, configure a Delighted webhook in the dashboard to POST new responses to your endpoint in real time, reducing the need for full polling.
Known gotchas
The per-page maximum is 200 records; do not assume you have all data after a single request if the response contains exactly 200 records — always check for additional pages.
Person properties are arbitrary key-value metadata set at send time; their schema is not enforced by the API, so validate and sanitize them before inserting into a structured data store.
Delighted is owned by Qualtrics; feature availability and API behavior may vary depending on whether the account is a legacy Delighted standalone account or a Qualtrics-provisioned account.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp