{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Qminder API","colors":{"primary":"#9665FF","light":"#9665FF","dark":"#9665FF"},"logo":"https://mintcdn.com/qminder/lRy8vXyzyVrsUc5I/images/qminder-logo.svg?fit=max\u0026auto=format\u0026n=lRy8vXyzyVrsUc5I\u0026q=85\u0026s=9fd4c6551d8d6b40da0cc917661f57c8","favicon":"https://mintcdn.com/qminder/lRy8vXyzyVrsUc5I/images/favicon.svg?fit=max\u0026auto=format\u0026n=lRy8vXyzyVrsUc5I\u0026q=85\u0026s=1665c8e187fd5c7b4606ec1345f0475d","api":{},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"qminder","hasAudioNarration":false,"actualSubdomain":"qminder","customDomains":["developer.qminder.com"],"gitSource":{"type":"github","owner":"qminder","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a61d8300ffb0945720bd538","collectionId":"03ece4e8-caa9-4a3b-80a7-0a279cfc7ed7","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a61d8300ffb0945720bd538"},"entitlements":{},"buildId":"6a61d8300ffb0945720bd538:success","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"API Reference","count":97},{"language":"default","tag":"GraphQL API","count":76},{"language":"default","tag":"API Endpoints","count":53},{"language":"default","tag":"Tickets","count":25},{"language":"default","tag":"Subscriptions","count":24},{"language":"default","tag":"Queries","count":17},{"language":"default","tag":"RESTful API","count":14},{"language":"default","tag":"Types","count":12},{"language":"default","tag":"Lines","count":11},{"language":"default","tag":"Enums","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/appointments/create-an-auto-assigning-appointment","slug":"/api-reference/appointments/create-an-auto-assigning-appointment","pageMetadata":{"title":"Create an auto-assigning appointment","description":"Creates a scheduled appointment that will be automatically assigned to an available user based on their availability.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/appointments/auto-assign","href":"/api-reference/appointments/create-an-auto-assigning-appointment","autogeneratedByOpenApi":true},"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: \"Creates a scheduled appointment that will be automatically assigned to an available user based on their availability.\"\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":"Create an auto-assigning appointment","description":"Creates a scheduled appointment that will be automatically assigned to an available user based on their availability.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/appointments/auto-assign","href":"/api-reference/appointments/create-an-auto-assigning-appointment","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create an auto-assigning appointment","description":"Creates a scheduled appointment that will be automatically assigned to an available user based on their availability.","operationId":"create-auto-assign-appointment","parameters":["c29afa31-403a-4c30-9798-51aa6440d208"],"requestBody":"cb06d257-574a-43c3-8509-115bc11bff47","responses":{"201":"b143de5f-6de9-431f-a3dd-1111b484b71b","400":"54feeb02-2835-4f1b-b890-1e21847d31ca","404":"ad12312f-922a-4d66-8c1b-d7ea502fc8b3","409":"a0212448-9d89-4a96-9e2a-d2f67555714d"},"x-readme":{"code-samples":[{"language":"curl","code":"curl -X POST https://api.qminder.com/v1/appointments/auto-assign \\\n -H \"X-Qminder-REST-API-Key: YOUR_API_KEY\" \\\n -H \"X-Qminder-API-Version: 2020-09-01\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"lineId\": 12345,\n \"firstName\": \"John\",\n \"startTime\": \"2024-12-15T10:00:00Z\",\n \"endTime\": \"2024-12-15T10:30:00Z\"\n }'"},{"language":"typescript","code":"const response = await fetch('https://api.qminder.com/v1/appointments/auto-assign', {\n method: 'POST',\n headers: {\n 'X-Qminder-REST-API-Key': 'YOUR_API_KEY',\n 'X-Qminder-API-Version': '2020-09-01',\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify({\n lineId: 12345,\n firstName: 'John',\n startTime: '2024-12-15T10:00:00Z',\n endTime: '2024-12-15T10:30:00Z'\n })\n});\n\nconst { id, publicId } = await response.json();"}],"samples-languages":["curl","typescript"]},"tags":["Appointments"],"method":"post","type":"path","servers":["371ac1db-d16a-4c49-8113-72c65802c755"],"security":["77167569-f9ef-4c98-bb35-dc91ec78d5b7"],"path":"/v1/appointments/auto-assign","baseUrlOptions":["https://api.qminder.com"],"title":"Create an auto-assigning appointment","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c29afa31-403a-4c30-9798-51aa6440d208":{"name":"X-Qminder-API-Version","in":"header","description":"API version. Must be set to `2020-09-01`.","required":true,"schema":{"type":"string","enum":["2020-09-01"],"default":"2020-09-01","isRequired":true,"description":"API version. Must be set to `2020-09-01`.","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["lineId","firstName","startTime","endTime"],"properties":{"lineId":{"type":"integer","description":"ID of the line to create the appointment in.","isRequired":true,"uniqueKey":"lineId","typeLabel":"integer"},"firstName":{"type":"string","minLength":2,"maxLength":50,"description":"Visitor's first name (2-50 characters).","isRequired":true,"uniqueKey":"firstName","typeLabel":"string"},"startTime":{"type":"string","format":"date-time","description":"Appointment start time in ISO 8601 format.","isRequired":true,"uniqueKey":"startTime","typeLabel":"string\u003cdate-time>"},"endTime":{"type":"string","format":"date-time","description":"Appointment end time in ISO 8601 format.","isRequired":true,"uniqueKey":"endTime","typeLabel":"string\u003cdate-time>"},"lastName":{"type":"string","maxLength":50,"description":"Visitor's last name (max 50 characters).","uniqueKey":"lastName","typeLabel":"string"},"phoneNumber":{"type":"string","pattern":"^(\\+)?([0-9]){5,20}$","description":"Phone number with optional + prefix (5-20 digits).","uniqueKey":"phoneNumber","typeLabel":"string"},"email":{"type":"string","format":"email","maxLength":100,"description":"Visitor's email address.","uniqueKey":"email","typeLabel":"string\u003cemail>"},"languageCode":{"type":"string","minLength":2,"maxLength":5,"default":"en","description":"Language code for the visitor (default: en).","uniqueKey":"languageCode","typeLabel":"string"},"fields":{"type":"array","description":"Custom input fields for the appointment. See [Input Fields query](/reference/queries/input-fields) to discover available IDs.","items":{"type":"object","required":["inputFieldId"],"properties":{"inputFieldId":{"type":"string","format":"uuid","description":"UUID of the input field.","isRequired":true,"uniqueKey":"fields.items.[INDEX].inputFieldId","typeLabel":"string\u003cuuid>"},"value":{"type":"string","maxLength":500,"description":"Value for text input fields.","uniqueKey":"fields.items.[INDEX].value","typeLabel":"string"},"optionIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"fields.items.[INDEX].optionIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"fields.items.[INDEX].optionIds","typeLabel":"string\u003cuuid>[]"}},"uniqueKey":"fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"fields","typeLabel":"object[]"},"labels":{"type":"array","description":"Labels to attach to the appointment.","items":{"type":"object","required":["value"],"properties":{"value":{"type":"string","isRequired":true,"uniqueKey":"labels.items.[INDEX].value","typeLabel":"string"}},"uniqueKey":"labels.items.[INDEX]","typeLabel":"object"},"uniqueKey":"labels","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"lineId":12345,"firstName":"John","lastName":"Doe","startTime":"2024-12-15T10:00:00Z","endTime":"2024-12-15T10:30:00Z"},"examples":{"Example":{"title":"Example","value":{"lineId":12345,"firstName":"John","lastName":"Doe","startTime":"2024-12-15T10:00:00Z","endTime":"2024-12-15T10:30:00Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"b143de5f-6de9-431f-a3dd-1111b484b71b":{"description":"Appointment created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"id","typeLabel":"string"},"publicId":{"type":"string","uniqueKey":"publicId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"id":"226859","publicId":"A-42"},"examples":{"Example":{"title":"Example","value":{"id":"226859","publicId":"A-42"}}},"exampleType":"examples"}},"exampleType":"examples"},"54feeb02-2835-4f1b-b890-1e21847d31ca":{"description":"Validation error - invalid input data","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"ad12312f-922a-4d66-8c1b-d7ea502fc8b3":{"description":"Line or input fields not found","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"a0212448-9d89-4a96-9e2a-d2f67555714d":{"description":"Line is disabled or archived","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"77167569-f9ef-4c98-bb35-dc91ec78d5b7":{"sec0":{"type":"apiKey","in":"header","name":"X-Qminder-REST-API-Key","x-default":"yourbusinessapikey","scopes":[]}}},"servers":{"371ac1db-d16a-4c49-8113-72c65802c755":{"url":"https://api.qminder.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Qminder-REST-API-Key","x-default":"yourbusinessapikey","scopes":[]},"schema":{"title":"X-Qminder-REST-API-Key","type":"string","isRequired":true,"default":"yourbusinessapikey","typeLabel":"string","deprecated":false},"schemeName":"sec0","name":"X-Qminder-REST-API-Key"}],"title":"sec0"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"qminder","siteName":"Qminder API","title":"Create an auto-assigning appointment - Qminder API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-14T11:14:45.264Z","originalFileLocation":"api-reference/appointments/create-an-auto-assigning-appointment.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=\"Creates a scheduled appointment that will be automatically assigned to an available user based on their availability.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Qminder API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/qminder/HYl8SNxSvfnBXOXP/_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/qminder/HYl8SNxSvfnBXOXP/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/qminder/HYl8SNxSvfnBXOXP/_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/qminder/HYl8SNxSvfnBXOXP/_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/qminder/HYl8SNxSvfnBXOXP/_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/qminder/HYl8SNxSvfnBXOXP/_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/qminder/HYl8SNxSvfnBXOXP/_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/qminder/HYl8SNxSvfnBXOXP/_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/qminder/HYl8SNxSvfnBXOXP/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create an auto-assigning appointment - Qminder API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a scheduled appointment that will be automatically assigned to an available user based on their availability.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Qminder API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.qminder.com/api-reference/appointments/create-an-auto-assigning-appointment\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://qminder.mintlify.app/_mintlify/api/og/v2?division=Appointments\u0026amp;title=Create+an+auto-assigning+appointment\u0026amp;description=Creates+a+scheduled+appointment+that+will+be+automatically+assigned+to+an+available+user+based+on+their+availability.\u0026amp;theme=75f4309fbcad65ff6ff6d23e\u0026amp;signature=d440871e205194a29ca0216f27760bc30f416d14b1f86e03a7d43bcb3eb0fb67\">\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 an auto-assigning appointment - Qminder API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a scheduled appointment that will be automatically assigned to an available user based on their availability.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://qminder.mintlify.app/_mintlify/api/og/v2?division=Appointments\u0026amp;title=Create+an+auto-assigning+appointment\u0026amp;description=Creates+a+scheduled+appointment+that+will+be+automatically+assigned+to+an+available+user+based+on+their+availability.\u0026amp;theme=75f4309fbcad65ff6ff6d23e\u0026amp;signature=d440871e205194a29ca0216f27760bc30f416d14b1f86e03a7d43bcb3eb0fb67\">\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/qminder/HYl8SNxSvfnBXOXP/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Qminder API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#9665FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.qminder.com/api-reference/appointments/create-an-auto-assigning-appointment\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/appointments/create-an-auto-assigning-appointment.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.qminder.com/#organization\",\"name\":\"Qminder API\",\"url\":\"https://developer.qminder.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/qminder/lRy8vXyzyVrsUc5I/images/qminder-logo.svg?fit=max\u0026auto=format\u0026n=lRy8vXyzyVrsUc5I\u0026q=85\u0026s=9fd4c6551d8d6b40da0cc917661f57c8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.qminder.com#website\",\"name\":\"Qminder API\",\"url\":\"https://developer.qminder.com\",\"publisher\":{\"@id\":\"https://developer.qminder.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.qminder.com/api-reference/appointments/create-an-auto-assigning-appointment#webpage\",\"url\":\"https://developer.qminder.com/api-reference/appointments/create-an-auto-assigning-appointment\",\"name\":\"Create an auto-assigning appointment\",\"description\":\"Creates a scheduled appointment that will be automatically assigned to an available user based on their availability.\",\"dateModified\":\"2026-07-14T11:14:45.264Z\",\"isPartOf\":{\"@id\":\"https://developer.qminder.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.qminder.com/api-reference/appointments/create-an-auto-assigning-appointment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.qminder.com/api-reference/appointments/create-an-auto-assigning-appointment#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Appointments\",\"item\":\"https://developer.qminder.com/api-reference/appointments/create-an-appointment\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create an auto-assigning appointment\",\"item\":\"https://developer.qminder.com/api-reference/appointments/create-an-auto-assigning-appointment\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.qminder.com/api-reference/appointments/create-an-auto-assigning-appointment#apireference\",\"headline\":\"Create an auto-assigning appointment\",\"name\":\"Create an auto-assigning appointment\",\"description\":\"Creates a scheduled appointment that will be automatically assigned to an available user based on their availability.\",\"url\":\"https://developer.qminder.com/api-reference/appointments/create-an-auto-assigning-appointment\",\"mainEntityOfPage\":{\"@id\":\"https://developer.qminder.com/api-reference/appointments/create-an-auto-assigning-appointment#webpage\"},\"dateModified\":\"2026-07-14T11:14:45.264Z\",\"publisher\":{\"@id\":\"https://developer.qminder.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.qminder.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Qminder API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Qminder API","nav":{"global":null,"tabs":[{"tab":"API Reference","pages":[{"title":"API Reference","href":"/reference/overview"}]},{"tab":"API Endpoints","pages":[{"group":"Locations","pages":[{"title":"Get the list of locations","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json get /v1/locations","href":"/api-reference/locations/get-the-list-of-locations"},{"title":"Create a location","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /locations","href":"/api-reference/locations/create-a-location"},{"title":"Edit a location","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /locations/{locationId}","href":"/api-reference/locations/edit-a-location"},{"title":"Get details of a location","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json get /v1/locations/{id}","href":"/api-reference/locations/get-details-of-a-location"},{"title":"Get desks of a Location","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json get /v1/locations/{id}/desks","href":"/api-reference/locations/get-desks-of-a-location"}]},{"group":"Lines","pages":[{"title":"Get list of lines","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json get /v1/locations/{id}/lines","href":"/api-reference/lines/get-list-of-lines"},{"title":"Create a line","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/locations/{id}/lines","href":"/api-reference/lines/create-a-line"},{"title":"Get details of a line","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json get /v1/lines/{id}","href":"/api-reference/lines/get-details-of-a-line"},{"title":"Editing a line","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/lines/{id}","href":"/api-reference/lines/editing-a-line"},{"title":"Enabling a line","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/lines/{id}/enable","href":"/api-reference/lines/enabling-a-line"},{"title":"Disabling a line","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/lines/{id}/disable","href":"/api-reference/lines/disabling-a-line"},{"title":"Archiving a line","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/lines/{id}/archive","href":"/api-reference/lines/archiving-a-line"},{"title":"Unarchiving a line","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/lines/{id}/unarchive","href":"/api-reference/lines/unarchiving-a-line"},{"title":"Deletion of a line","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json delete /v1/lines/{id}","href":"/api-reference/lines/deletion-of-a-line"}]},{"group":"Input Fields","pages":[{"title":"Create an input field","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /input-fields","href":"/api-reference/input-fields/create-an-input-field"},{"title":"Edit an input field","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /input-fields/{inputFieldId}","href":"/api-reference/input-fields/edit-an-input-field"}]},{"group":"Tickets","pages":[{"title":"Create a ticket","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /tickets","href":"/api-reference/tickets/create-a-ticket"},{"title":"Searching tickets","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json get /v1/tickets/search","href":"/api-reference/tickets/searching-tickets"},{"title":"Counting tickets","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/tickets/count","href":"/api-reference/tickets/counting-tickets"},{"title":"Get details of a ticket","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json get /v1/tickets/{id}","href":"/api-reference/tickets/get-details-of-a-ticket"},{"title":"Editing a ticket","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json patch /tickets/{ticketId}","href":"/api-reference/tickets/editing-a-ticket"},{"title":"Calling a ticket","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/tickets/{id}/call","href":"/api-reference/tickets/calling-a-ticket"},{"title":"Re-calling a ticket","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/tickets/{id}/recall","href":"/api-reference/tickets/re-calling-a-ticket"},{"title":"Marking a ticket as served","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/tickets/{id}/markserved","href":"/api-reference/tickets/marking-a-ticket-as-served"},{"title":"Marking a ticket as no-show","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/tickets/{id}/marknoshow","href":"/api-reference/tickets/marking-a-ticket-as-no-show"},{"title":"Removing a ticket from the queue","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/tickets/{id}/cancel","href":"/api-reference/tickets/removing-a-ticket-from-the-queue"},{"title":"Returning a ticket to the queue","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/tickets/{id}/returntoqueue","href":"/api-reference/tickets/returning-a-ticket-to-the-queue"},{"title":"Forwarding a ticket","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/tickets/{id}/forward","href":"/api-reference/tickets/forwarding-a-ticket"},{"title":"Adding a label","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/tickets/{id}/labels/add","href":"/api-reference/tickets/adding-a-label"},{"title":"Removing a label","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/tickets/{id}/labels/remove","href":"/api-reference/tickets/removing-a-label"},{"title":"Assigning a ticket to a user","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/tickets/{id}/assign","href":"/api-reference/tickets/assigning-a-ticket-to-a-user"},{"title":"Un-assigning a ticket","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/tickets/{id}/unassign","href":"/api-reference/tickets/un-assigning-a-ticket"},{"title":"Reordering a ticket","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/tickets/{id}/reorder","href":"/api-reference/tickets/reordering-a-ticket"},{"title":"Get messages of a ticket","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json get /v1/tickets/{id}/messages","href":"/api-reference/tickets/get-messages-of-a-ticket"},{"title":"Sending an SMS message","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/tickets/{id}/messages","href":"/api-reference/tickets/sending-an-sms-message"},{"title":"Save ticket input field value","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/tickets/{ticketId}/fields/{inputFieldId}","href":"/api-reference/tickets/save-ticket-input-field-value"},{"title":"Remove ticket input field value","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/tickets/{ticketId}/fields/{inputFieldId}","href":"/api-reference/tickets/remove-ticket-input-field-value"}]},{"group":"Appointments","pages":[{"title":"Create an appointment","description":"Creates a scheduled appointment for a visitor. Appointments have a specific time slot and are assigned to a user.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/appointments","href":"/api-reference/appointments/create-an-appointment"},{"title":"Create an auto-assigning appointment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/appointments/auto-assign","href":"/api-reference/appointments/create-an-auto-assigning-appointment"},{"title":"Edit an appointment","description":"Updates an appointment's time slot or assignee. Only include fields you want to change.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/appointments/{ticketId}","href":"/api-reference/appointments/edit-an-appointment"},{"title":"Cancel an appointment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/appointments/{ticketId}/cancel","href":"/api-reference/appointments/cancel-an-appointment"},{"title":"Check in an appointment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/appointments/{ticketId}/checkin","href":"/api-reference/appointments/check-in-an-appointment"},{"title":"Mark appointment as no-show","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/appointments/{ticketId}/marknoshow","href":"/api-reference/appointments/mark-appointment-as-no-show"}]},{"group":"Users","pages":[{"title":"Getting a list of users","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json get /v1/locations/{id}/users","href":"/api-reference/users/getting-a-list-of-users"},{"title":"Creating a user","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/users","href":"/api-reference/users/creating-a-user"},{"title":"Getting details of a User","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json get /v1/users/{id}","href":"/api-reference/users/getting-details-of-a-user"},{"title":"Getting user's selected desk id","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json get /v1/users/{id}/desk","href":"/api-reference/users/getting-users-selected-desk-id"},{"title":"Changing the user's selected desk","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/users/{id}/desk","href":"/api-reference/users/changing-the-users-selected-desk"},{"title":"Clearing the user's selected desk","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json delete /v1/users/{id}/desk","href":"/api-reference/users/clearing-the-users-selected-desk"},{"title":"Getting the user's selected lines","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json get /v1/users/{id}/lines","href":"/api-reference/users/getting-the-users-selected-lines"},{"title":"Selecting lines","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/users/{id}/lines","href":"/api-reference/users/selecting-lines"}]},{"group":"Webhooks","pages":[{"title":"Adding a webhook","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json post /v1/webhooks","href":"/api-reference/webhooks/adding-a-webhook"},{"title":"Removing a webhook","deprecated":false,"version":null,"openapi":"/api-reference/openapi.json delete /v1/webhooks/{id}","href":"/api-reference/webhooks/removing-a-webhook"}]}]}]},"title":"Create an auto-assigning appointment - Qminder API","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}