A status code of 200 does not imply sucessful scheduling, but rather that the request was received successfully.
For reliable scheduling completion info, please use the webhook_url field in the request to receive a webhook on completion.
Note: Currently the API only supports Calendly event types set to English, German, French, Spanish and Portuguese. Please reach out, if you’d like us to support more languages. We can add more languages if there is a demand.
Watch the video below to learn how to use this endpoint step by step.
URL of the scheduling page. E.g. 'https://calendly.com/johndoe/30min'. It has to match this exact format. Please don't include any query parameters, trailing slashes or a timestamp in the slug.
ISO timestamp of the start time. E.g. '2021-01-01T09:15:00Z' OR '2021-01-01T10:15:00+01:00'. DO NOT include millie seconds. NOT: '2021-01-01T10:15:00.000Z'
All fields that should be completed on the scheduling form. This includes not only custom questions but also the default fields required by Calendly (e.g., email address).
Include all fields that are displayed and required to be filled out, as well as any optional fields you intend to complete. If a field is not included, it will not be filled out, and the scheduling process may fail.
(Optional) Invitee time zone in IANA format (E.g. 'America/New_York'). This field does not affect the start date of the event start_time. It is only displayed in Calendly as the invitees local time zone while scheduling the event. Defaults to UTC.
(Optional) URL to send a webhook to after scheduling has completed. If error is null scheduling was successful. If error is not null scheduling failed. On failure, errorReason names the step that failed (e.g. page_load_failed), see "Completion webhook" on this page for all values.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Setter AI Documentation","colors":{"primary":"#6f2eff","light":"#a47aff","dark":"#6f2eff"},"logo":{"light":"https://mintcdn.com/setterai/AV6yna-vayQT6nGM/logo/light.png?fit=max\u0026auto=format\u0026n=AV6yna-vayQT6nGM\u0026q=85\u0026s=60adacc7ac39caaaaef0e42dfdb9bbe7","dark":"https://mintcdn.com/setterai/AV6yna-vayQT6nGM/logo/dark.png?fit=max\u0026auto=format\u0026n=AV6yna-vayQT6nGM\u0026q=85\u0026s=845617a99f8b76264da72fb1adaaf8e6"},"favicon":"https://mintcdn.com/setterai/AV6yna-vayQT6nGM/favicon.png?fit=max\u0026auto=format\u0026n=AV6yna-vayQT6nGM\u0026q=85\u0026s=ade5932ced75bd1f14dda7d8430e2a18","navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"}]},"integrations":{"plausible":{"domain":"docs.trysetter.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"setterai","hasAudioNarration":false,"actualSubdomain":"setterai","customDomains":["docs.trysetter.com"],"gitSource":{"type":"github","owner":"trysetter","repo":"ai-chatbot-app","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6adb8920e6de455b2093d969","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API Reference","count":8},{"language":"default","tag":"Guides","count":7},{"language":"default","tag":"Campaigns (WhatsApp)","count":3},{"language":"default","tag":"Set up SMS with Twilio","count":3},{"language":"default","tag":"Calendly Scheduling","count":2},{"language":"default","tag":"Campaigns","count":2},{"language":"default","tag":"Getting Started","count":1},{"language":"default","tag":"Meeting Reminders","count":1}]},"assistantConfig":{},"basePath":"","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":"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":"llms-txt-v2","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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"calendly-scheduling/api-reference/create-event/post","slug":"/calendly-scheduling/api-reference/create-event/post","pageMetadata":{"title":"Create Event","openapi":"POST /api/scheduled_events","description":"Schedules a new event","href":"/calendly-scheduling/api-reference/create-event/post"},"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: \"Schedules a new event\"\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={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,OptimizedFrame,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedFrame)_missingMdxReference(`OptimizedFrame`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsxs(_components.p,{children:[`A status code of 200 does not imply sucessful scheduling, but rather that the request was received successfully.\nFor reliable scheduling completion info, please use the `,_jsx(_components.code,{children:`webhook_url`}),` field in the request to receive a webhook on completion.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Note: Currently the API only supports Calendly event types set to English, German, French, Spanish and Portuguese. Please `,_jsx(_components.a,{href:`mailto:[email protected]`,children:`reach out`}),`, if you’d like us to support more languages. We can add more languages if there is a demand.`]})}),`\n`,_jsx(_components.p,{children:`Watch the video below to learn how to use this endpoint step by step.`}),`\n`,_jsx(OptimizedFrame,{width:`560`,height:`315`,src:`https://www.youtube.com/embed/qrmMOd6_6M4?si=BAJMZbrk80c0ND__`,title:`YouTube video player`,frameborder:`0`,allow:`accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture`,allowfullscreen:true}),`\n`,_jsx(Heading,{level:`2`,id:`completion-webhook`,children:`Completion webhook`}),`\n`,_jsxs(_components.p,{children:[`If you pass a `,_jsx(_components.code,{children:`webhook_url`}),`, we send a `,_jsx(_components.code,{children:`POST`}),` request to it once scheduling has finished. Check `,_jsx(_components.code,{children:`error`}),` to see whether the event was scheduled:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`error`}),` is `,_jsx(_components.code,{children:`null`}),`: the event was scheduled.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`error`}),` is not `,_jsx(_components.code,{children:`null`}),`: scheduling failed. The value is `,_jsx(_components.code,{children:`time_not_available`}),` if the slot was no longer free, otherwise `,_jsx(_components.code,{children:`scheduling_failed`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`On failure, `,_jsx(_components.code,{children:`errorReason`}),` tells you which step failed, so you can decide whether to retry:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`errorReason`})}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`page_load_failed`})}),_jsx(_components.td,{children:`The Calendly page did not load. Usually temporary, safe to retry.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`form_failed`})}),_jsx(_components.td,{children:`The booking form did not appear or could not be filled in.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`submission_failed`})}),_jsx(_components.td,{children:`The form could not be submitted.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`confirmation_timeout`})}),_jsx(_components.td,{children:`The form was submitted, but Calendly did not confirm the booking in time. Check Calendly before retrying, the event may have been created.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`time_not_available`})}),_jsx(_components.td,{children:`Calendly reported the time slot as no longer available. Pick another time.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unknown`})}),_jsx(_components.td,{children:`Any other failure.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`errorReason`}),` is `,_jsx(_components.code,{children:`null`}),` when scheduling succeeded. More values may be added over time, so treat unrecognised values like `,_jsx(_components.code,{children:`unknown`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:`Example failure payload`,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"calendly_scheduling_completion\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"scheduling_failed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"errorReason\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"page_load_failed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"schedulingUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://calendly.com/acme/intro/2026-10-26T13:00:00Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timeZone\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Europe/Berlin\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"webhookUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/webhook\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"formData\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [{ `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"string\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"[email protected]\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"metadata\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"requestId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"abc\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})}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":"Create Event","openapi":"POST /api/scheduled_events","description":"Schedules a new event","href":"/calendly-scheduling/api-reference/create-event/post"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Completion webhook","slug":"completion-webhook","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Schedules a new event","requestBody":"997fad16-2001-4e18-9886-9e832662a423","responses":{"200":"76246427-91cc-45fd-a878-a6b83fda6458","400":"716854a8-4d5b-43b5-8ece-f48309deaa3a"},"method":"post","type":"path","servers":["f9f16b91-8a1a-4c44-8991-1c08ac6d5f35"],"security":["8ea6c177-4d91-4e83-9a39-2c93ed2b08d3"],"path":"/api/scheduled_events","baseUrlOptions":["https://calendlyscheduling.dev"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"description":"Event details","content":{"application/json":{"schema":{"type":"object","required":["scheduling_url","start_time","fields"],"properties":{"scheduling_url":{"description":"URL of the scheduling page. E.g. 'https://calendly.com/johndoe/30min'. It has to match this exact format. Please don't include any query parameters, trailing slashes or a timestamp in the slug.","type":"string","isRequired":true,"uniqueKey":"scheduling_url","typeLabel":"string"},"start_time":{"description":"ISO timestamp of the start time. E.g. '2021-01-01T09:15:00Z' OR '2021-01-01T10:15:00+01:00'. DO NOT include millie seconds. NOT: '2021-01-01T10:15:00.000Z'","type":"string","isRequired":true,"uniqueKey":"start_time","typeLabel":"string"},"fields":{"description":"All fields that should be completed on the scheduling form. This includes not only custom questions but also the default fields required by Calendly (e.g., email address).\n\nInclude all fields that are displayed and required to be filled out, as well as any optional fields you intend to complete. If a field is not included, it will not be filled out, and the scheduling process may fail.","type":"array","items":{"type":"object","required":["name","type","value"],"properties":{"name":{"description":"Name of the field (exactly as displayed on the form). E.g. 'Name', 'First Name', 'Email', ... . NOT 'name' or 'email'.","type":"string","isRequired":true,"uniqueKey":"fields.items.[INDEX].name","typeLabel":"string"},"type":{"description":"Type of the field (according to Calendly API reference: https://developer.calendly.com/api-docs/f3185c91567db-event-type > custom_questions > type)","type":"string","enum":["string","text","phone_number","single_select","multi_select"],"isRequired":true,"uniqueKey":"fields.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"value":{"description":"Value of the field. E.g. 'John Doe', '[email protected]', '+1 234 567 890', ...","type":"string","isRequired":true,"uniqueKey":"fields.items.[INDEX].value","typeLabel":"string"}},"uniqueKey":"fields.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"fields","typeLabel":"object[]"},"invitee_timezone":{"description":"(Optional) Invitee time zone in IANA format (E.g. 'America/New_York'). This field does not affect the start date of the event `start_time`. It is only displayed in Calendly as the invitees local time zone while scheduling the event. Defaults to `UTC`.","type":"string","uniqueKey":"invitee_timezone","typeLabel":"string"},"webhook_url":{"description":"(Optional) URL to send a webhook to after scheduling has completed. If `error` is `null` scheduling was successful. If `error` is not `null` scheduling failed. On failure, `errorReason` names the step that failed (e.g. `page_load_failed`), see \"Completion webhook\" on this page for all values.","type":"string","uniqueKey":"webhook_url","typeLabel":"string"},"metadata":{"description":"(Optional) Metadata to be sent to the webhook. This can be used to identify the scheduling request in the webhook. Unstructured data is allowed.","type":"object","uniqueKey":"metadata","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"scheduling_url":"\u003cstring>","start_time":"\u003cstring>","fields":[{"name":"\u003cstring>","value":"\u003cstring>"}],"invitee_timezone":"\u003cstring>","webhook_url":"\u003cstring>","metadata":{}}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"76246427-91cc-45fd-a878-a6b83fda6458":{"description":"Scheduling response","content":{"application/json":{"schema":{"required":["message"],"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"716854a8-4d5b-43b5-8ece-f48309deaa3a":{"description":"unexpected error","content":{"application/json":{"schema":{"required":["error","message"],"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"8ea6c177-4d91-4e83-9a39-2c93ed2b08d3":{"bearerAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication. Please purchase a subscription to get your API key.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"f9f16b91-8a1a-4c44-8991-1c08ac6d5f35":{"url":"https://calendlyscheduling.dev"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication. Please purchase a subscription to get your API key.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"X-API-Key","type":"string","description":"API key for authentication. Please purchase a subscription to get your API key.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"bearerAuth","name":"X-API-Key"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"setterai","siteName":"Setter AI Documentation","title":"Create Event - Setter AI Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T16:20:13.897Z","originalFileLocation":"calendly-scheduling/api-reference/create-event/post.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=\"Schedules a new event\">\u003cmeta data-mint-head name=\"application-name\" content=\"Setter AI Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/setterai/0sFTN1yBzEXgSiM4/_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/setterai/0sFTN1yBzEXgSiM4/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/setterai/0sFTN1yBzEXgSiM4/_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/setterai/0sFTN1yBzEXgSiM4/_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/setterai/0sFTN1yBzEXgSiM4/_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/setterai/0sFTN1yBzEXgSiM4/_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/setterai/0sFTN1yBzEXgSiM4/_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/setterai/0sFTN1yBzEXgSiM4/_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/setterai/0sFTN1yBzEXgSiM4/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Event - Setter AI Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Schedules a new event\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Setter AI Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.trysetter.com/calendly-scheduling/api-reference/create-event/post\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://setterai.mintlify.site/_mintlify/api/og/v2?division=Calendly+Scheduling\u0026amp;title=Create+Event\u0026amp;description=Schedules+a+new+event\u0026amp;theme=4c15eb72fe2291ade3053db9\u0026amp;signature=28853e2f40343da48b2f428fec4f11b92509155d228f0fe24aa7aef5c05fc17f\">\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 Event - Setter AI Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Schedules a new event\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://setterai.mintlify.site/_mintlify/api/og/v2?division=Calendly+Scheduling\u0026amp;title=Create+Event\u0026amp;description=Schedules+a+new+event\u0026amp;theme=4c15eb72fe2291ade3053db9\u0026amp;signature=28853e2f40343da48b2f428fec4f11b92509155d228f0fe24aa7aef5c05fc17f\">\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/setterai/0sFTN1yBzEXgSiM4/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Setter AI Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6f2eff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.trysetter.com/calendly-scheduling/api-reference/create-event/post\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/calendly-scheduling/api-reference/create-event/post.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.trysetter.com/#organization\",\"name\":\"Setter AI Documentation\",\"url\":\"https://docs.trysetter.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/setterai/AV6yna-vayQT6nGM/logo/light.png?fit=max\u0026auto=format\u0026n=AV6yna-vayQT6nGM\u0026q=85\u0026s=60adacc7ac39caaaaef0e42dfdb9bbe7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.trysetter.com#website\",\"name\":\"Setter AI Documentation\",\"url\":\"https://docs.trysetter.com\",\"publisher\":{\"@id\":\"https://docs.trysetter.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.trysetter.com/calendly-scheduling/api-reference/create-event/post#webpage\",\"url\":\"https://docs.trysetter.com/calendly-scheduling/api-reference/create-event/post\",\"name\":\"Create Event\",\"description\":\"Schedules a new event\",\"dateModified\":\"2026-10-23T16:20:13.897Z\",\"isPartOf\":{\"@id\":\"https://docs.trysetter.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.trysetter.com/calendly-scheduling/api-reference/create-event/post#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.trysetter.com/calendly-scheduling/api-reference/create-event/post#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Calendly Scheduling\",\"item\":\"https://docs.trysetter.com/calendly-scheduling/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Event\",\"item\":\"https://docs.trysetter.com/calendly-scheduling/api-reference/create-event/post\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.trysetter.com/calendly-scheduling/api-reference/create-event/post#apireference\",\"headline\":\"Create Event\",\"name\":\"Create Event\",\"description\":\"Schedules a new event\",\"url\":\"https://docs.trysetter.com/calendly-scheduling/api-reference/create-event/post\",\"mainEntityOfPage\":{\"@id\":\"https://docs.trysetter.com/calendly-scheduling/api-reference/create-event/post#webpage\"},\"dateModified\":\"2026-10-23T16:20:13.897Z\",\"publisher\":{\"@id\":\"https://docs.trysetter.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.trysetter.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Setter AI Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Setter AI Documentation","nav":{"global":null,"groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/index"}]},{"group":"Guides","icon":"book-open","pages":[{"group":"Set up SMS with Twilio","pages":[{"title":"SMS Integration Overview","href":"/sms-integration/introduction"},{"title":"Twilio SMS Setup","href":"/sms-integration/twilio-setup"},{"title":"A2P 10DLC Registration Guide","href":"/sms-integration/a2p-registration"}]},{"group":"Meeting Reminders","pages":[{"title":"WhatsApp Meeting Reminders Setup","href":"/whatsapp-reminders/setup"}]},{"group":"Campaigns (WhatsApp)","pages":[{"title":"Campaigns","href":"/campaigns/overview"},{"title":"Audience Filtering","href":"/campaigns/audience-filtering"},{"title":"Lead Events","href":"/campaigns/lead-events"}]}]},{"group":"API Reference","icon":"code","pages":[{"title":"Send Message","openapi":"POST /api/v1/bot-integrations/{botIntegrationId}/messages/send","href":"/setter-ai/api-reference"},{"title":"Get Conversation History","openapi":"GET /api/v1/bot-integrations/{botIntegrationId}/conversations","href":"/setter-ai/conversation-history"},{"title":"Update Contact","openapi":"PUT /api/v1/contacts","href":"/setter-ai/update-contact"},{"title":"Create Booking","openapi":"POST /api/v1/bookings","href":"/setter-ai/bookings"},{"title":"Cancel Booking","openapi":"POST /api/v1/bookings/{id}/cancel","href":"/setter-ai/cancel-booking"},{"title":"Webhooks","href":"/setter-ai/webhooks"},{"group":"Campaigns","pages":[{"title":"Filter Send Audience","openapi":"POST /api/v1/webhooks/campaigns/audience-filter","href":"/campaigns/filter-audience"},{"title":"Send Lead Event","openapi":"POST /api/v1/webhooks/lead-events","href":"/campaigns/send-lead-event"}]}]},{"group":"Calendly Scheduling","icon":"calendar","pages":[{"title":"Introduction","description":"Schedule events directly to Calendly automatically.","href":"/calendly-scheduling/introduction"},{"title":"Create Event","openapi":"POST /api/scheduled_events","href":"/calendly-scheduling/api-reference/create-event/post"}]}]},"basePath":"","title":"Create Event - Setter AI Documentation","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}