The wire contract for a list, AT THE LATEST VERSION.
This is the single source of truth: toListResponse is annotated to
return it (so the code cannot drift from it without a compile error), and the
OpenAPI spec + docs + breaking-change gate are all generated from it.
Dates are ISO-8601 strings — the real wire form res.json produces from the
underlying Moment values.
Remaining nested relations are unknown for now; in the full rollout each
gets its own versioned response contract (recursively), at which point they
become typed $refs here.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Fourvenues API","colors":{"primary":"#3b82f6","light":"#bfdbfe","dark":"#1e3a8a"},"logo":{"light":"https://mintcdn.com/fourvenues/Ac72CI1QKm9VekjS/logo/light.svg?fit=max\u0026auto=format\u0026n=Ac72CI1QKm9VekjS\u0026q=85\u0026s=34ea2eeb6703cf90846a1e2b12c609f4","dark":"https://mintcdn.com/fourvenues/9J2VM2OC0BjwtJkX/logo/dark.svg?fit=max\u0026auto=format\u0026n=9J2VM2OC0BjwtJkX\u0026q=85\u0026s=74f3030430b847511eda6a8a53b2b2a9"},"favicon":"https://mintcdn.com/fourvenues/Ac72CI1QKm9VekjS/favicon.png?fit=max\u0026auto=format\u0026n=Ac72CI1QKm9VekjS\u0026q=85\u0026s=d15a8ade3ca7d1be1b67cf5eef18e987","api":{"mdx":{"auth":{"method":"key"},"server":"https://channels-service.fourvenues.com"}},"navbar":{"links":[{"href":"https://www.fourvenues.com/","label":"Contact Us"}]},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/fourvenues","github":"https://github.com/fourvenuestech"}},"integrations":{"plausible":{"domain":"docs.fourvenues.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fourvenues","hasAudioNarration":false,"actualSubdomain":"fourvenues","customDomains":["docs.fourvenues.com"],"gitSource":{"type":"github","owner":"fourvenuestech","repo":"docs.fourvenues.com","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ac3bd69efb6989e0145c9a0","clientVersion":"0.0.4124","searchFilterCounts":[{"language":"default","tag":"API Reference","count":131},{"language":"default","tag":"Integrations API","count":85},{"language":"default","tag":"Channel Manager API","count":62},{"language":"default","tag":"Bookings","count":21},{"language":"default","tag":"Tickets","count":20},{"language":"default","tag":"Introduction","count":19},{"language":"default","tag":"Discount Codes","count":12},{"language":"default","tag":"Lists","count":10},{"language":"default","tag":"Webhook Endpoints","count":10},{"language":"default","tag":"Events","count":8}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"channel-manager/api-reference/lists/create-list","slug":"/channel-manager/api-reference/lists/create-list","pageMetadata":{"openapi":"post /lists","title":"Create a new list","description":"Create a new list","href":"/channel-manager/api-reference/lists/create-list"},"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: \"Create a new list\"\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":{"openapi":"post /lists","title":"Create a new list","description":"Create a new list","href":"/channel-manager/api-reference/lists/create-list"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"security":["4ee2d67a-8a3f-425a-9d55-e3b50faad49b"],"tags":["Lists"],"summary":"Create a new list","operationId":"createLists","responses":{"200":"3d6fefaa-f754-4949-9669-fd2264356de6","401":"70038b4b-bf9b-42cb-ad4a-8e3ea81fe8e1"},"description":"Create a new list","requestBody":"92dffc03-9f36-46d6-8f97-fabb7b5a0605","method":"post","type":"path","servers":["be2133d7-3380-4216-839b-05355115ce51","37e90a5b-98b6-43ac-868b-75f6e716b5c7"],"path":"/lists","baseUrlOptions":["https://channels-service-alpha.fourvenues.com","https://channels-service.fourvenues.com"],"title":"Create a new list","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"list_rate_id":{"type":"string","description":"List rate id of a list.","example":"5f8d0f8b9d2b3b0017b6d8a0","isRequired":true,"uniqueKey":"list_rate_id","typeLabel":"string"},"send_notification":{"type":"boolean","description":"Notify the QR for list","example":false,"default":false,"uniqueKey":"send_notification","typeLabel":"boolean"},"list":{"type":"object","properties":{"qr_code":{"type":"string","description":"QRCode. Optional. If not provided, it will be generated automatically.","example":"ABCDE12345","uniqueKey":"list.qr_code","typeLabel":"string"},"observations_referral":{"type":"string","description":"Observations referral","example":"Observations...","uniqueKey":"list.observations_referral","typeLabel":"string"},"for":{"type":"number","description":"Number of appointed people in list","example":5,"uniqueKey":"list.for","typeLabel":"number"},"full_name":{"type":"string","description":"Full name of a list. May be required depending on the settings of the list rate.","example":"John Doe","uniqueKey":"list.full_name","typeLabel":"string"},"email":{"type":"string","description":"Email of a list. May be required depending on the settings of the list rate.","example":"john@fourvenues.com","uniqueKey":"list.email","typeLabel":"string"},"language":{"type":"string","description":"Language of the appointed people. Available languages en, ca, fr, es, nl and it","example":"en","default":"es","uniqueKey":"list.language","typeLabel":"string"}},"uniqueKey":"list","typeLabel":"object"}},"required":["list_rate_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"list_rate_id":"5f8d0f8b9d2b3b0017b6d8a0","send_notification":false,"list":{"qr_code":"ABCDE12345","observations_referral":"Observations...","for":5,"full_name":"John Doe","email":"john@fourvenues.com","language":"en"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"3d6fefaa-f754-4949-9669-fd2264356de6":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data._id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data._id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data._id","typeLabel":"string | null"},"event_id":{"type":"string","isRequired":true,"uniqueKey":"data.event_id","typeLabel":"string"},"list_rate_id":{"type":"string","isRequired":true,"uniqueKey":"data.list_rate_id","typeLabel":"string"},"prices":{"type":"array","items":{"type":"object","properties":{"_id":{"type":"string","isRequired":true,"uniqueKey":"data.prices.items.[INDEX]._id","typeLabel":"string"},"men":{"type":"number","isRequired":true,"uniqueKey":"data.prices.items.[INDEX].men","typeLabel":"number"},"women":{"type":"number","isRequired":true,"uniqueKey":"data.prices.items.[INDEX].women","typeLabel":"number"},"no_gender":{"type":"number","isRequired":true,"uniqueKey":"data.prices.items.[INDEX].no_gender","typeLabel":"number"},"price":{"type":"number","isRequired":true,"uniqueKey":"data.prices.items.[INDEX].price","typeLabel":"number"}},"required":["_id","men","women","no_gender","price"],"uniqueKey":"data.prices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.prices","typeLabel":"object[]"},"channel_id":{"type":"string","isRequired":true,"uniqueKey":"data.channel_id","typeLabel":"string"},"qr_code":{"type":"string","isRequired":true,"uniqueKey":"data.qr_code","typeLabel":"string"},"language":{"type":"string","isRequired":true,"uniqueKey":"data.language","typeLabel":"string"},"total_men":{"type":"number","uniqueKey":"data.total_men","typeLabel":"number"},"total_women":{"type":"number","uniqueKey":"data.total_women","typeLabel":"number"},"total_no_gender":{"type":"number","uniqueKey":"data.total_no_gender","typeLabel":"number"},"full_name":{"type":"string","uniqueKey":"data.full_name","typeLabel":"string"},"email":{"type":"string","uniqueKey":"data.email","typeLabel":"string"},"tags":{"type":"array","items":{"type":"string","uniqueKey":"data.tags.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.tags","typeLabel":"string[]"},"for":{"type":"number","uniqueKey":"data.for","typeLabel":"number"},"enter":{"type":"number","uniqueKey":"data.enter","typeLabel":"number"},"observations_referral":{"type":"string","uniqueKey":"data.observations_referral","typeLabel":"string"},"entry_time":{"type":"string","description":"ISO-8601 date-time","uniqueKey":"data.entry_time","typeLabel":"string"},"raised":{"type":"number","uniqueKey":"data.raised","typeLabel":"number"}},"required":["_id","event_id","list_rate_id","prices","channel_id","qr_code","language"],"description":"The wire contract for a list, AT THE LATEST VERSION.\n\nThis is the single source of truth: `toListResponse` is annotated to\nreturn it (so the code cannot drift from it without a compile error), and the\nOpenAPI spec + docs + breaking-change gate are all generated from it.\n\nDates are ISO-8601 strings — the real wire form `res.json` produces from the\nunderlying Moment values.\n\nRemaining nested relations are `unknown` for now; in the full rollout each\ngets its own versioned response contract (recursively), at which point they\nbecome typed `$ref`s here.","uniqueKey":"data","typeLabel":"object"},"success":{"type":"boolean","uniqueKey":"success","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"_id":"\u003cstring>","event_id":"\u003cstring>","list_rate_id":"\u003cstring>","prices":[{"_id":"\u003cstring>","men":123,"women":123,"no_gender":123,"price":123}],"channel_id":"\u003cstring>","qr_code":"\u003cstring>","language":"\u003cstring>","total_men":123,"total_women":123,"total_no_gender":123,"full_name":"\u003cstring>","email":"\u003cstring>","tags":["\u003cstring>"],"for":123,"enter":123,"observations_referral":"\u003cstring>","entry_time":"\u003cstring>","raised":123},"success":true}}},"exampleType":"generated"}},"exampleType":"generated"},"70038b4b-bf9b-42cb-ad4a-8e3ea81fe8e1":{"description":"Unauthorized","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"4ee2d67a-8a3f-425a-9d55-e3b50faad49b":{"ApiKey":{"in":"header","name":"X-Api-Key","type":"apiKey","scopes":[]}}},"servers":{"be2133d7-3380-4216-839b-05355115ce51":{"url":"https://channels-service-alpha.fourvenues.com","description":"Test server"},"37e90a5b-98b6-43ac-868b-75f6e716b5c7":{"url":"https://channels-service.fourvenues.com","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"in":"header","name":"X-Api-Key","type":"apiKey","scopes":[]},"schema":{"title":"X-Api-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKey","name":"X-Api-Key"}],"title":"ApiKey"}]},"originalFileLocation":"openapi/channel_manager_api.json"},"subdomain":"fourvenues","siteName":"Fourvenues API","title":"Create a new list - Fourvenues API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-08T09:29:25.923Z","originalFileLocation":"channel-manager/api-reference/lists/create-list.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=\"Create a new list\">\u003cmeta data-mint-head name=\"application-name\" content=\"Fourvenues 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/fourvenues/Yw_SY54bSs0GSoYA/_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/fourvenues/Yw_SY54bSs0GSoYA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fourvenues/Yw_SY54bSs0GSoYA/_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/fourvenues/Yw_SY54bSs0GSoYA/_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/fourvenues/Yw_SY54bSs0GSoYA/_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/fourvenues/Yw_SY54bSs0GSoYA/_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/fourvenues/Yw_SY54bSs0GSoYA/_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/fourvenues/Yw_SY54bSs0GSoYA/_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/fourvenues/Yw_SY54bSs0GSoYA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a new list - Fourvenues API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new list\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Fourvenues API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fourvenues.com/channel-manager/api-reference/lists/create-list\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fourvenues.mintlify.site/_mintlify/api/og/v2?division=Lists\u0026amp;title=Create+a+new+list\u0026amp;description=Create+a+new+list\u0026amp;theme=495e8dbd34f1f1d44d3c3d73\u0026amp;signature=8e38c7814b1a520fecfcf72f8f0ced241c392539f0f2b4b97974cf7ec3639992\">\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 a new list - Fourvenues API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new list\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fourvenues.mintlify.site/_mintlify/api/og/v2?division=Lists\u0026amp;title=Create+a+new+list\u0026amp;description=Create+a+new+list\u0026amp;theme=495e8dbd34f1f1d44d3c3d73\u0026amp;signature=8e38c7814b1a520fecfcf72f8f0ced241c392539f0f2b4b97974cf7ec3639992\">\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/fourvenues/Yw_SY54bSs0GSoYA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Fourvenues API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3b82f6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fourvenues.com/channel-manager/api-reference/lists/create-list\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/channel-manager/api-reference/lists/create-list.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fourvenues.com/#organization\",\"name\":\"Fourvenues API\",\"url\":\"https://docs.fourvenues.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fourvenues/Ac72CI1QKm9VekjS/logo/light.svg?fit=max\u0026auto=format\u0026n=Ac72CI1QKm9VekjS\u0026q=85\u0026s=34ea2eeb6703cf90846a1e2b12c609f4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fourvenues.com#website\",\"name\":\"Fourvenues API\",\"url\":\"https://docs.fourvenues.com\",\"publisher\":{\"@id\":\"https://docs.fourvenues.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fourvenues.com/channel-manager/api-reference/lists/create-list#webpage\",\"url\":\"https://docs.fourvenues.com/channel-manager/api-reference/lists/create-list\",\"name\":\"Create a new list\",\"description\":\"Create a new list\",\"dateModified\":\"2026-09-08T09:29:25.923Z\",\"isPartOf\":{\"@id\":\"https://docs.fourvenues.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fourvenues.com/channel-manager/api-reference/lists/create-list#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fourvenues.com/channel-manager/api-reference/lists/create-list#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.fourvenues.com/channel-manager/api-reference/auth/get-auth-information\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Lists\",\"item\":\"https://docs.fourvenues.com/channel-manager/api-reference/lists/get-lists\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create a new list\",\"item\":\"https://docs.fourvenues.com/channel-manager/api-reference/lists/create-list\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fourvenues.com/channel-manager/api-reference/lists/create-list#apireference\",\"headline\":\"Create a new list\",\"name\":\"Create a new list\",\"description\":\"Create a new list\",\"url\":\"https://docs.fourvenues.com/channel-manager/api-reference/lists/create-list\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fourvenues.com/channel-manager/api-reference/lists/create-list#webpage\"},\"dateModified\":\"2026-09-08T09:29:25.923Z\",\"publisher\":{\"@id\":\"https://docs.fourvenues.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fourvenues.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Fourvenues API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Fourvenues API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/channel-manager/api-reference/lists/create-list.md","siteName":"Fourvenues API","nav":{"global":null,"tabs":[{"tab":"Getting Start","pages":[{"title":"Getting Start","href":"/introduction/readme"}]},{"tab":"Channel Manager API","groups":[{"group":"Introduction","pages":[{"title":null,"href":"/channel-manager/introduction/overview"},{"title":"How to Use","url":"https://cm-guide.fourvenues.com/?lang=en","href":"/channel-manager/introduction/how-to-use"},{"title":null,"href":"/channel-manager/introduction/authentication"},{"title":null,"href":"/channel-manager/introduction/use-cases"},{"title":null,"href":"/channel-manager/introduction/what-can-i-do"},{"title":null,"href":"/channel-manager/introduction/requirements"}]},{"group":"API Reference","pages":[{"group":"Auth","pages":[{"openapi":"get /auth","title":"Get auth information","href":"/channel-manager/api-reference/auth/get-auth-information"}]},{"group":"Bookings","pages":[{"openapi":"get /bookings","title":"Get all bookings given a filter","href":"/channel-manager/api-reference/bookings/get-bookings"},{"openapi":"get /bookings/availability","title":null,"href":"/channel-manager/api-reference/bookings/get-bookings-availability"},{"openapi":"get /bookings/{bookingId}","title":null,"href":"/channel-manager/api-reference/bookings/get-booking-by-id"},{"openapi":"get /bookings/zones","title":"Get bookings zones for an event","href":"/channel-manager/api-reference/bookings/get-bookings-zones"},{"openapi":"post /bookings/checkout","title":"Create a checkout session for a booking","href":"/channel-manager/api-reference/bookings/post-bookings-checkout"},{"openapi":"post /bookings/request","title":"Request a booking","href":"/channel-manager/api-reference/bookings/post-bookings-request"},{"openapi":"patch /bookings/{bookingId}/observations","title":"Update observations of a booking","href":"/channel-manager/api-reference/bookings/patch-booking-observations"}]},{"group":"Custom Taxes","pages":[{"openapi":"get /custom-taxes","title":"Get custom taxes","href":"/channel-manager/api-reference/custom-taxes/get-custom-taxes"}]},{"group":"Discount Codes","pages":[{"openapi":"get /discount-codes/{code}","title":"Get discount code","href":"/channel-manager/api-reference/discount-codes/get-discount-code"},{"openapi":"post /discount-codes/bookings/validate/{code}","title":"Validate booking discount code","href":"/channel-manager/api-reference/discount-codes/post-discount-codes-bookings-validate"},{"openapi":"post /discount-codes/tickets/validate/{code}","title":"Validate ticket discount code","href":"/channel-manager/api-reference/discount-codes/post-discount-codes-tickets-validate"}]},{"group":"Events","pages":[{"openapi":"get /events","title":"Get all events","href":"/channel-manager/api-reference/events/get-all-events"},{"openapi":"get /events/{eventId}","title":null,"href":"/channel-manager/api-reference/events/get-an-event-by-id"},{"openapi":"get /events/by-slug/{eventSlug}","title":"Get an event by slug","href":"/channel-manager/api-reference/events/get-an-event-by-slug"},{"openapi":"post /events/{eventId}/preregister","title":"Register a user for event preregister","href":"/channel-manager/api-reference/events/post-event-preregister"}]},{"group":"Event Groups","pages":[{"openapi":"get /event-groups","title":"Get all event groups","href":"/channel-manager/api-reference/eventgroups/get-all-event-groups"},{"openapi":"get /event-groups/{eventGroupId}","title":"Get event group by id","href":"/channel-manager/api-reference/eventgroups/get-event-group-by-id"}]},{"group":"ListRates","pages":[{"openapi":"get /list-rates","title":"Get all list rates","href":"/channel-manager/api-reference/listrates/get-all-list-rates"},{"openapi":"get /list-rates/{listRateId}","title":"Get list rate by id","href":"/channel-manager/api-reference/listrates/get-list-rate-by-id"},{"openapi":"get /list-rates/by-slug/{listRateSlug}","title":"Get list rate by slug","href":"/channel-manager/api-reference/listrates/get-list-rate-by-slug"}]},{"group":"Lists","pages":[{"openapi":"get /lists","title":"Get all lists","description":"Get all lists","href":"/channel-manager/api-reference/lists/get-lists"},{"openapi":"post /lists","title":"Create a new list","href":"/channel-manager/api-reference/lists/create-list"},{"openapi":"get /lists/{listId}","title":null,"description":"Get a list by its identifier.","href":"/channel-manager/api-reference/lists/get-list-by-id"},{"openapi":"get /lists/by-code/{listCode}","title":null,"href":"/channel-manager/api-reference/lists/get-list-by-code"}]},{"group":"Locations","pages":[{"openapi":"get /locations","title":"Get all locations","href":"/channel-manager/api-reference/locations/get-all-locations"},{"openapi":"get /locations/{locationId}","title":"Get location","href":"/channel-manager/api-reference/locations/get-location"}]},{"group":"Organizations","pages":[{"openapi":"get /organizations","title":"Get all organizations","href":"/channel-manager/api-reference/organizations/get-all-organizations"},{"openapi":"get /organizations/{organizationId}","title":"Get an organization by id","href":"/channel-manager/api-reference/organizations/get-an-organization-by-id"},{"openapi":"get /organizations/by-slug/{organizationSlug}","title":"Get an organization by slug","href":"/channel-manager/api-reference/organizations/get-an-organization-by-slug"}]},{"group":"Payments","pages":[{"openapi":"get /payments","title":"Get all payments","href":"/channel-manager/api-reference/payments/get-all-payments"},{"openapi":"get /payments/{paymentId}","title":null,"href":"/channel-manager/api-reference/payments/get-a-payment-by-id"}]},{"group":"TicketRates","pages":[{"openapi":"get /ticket-rates","title":"Get all ticket rates","href":"/channel-manager/api-reference/ticketrates/get-all-ticket-rates"},{"openapi":"get /ticket-rates/{ticketRateId}","title":"Get ticket rate by id","href":"/channel-manager/api-reference/ticketrates/get-ticket-rate-by-id"},{"openapi":"get /ticket-rates/{ticketRateId}/pricing-info","title":"Get pricing info of a ticket rate given a quantity of tickets","href":"/channel-manager/api-reference/ticketrates/get-pricing-info-of-a-ticket-rate-given-a-quantity-of-tickets"},{"openapi":"get /ticket-rates/by-slug/{ticketRateSlug}","title":"Get ticket rate by slug","href":"/channel-manager/api-reference/ticketrates/get-ticket-rate-by-slug"}]},{"group":"Tickets","pages":[{"openapi":"get /tickets","title":"Get tickets","href":"/channel-manager/api-reference/tickets/get-tickets"},{"openapi":"post /tickets","title":"Create ticket","href":"/channel-manager/api-reference/tickets/create-ticket"},{"openapi":"post /tickets/checkout","title":"Checkout tickets","href":"/channel-manager/api-reference/tickets/checkout-tickets"},{"openapi":"get /tickets/{ticketId}","title":null,"href":"/channel-manager/api-reference/tickets/get-ticket-by-id"},{"openapi":"get /tickets/by-code/{ticketCode}","title":null,"href":"/channel-manager/api-reference/tickets/get-ticket-by-code"},{"openapi":"put /tickets/{ticketId}/refund","title":"Refund Ticket","href":"/channel-manager/api-reference/tickets/refund-ticket"},{"openapi":"get /tickets/{ticketId}/upselling","title":"Get ticket upselling catalog","href":"/channel-manager/api-reference/tickets/get-ticket-upselling"},{"openapi":"post /tickets/{ticketId}/upselling/checkout","title":"Checkout ticket upselling","href":"/channel-manager/api-reference/tickets/checkout-ticket-upselling"}]},{"group":"Tip Rates","pages":[{"openapi":"get /tip-rates","title":"Get tip rates","href":"/channel-manager/api-reference/tip-rates/get-tip-rates"}]},{"group":"Webhook Endpoints","pages":[{"openapi":"get /webhooks/endpoints","title":"Get all webhooks endpoints","href":"/channel-manager/api-reference/webhooks/get-all-webhooks-endpoints"},{"openapi":"post /webhooks/endpoints","title":"Create a new webhook endpoint","href":"/channel-manager/api-reference/webhooks/create-a-new-webhook-endpoint"},{"openapi":"delete /webhooks/endpoints/{id}","title":"Delete a webhook endpoint by id","href":"/channel-manager/api-reference/webhooks/delete-a-webhook-endpoint-by-id"}]}]},{"group":"Webhooks","pages":[{"group":"Introduction","pages":[{"title":null,"href":"/channel-manager/webhooks/introduction/introduction"},{"title":null,"href":"/channel-manager/webhooks/introduction/creating-a-webhook-endpoint"},{"title":null,"href":"/channel-manager/webhooks/introduction/authentication"},{"title":null,"href":"/channel-manager/webhooks/introduction/webhook-event-object"}]},{"group":"Events","pages":[{"title":"Payment Success Event","href":"/channel-manager/webhooks/events/payment-success-event"},{"title":"Ticket Refund Request Event","href":"/channel-manager/webhooks/events/ticket-request-refund-event"}]}]},{"group":"Recipes","pages":[{"title":"💳 Creating a Checkout Process","href":"/channel-manager/recipes/creating-a-checkout-process"},{"title":"🔊 Listening to Webhooks","href":"/channel-manager/recipes/listening-to-webhooks"}]}]},{"tab":"Integrations API","pages":[{"title":"Integrations API","href":"/integrations/introduction/overview"}]},{"tab":"Reseller API","pages":[{"title":"Reseller API","href":"/reseller/introduction/overview"}]}]},"basePath":"","title":"Create a new list - Fourvenues API","buildId":"dpl_8hoxaqFTU7hTr6A2fUraxAyjuiZo","deploymentId":"dpl_8hoxaqFTU7hTr6A2fUraxAyjuiZo","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CDiBsYGW.js","utils-KF9rPlmF.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C26urKTX.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BdjmJAC1.js","snippetPresets-3IpDBjt3.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-D4x_2vvo.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BIWdc5Pa.js","shallow-LQqfiMNd.js","getApiPlaygroundDisplay-DryzlOZG.js","CodeSnippet-tcJujU4r.js","CodeSnippets-BHp0nVLL.js","Page-1CZdsdAn.js","getPastedJson-DU-1ayUv.js","icon-CZK2hPr4.js","MethodPill-DOaqmTFC.js","DuplicateIcon-B5-nUxxl.js","createIcon-CDP_U77G.js","DynamicMarkdown-GHvayGOn.js","SectionHeading-BYvpkmUD.js","axios-vUo_bRtp.js","Markdown-uxhlayGT.js","clsx-B35qUV0p.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BvrGG8gU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CAf0yVYe.js"]}