{"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-appointment","slug":"/api-reference/appointments/create-an-appointment","pageMetadata":{"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","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 for a visitor. Appointments have a specific time slot and are assigned to a user.\"\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 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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create an appointment","description":"Creates a scheduled appointment for a visitor. Appointments have a specific time slot and are assigned to a user.","operationId":"create-appointment","parameters":["9f88c35b-1ba5-4c19-8ff3-a9735b854da4"],"requestBody":"059986c5-bcfe-4ba4-937f-ad0ce9d42626","responses":{"201":"d36e45e2-b557-4f14-9b45-49f45719be21","400":"6f620865-c1d2-4012-9aa9-8f736d67fb26","404":"bdee04dc-e8b8-47ff-982d-db5e20b9c136","409":"db53e1aa-5ed5-4354-a39a-19fc7eac035d"},"x-readme":{"code-samples":[{"language":"curl","code":"curl -X POST https://api.qminder.com/v1/appointments \\\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 \"lastName\": \"Doe\",\n \"startTime\": \"2024-12-15T10:00:00Z\",\n \"endTime\": \"2024-12-15T10:30:00Z\",\n \"assigneeId\": 789\n }'"},{"language":"typescript","code":"const response = await fetch('https://api.qminder.com/v1/appointments', {\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 lastName: 'Doe',\n startTime: '2024-12-15T10:00:00Z',\n endTime: '2024-12-15T10:30:00Z',\n assigneeId: 789\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","baseUrlOptions":["https://api.qminder.com"],"title":"Create an appointment","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"9f88c35b-1ba5-4c19-8ff3-a9735b854da4":{"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","assigneeId"],"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>"},"assigneeId":{"type":"integer","description":"ID of the user to assign the appointment to.","isRequired":true,"uniqueKey":"assigneeId","typeLabel":"integer"},"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>"},"description":"UUIDs of selected options for select-type fields.","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","description":"Label text.","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","phoneNumber":"+12125551234","email":"john@example.com","startTime":"2024-12-15T10:00:00Z","endTime":"2024-12-15T10:30:00Z","assigneeId":789},"examples":{"Example":{"title":"Example","value":{"lineId":12345,"firstName":"John","lastName":"Doe","phoneNumber":"+12125551234","email":"john@example.com","startTime":"2024-12-15T10:00:00Z","endTime":"2024-12-15T10:30:00Z","assigneeId":789}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"d36e45e2-b557-4f14-9b45-49f45719be21":{"description":"Appointment created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Internal appointment ticket ID.","uniqueKey":"id","typeLabel":"string"},"publicId":{"type":"string","description":"Public-facing ticket ID.","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"},"6f620865-c1d2-4012-9aa9-8f736d67fb26":{"description":"Validation error - invalid input data","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"bdee04dc-e8b8-47ff-982d-db5e20b9c136":{"description":"Line, user, or input fields not found","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"db53e1aa-5ed5-4354-a39a-19fc7eac035d":{"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 appointment - Qminder API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-14T11:14:45.253Z","originalFileLocation":"api-reference/appointments/create-an-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 for a visitor. Appointments have a specific time slot and are assigned to a user.\">\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 appointment - Qminder API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a scheduled appointment for a visitor. Appointments have a specific time slot and are assigned to a user.\">\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-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+appointment\u0026amp;description=Creates+a+scheduled+appointment+for+a+visitor.+Appointments+have+a+specific+time+slot+and+are+assigned+to+a+user.\u0026amp;theme=75f4309fbcad65ff6ff6d23e\u0026amp;signature=02ef47e8222836a170103ffc73a899d48d0f454eb5cf4aee8e4e11397369f3f0\">\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 appointment - Qminder API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a scheduled appointment for a visitor. Appointments have a specific time slot and are assigned to a user.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://qminder.mintlify.app/_mintlify/api/og/v2?division=Appointments\u0026amp;title=Create+an+appointment\u0026amp;description=Creates+a+scheduled+appointment+for+a+visitor.+Appointments+have+a+specific+time+slot+and+are+assigned+to+a+user.\u0026amp;theme=75f4309fbcad65ff6ff6d23e\u0026amp;signature=02ef47e8222836a170103ffc73a899d48d0f454eb5cf4aee8e4e11397369f3f0\">\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-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-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-appointment#webpage\",\"url\":\"https://developer.qminder.com/api-reference/appointments/create-an-appointment\",\"name\":\"Create an appointment\",\"description\":\"Creates a scheduled appointment for a visitor. Appointments have a specific time slot and are assigned to a user.\",\"dateModified\":\"2026-07-14T11:14:45.253Z\",\"isPartOf\":{\"@id\":\"https://developer.qminder.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.qminder.com/api-reference/appointments/create-an-appointment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.qminder.com/api-reference/appointments/create-an-appointment#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Qminder API\",\"item\":\"https://developer.qminder.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create an appointment\",\"item\":\"https://developer.qminder.com/api-reference/appointments/create-an-appointment\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.qminder.com/api-reference/appointments/create-an-appointment#apireference\",\"headline\":\"Create an appointment\",\"name\":\"Create an appointment\",\"description\":\"Creates a scheduled appointment for a visitor. Appointments have a specific time slot and are assigned to a user.\",\"url\":\"https://developer.qminder.com/api-reference/appointments/create-an-appointment\",\"mainEntityOfPage\":{\"@id\":\"https://developer.qminder.com/api-reference/appointments/create-an-appointment#webpage\"},\"dateModified\":\"2026-07-14T11:14:45.253Z\",\"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","description":"Removes a custom input field value from a ticket. Cannot remove mandatory input fields.","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","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","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"},{"title":"Edit an appointment","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 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"]}