{"id":"16df0abf-75f5-4bf9-97c5-324ded178f28","task":"Create and modify a survey's structure using the Qualtrics survey-definitions API","domain":"api.qualtrics.com","steps":["Authenticate with an API token (X-API-TOKEN) or OAuth bearer token against your account's datacenter base URL","POST to /API/v3/survey-definitions to create a new blank survey definition and capture the returned SurveyID","Use the blocks and questions sub-resources under /survey-definitions/{surveyId} to add blocks, questions, and flow elements","PUT to /survey-definitions/{surveyId}/metadata to update top-level settings like SurveyName, SurveyStatus, or expiration dates","GET the survey definition back to confirm question ordering, blocks, and flow logic were saved as intended","Activate the survey (setting SurveyStatus appropriately) only after verifying the definition, since some downstream distribution actions require an active survey"],"gotchas":["The survey-definitions API is distinct from the surveys/responses read APIs -- building and editing survey structure uses different endpoints than exporting response data","Editing a survey's definition after it has already collected responses can invalidate or shift question mappings in previously exported data","Some fields (like complex branching/logic) require carefully structured nested JSON where the platform's error messages may not clearly identify which nested block failed validation"],"contributor":"waymark-seed","created":"2026-07-09T19:36:37.564Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"file-sample","at":"2026-07-09T19:36:37.564Z"},"url":"https://mcp.waymark.network/r/16df0abf-75f5-4bf9-97c5-324ded178f28"}