Create a list to collect records for a campaign, account review, or another
workflow. Each list holds records from one object. Add its members in a
separate request after creating the list.
Save data.id from the response, then use it to
add entries. A list’s name must be
unique in the workspace, and its object cannot change after creation.
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Unify","description":"Official product documentation for Unify","colors":{"primary":"#211F20","light":"#FFFDFB","dark":"#211F20"},"logo":{"light":"https://mintcdn.com/unify-19/PwyIRLQXifAf3e_n/logo/light.svg?fit=max\u0026auto=format\u0026n=PwyIRLQXifAf3e_n\u0026q=85\u0026s=bb82fe528f439919b8c98a1d76b54422","dark":"https://mintcdn.com/unify-19/SMDnRDe0pZMIobVy/logo/dark.svg?fit=max\u0026auto=format\u0026n=SMDnRDe0pZMIobVy\u0026q=85\u0026s=7c45a4bb07ba1df57e2f033b48b9efbd","href":"https://unifygtm.com/"},"favicon":{"light":"https://mintcdn.com/unify-19/ZQhxPu15WhudU-6S/images/favicon.png?fit=max\u0026auto=format\u0026n=ZQhxPu15WhudU-6S\u0026q=85\u0026s=080f8542fdbc1593d430aa9e5f2d42a1","dark":"https://mintcdn.com/unify-19/ZQhxPu15WhudU-6S/images/favicon.png?fit=max\u0026auto=format\u0026n=ZQhxPu15WhudU-6S\u0026q=85\u0026s=080f8542fdbc1593d430aa9e5f2d42a1"},"appearance":{"default":"system"},"background":{"color":{"light":"#FFFDFB","dark":"#211F20"}},"navbar":{"primary":{"type":"button","label":"Sign in","href":"https://app.unifygtm.com"}},"footer":{"socials":{"x":"https://twitter.com/unifygtm","linkedin":"https://www.linkedin.com/company/unifygtm","youtube":"https://www.youtube.com/channel/UCni_bZk3MHm3ULFQ-cjfoLA"}},"seo":{"indexing":"navigable"},"fonts":{"heading":{"family":"Saans","source":"https://cdn.unifygtm.com/assets/fonts/Saans/Saans-Regular.woff2","format":"woff2"},"body":{"family":"Saans","source":"https://cdn.unifygtm.com/assets/fonts/Saans/Saans-Regular.woff2","format":"woff2"}},"styling":{"eyebrows":"section","latex":false},"integrations":{"posthog":{"apiKey":"phc_eLELdjMUDABB8Qg0pC0poaktw8fhGHcBFDGR2z7Q4a8","apiHost":"https://ingest.unifygtm.com","sessionRecording":false}},"thumbnails":{"background":"https://mintcdn.com/unify-19/ZQhxPu15WhudU-6S/images/og-background.png?fit=max\u0026auto=format\u0026n=ZQhxPu15WhudU-6S\u0026q=85\u0026s=124e2540a92d53783519ebfe05de4bf0"},"interaction":{"drilldown":true},"navigation":{"global":{"tabs":[{"tab":"Support","href":"https://support.unifygtm.com/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"unify-19","hasAudioNarration":false,"actualSubdomain":"unify-19","customDomains":["docs.unifygtm.com"],"gitSource":{"type":"github","owner":"unifygtm","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4b3bbae091ec13e32c979","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"Guides","count":110},{"language":"default","tag":"Developers","count":109},{"language":"default","tag":"API reference","count":82},{"language":"default","tag":"Using Unify","count":54},{"language":"default","tag":"Platform","count":53},{"language":"default","tag":"Data API","count":38},{"language":"default","tag":"Integrations","count":33},{"language":"default","tag":"Sequences API","count":28},{"language":"default","tag":"Sequences","count":22},{"language":"default","tag":"Enrollments","count":20}]},"assistantConfig":{"enableAskAiButton":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--unify-background-light: #fffff9;--unify-background-dark: #211F20;--unify-shell-background-light: oklch(96.513619375% 0.0027047 54);--unify-shell-background-dark: #1A1819;--unify-text-light: #1a1918;--unify-text-dark: #fffdfb;--unify-button-primary-light: #3B3939;--unify-card-hover-border-light: #A29B98;--unify-card-hover-border-dark: #A29B98;--unify-card-focus-ring-light: rgba(33, 31, 32, 0.18);--unify-card-focus-ring-dark: rgba(255, 253, 251, 0.22);--unify-nav-border-light: #E2DCD8;--unify-nav-border-dark: #3B3635;--unify-eyebrow-light: #5A5553;--unify-eyebrow-dark: #B0A8A5;--unify-nav-hover-light: #EBEAE8;--unify-nav-selected-light: #E3E2E2;--icon-critical-light: #d23434;--icon-warning-light: #cf7526;--icon-success-light: #22811a;--icon-disabled-light: #c9c6c4;--icon-purple-light: #3431ad;--icon-pink-light: #cb4182;--icon-yellow-light: #887115;--icon-teal-light: #0f837b;--icon-blue-light: #3378b8;--icon-red-light: #d23434;--icon-orange-light: #cf7526;--icon-green-light: #22811a;--icon-turquoise-light: #2b7562;--icon-critical-dark: #ff6d6d;--icon-warning-dark: #ffa95e;--icon-success-dark: #81e47c;--icon-disabled-dark: #8d8986;--icon-purple-dark: #b8b6ff;--icon-pink-dark: #fea0cc;--icon-yellow-dark: #ffee9a;--icon-teal-dark: #9de6e2;--icon-blue-dark: #96c5f1;--icon-red-dark: #ff6d6d;--icon-orange-dark: #ffa95e;--icon-green-dark: #81e47c;--icon-turquoise-dark: #a4ebd8}@font-face{font-family:\"Saans\";font-weight:400;font-display:swap;unicode-range:U+000-5FF, U+2000-206F;src:url(\"https://cdn.unifygtm.com/assets/fonts/Saans/Saans-Regular.woff2\"),\n url(\"https://cdn.unifygtm.com/assets/fonts/Saans/Saans-Regular.woff\")}@font-face{font-family:\"Saans\";font-weight:500;font-display:swap;unicode-range:U+000-5FF, U+2000-206F;src:url(\"https://cdn.unifygtm.com/assets/fonts/Saans/Saans-Medium.woff2\"),\n url(\"https://cdn.unifygtm.com/assets/fonts/Saans/Saans-Medium.woff\")}@font-face{font-family:\"Saans\";font-weight:600;font-display:swap;unicode-range:U+000-5FF, U+2000-206F;src:url(\"https://cdn.unifygtm.com/assets/fonts/Saans/Saans-SemiBold.woff2\"),\n url(\"https://cdn.unifygtm.com/assets/fonts/Saans/Saans-SemiBold.woff\")}body{color:var(--unify-text-light);background-color:var(--unify-background-light)}.dark body{color:var(--unify-text-dark);background-color:var(--unify-background-dark)}.card{border-radius:8px!important;transition:border-color 0.15s ease,\n box-shadow 0.15s ease}.card:hover,.card:focus-within{border-color:var(--unify-card-hover-border-light)!important}.dark .card:hover,.dark .card:focus-within{border-color:var(--unify-card-hover-border-dark)!important}.card:focus-within{box-shadow:0 0 0 2px var(--unify-card-focus-ring-light)}.dark .card:focus-within{box-shadow:0 0 0 2px var(--unify-card-focus-ring-dark)}.pagination-prev,.pagination-next{border-radius:8px!important}#navbar a[id$=\"-navbar-button\"]:not(#topbar-cta-button){border-color:#EDEDED}.eyebrow{color:var(--unify-eyebrow-light)!important;font-size:12px!important;letter-spacing:0.08em!important;line-height:20px!important;text-transform:uppercase!important}.dark .eyebrow{color:var(--unify-eyebrow-dark)!important}#page-title{color:var(--unify-text-light)!important}.dark #page-title{color:var(--unify-text-dark)!important}html:not(.dark) #navigation-items a:hover,html:not(.dark) #navigation-items button:hover{background-color:var(--unify-nav-hover-light)!important}#navigation-items a,#navigation-items button,#search-bar-entry{border-radius:5px!important}.rounded-search{border-radius:5px!important}.rounded-search>div,.rounded-search>div>div{border-radius:5px!important}html:not(.dark) #navigation-items a[aria-current=\"page\"],html:not(.dark) #navigation-items [data-active=\"true\"]>a,html:not(.dark) #navigation-items [data-active-nav-item=\"true\"]>a,html:not(.dark) #navigation-items [data-active-nav-item=\"true\"]>button{background-color:var(--unify-nav-selected-light)!important}@media (max-width: 1023px){#mobile-nav{border-right:1px solid var(--unify-nav-border-light)}.dark #mobile-nav{border-right-color:var(--unify-nav-border-dark)}}@media (min-width: 1024px){html[data-assistant-state=\"open\"] [data-docs-theme=\"almond\"],html[data-assistant-state=\"open\"] div:has(>#chat-assistant-sheet){background-color:var(--unify-shell-background-light)!important}html.dark[data-assistant-state=\"open\"] [data-docs-theme=\"almond\"],html.dark[data-assistant-state=\"open\"] div:has(>#chat-assistant-sheet){background-color:var(--unify-shell-background-dark)!important}}div:has(>#chat-assistant-sheet),#chat-assistant-sheet,#chat-assistant-sheet>div,#chat-assistant-sheet [class*=\"rounded-2xl\"],.chat-assistant-floating-input>div{border-radius:8px!important}#sidebar,#sidebar-content,#sidebar>div,#sidebar>div>div,aside#sidebar,#navbar,#navbar>div,#almond-background-color,#background-color,#body-content,html,body{background-color:var(--unify-shell-background-light)!important}.dark #sidebar,.dark #sidebar-content,.dark #sidebar>div,.dark #sidebar>div>div,.dark aside#sidebar,.dark #navbar,.dark #navbar>div,.dark #almond-background-color,.dark #background-color,.dark #body-content,html.dark,.dark body{background-color:var(--unify-shell-background-dark)!important}#content-container,#content-area{border-radius:8px!important}html:not(.dark) #content-container,html:not(.dark) #content-area{background-color:#FFFFFF!important}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){font-size:1.7em}#topbar-cta-button,#topbar-cta-button>*,#topbar-cta-button div{border-radius:5px!important}#topbar-cta-button{flex-shrink:0}html:not(.dark) #topbar-cta-button>a{background-color:var(--unify-button-primary-light)!important}.dark #topbar-cta-button,.dark #topbar-cta-button>*,.dark #topbar-cta-button div{background-color:#FFFDFB!important;color:#211F20!important}.dark #topbar-cta-button *{color:#211F20!important}.nav-tag-pill-text[data-nav-tag=\"Beta\"]{box-sizing:border-box;display:inline-flex;gap:8px;-webkit-box-align:center;align-items:center;min-width:0;max-width:100%;font-weight:400;line-height:1.25rem;letter-spacing:0.28px;transition:border 0.2s;border:1px solid rgb(207, 198, 161);background-color:rgb(255, 250, 230);color:rgb(136, 113, 21);padding:0 6px;border-radius:100px}.dark .nav-tag-pill-text[data-nav-tag=\"Beta\"]{border-color:rgb(122, 116, 82);background-color:rgb(64, 60, 42);color:rgb(255, 238, 154)}.api-section-heading-title{font-size:1.7em!important;line-height:1.3!important}#sidebar-content a[target=\"_blank\"]>div>div:has(>svg){flex:0 0 auto}@media (min-width: 1024px){#navbar .nav-tabs{position:fixed;top:8px;left:50%;transform:translateX(-50%);height:40px;align-items:center;gap:4px;padding:3px;border:1px solid rgba(33, 31, 32, 0.08);border-radius:9px;background:rgba(33, 31, 32, 0.05)}#navbar .nav-tabs-item{height:32px;padding:6px 10px;border-radius:6px;color:#565354}#navbar .nav-tabs-item:hover{background:rgba(33, 31, 32, 0.05)}#navbar .nav-tabs-item[data-active=\"true\"]{color:#211f20;background:#fff;box-shadow:0 1px 3px rgba(0, 0, 0, 0.10)}#navbar .nav-tabs-item:focus-visible{outline:2px solid currentColor;outline-offset:2px}.dark #navbar .nav-tabs{background:rgba(255, 255, 255, 0.04);border-color:rgba(255, 255, 255, 0.10)}.dark #navbar .nav-tabs-item{color:#bdbabb}.dark #navbar .nav-tabs-item:hover{background:rgba(255, 255, 255, 0.06)}.dark #navbar .nav-tabs-item[data-active=\"true\"]{color:#fff;background:#444142}}"}],"page":{"pagePath":"developers/api/data/lists/create","slug":"/developers/api/data/lists/create","pageMetadata":{"title":"Create list","openapi":"POST /data/v1/lists","description":"Create an empty list of records of one object.","href":"/developers/api/data/lists/create"},"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 an empty list of records of one object.\"\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`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,CodeBlock,Heading}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsx(_components.p,{children:`Create a list to collect records for a campaign, account review, or another\nworkflow. Each list holds records from one object. Add its members in a\nseparate request after creating the list.`}),`\n`,_jsx(Heading,{level:`2`,id:`examples`,children:`Examples`}),`\n`,_jsx(AccordionGroup,{children:_jsxs(Accordion,{title:`Create a prospect list`,id:`create-a-prospect-list`,children:[_jsxs(_components.p,{children:[`Set `,_jsx(_components.code,{children:`UNIFY_API_KEY`}),` to your API key. This creates a private person list:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` --request POST \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` --url `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.unifygtm.com/data/v1/lists\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` --header `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"X-Api-Key: $UNIFY_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` --header `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` --data `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"name\": \"Trial follow-up\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"object\": \"person\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"share_status\": \"ONLY_ME\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`}'`})}),`\n`]})})}),_jsxs(_components.p,{children:[`Save `,_jsx(_components.code,{children:`data.id`}),` from the response, then use it to\n`,_jsx(_components.a,{href:`/developers/api/data/list-entries/add`,children:`add entries`}),`. A list’s name must be\nunique in the workspace, and its object cannot change after creation.`]})]})})]})}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 list","openapi":"POST /data/v1/lists","description":"Create an empty list of records of one object.","href":"/developers/api/data/lists/create"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Examples","slug":"examples","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/unify-19/79f50771d687ca79/script.js"],"openApiReferenceData":{"operation":{"operationId":"create_list","description":"Create an empty list of records of one object.","parameters":[],"responses":{"201":"70ec466d-c28f-412e-829c-fe696152224c","400":"c585b58d-4561-4a3f-8729-fe455d002afa","401":"fdc8d015-8757-4f55-aabc-0e897cbfba9e","403":"216f1c04-0033-4a54-b85c-441497492b63","404":"844b1f10-31b9-4213-adb6-c8ead4c7d83a","409":"794cb4b6-83ca-47a3-8759-425d7c2d06b0","429":"29fa8330-2ff6-4c79-b427-3be5248eb649","500":"d244e5f7-da99-47f5-8a0f-2ea119a2c543"},"tags":["Data","Lists"],"requestBody":"cd4de589-edca-4933-9ef2-e26b8bc2375b","x-mcp-tool":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"method":"post","type":"path","servers":["f9ea8bc7-e0bf-49c5-b00a-57e58dca8fdd"],"security":["7295e3b9-9626-428c-ab1d-3f70c3f7ed49"],"path":"/data/v1/lists","baseUrlOptions":["https://api.unifygtm.com"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","object"],"properties":{"name":{"type":"string","minLength":1,"maxLength":255,"description":"Name of the list. Must be unique within the workspace.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"object":{"type":"string","description":"API name of the object whose records the list will hold. Cannot be\nchanged after creation.","isRequired":true,"uniqueKey":"object","typeLabel":"string"},"share_status":{"type":"string","enum":["ONLY_ME","ALL_OTHERS_CAN_VIEW","ALL_OTHERS_CAN_EDIT"],"description":"Who can see and change the list. Defaults to `ONLY_ME`.","uniqueKey":"share_status","typeLabel":"enum\u003cstring>"}},"description":"Request body for creating a list.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","object":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"70ec466d-c28f-412e-829c-fe696152224c":{"description":"Response for a successful create operation.","content":{"application/json":{"schema":{"type":"object","required":["status","data"],"properties":{"status":{"type":"string","enum":["success"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"data":{"type":"object","required":["id","created_at","updated_at","name","object","owner_id","share_status"],"properties":{"id":{"type":"string","description":"Unique identifier for the list.","title":"UUuid","isRequired":true,"uniqueKey":"data.id","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","description":"Date and time the list was created.","isRequired":true,"uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","description":"Date and time the list was last updated.","isRequired":true,"uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time>"},"name":{"type":"string","description":"Name of the list. Unique within the workspace.","isRequired":true,"uniqueKey":"data.name","typeLabel":"string"},"object":{"type":"string","description":"API name of the object whose records the list holds. Cannot be changed\nafter creation.","isRequired":true,"uniqueKey":"data.object","typeLabel":"string"},"owner_id":{"type":"string","description":"ID of the user who owns the list.","title":"UUuid","isRequired":true,"uniqueKey":"data.owner_id","typeLabel":"string"},"share_status":{"type":"string","enum":["ONLY_ME","ALL_OTHERS_CAN_VIEW","ALL_OTHERS_CAN_EDIT"],"description":"Who can see and change the list.","isRequired":true,"uniqueKey":"data.share_status","typeLabel":"enum\u003cstring>"}},"description":"A named collection of records of one object.","isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"description":"Response for a successful create operation.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"success","data":{"id":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","name":"\u003cstring>","object":"\u003cstring>","owner_id":"\u003cstring>","share_status":"ONLY_ME"}}}},"exampleType":"generated"}},"exampleType":"generated"},"c585b58d-4561-4a3f-8729-fe455d002afa":{"description":"Response for any operation that results in a bad request error.","content":{"application/json":{"schema":{"type":"object","required":["status"],"properties":{"status":{"type":"string","enum":["bad_request"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"errors":{"type":"array","items":{"type":"object","description":"Validation error detail returned for bad request responses.","required":["code"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"path":{"type":"array","items":{"oneOf":[{"type":"string","uniqueKey":"errors.items.[INDEX].path.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"errors.items.[INDEX].path.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"errors.items.[INDEX].path.items.[INDEX]","typeLabel":"string | integer"},"uniqueKey":"errors.items.[INDEX].path","typeLabel":"(string | integer)[]"},"object_api_name":{"type":"string","uniqueKey":"errors.items.[INDEX].object_api_name","typeLabel":"string"},"attribute_api_name":{"type":"string","uniqueKey":"errors.items.[INDEX].attribute_api_name","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"description":"Response for any operation that results in a bad request error.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"bad_request","errors":[{"code":"\u003cstring>","path":["\u003cstring>"],"object_api_name":"\u003cstring>","attribute_api_name":"\u003cstring>"}],"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"fdc8d015-8757-4f55-aabc-0e897cbfba9e":{"description":"Response for any operation that results in an unauthorized error.","content":{"application/json":{"schema":{"type":"object","required":["status","message"],"properties":{"status":{"type":"string","enum":["unauthorized"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"description":"Response for any operation that results in an unauthorized error.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"unauthorized","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"216f1c04-0033-4a54-b85c-441497492b63":{"description":"Response for any operation that results in a forbidden error.","content":{"application/json":{"schema":{"type":"object","required":["status","message"],"properties":{"status":{"type":"string","enum":["forbidden"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"description":"Response for any operation that results in a forbidden error.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"forbidden","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"844b1f10-31b9-4213-adb6-c8ead4c7d83a":{"description":"Response for any operation that results in a not found error.","content":{"application/json":{"schema":{"type":"object","required":["status","message"],"properties":{"status":{"type":"string","enum":["object_not_found"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"description":"Response for any operation that results in a not found error.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"object_not_found","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"794cb4b6-83ca-47a3-8759-425d7c2d06b0":{"description":"Response for any operation that results in a conflict error.","content":{"application/json":{"schema":{"type":"object","required":["status","message"],"properties":{"status":{"type":"string","enum":["list_conflict"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"description":"Response for any operation that results in a conflict error.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"list_conflict","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"29fa8330-2ff6-4c79-b427-3be5248eb649":{"description":"Response for any operation that exceeds a rate limit.","content":{"application/json":{"schema":{"type":"object","required":["status","message"],"properties":{"status":{"type":"string","enum":["rate_limited"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"description":"Response for any operation that exceeds a rate limit.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"rate_limited","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"d244e5f7-da99-47f5-8a0f-2ea119a2c543":{"description":"Response for any operation that results in an internal server error.","content":{"application/json":{"schema":{"type":"object","required":["status","message"],"properties":{"status":{"type":"string","enum":["error"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"description":"Response for any operation that results in an internal server error.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"error","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"7295e3b9-9626-428c-ab1d-3f70c3f7ed49":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"f9ea8bc7-e0bf-49c5-b00a-57e58dca8fdd":{"url":"https://api.unifygtm.com","variables":{}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"developers/api/data/openapi.json"},"subdomain":"unify-19","siteName":"Unify","title":"Create list - Unify","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-07T22:59:56.429Z","originalFileLocation":"developers/api/data/lists/create.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 an empty list of records of one object.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Unify\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/unify-19/XcGmszvtgSRxCUxJ/_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/unify-19/XcGmszvtgSRxCUxJ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/unify-19/XcGmszvtgSRxCUxJ/_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/unify-19/XcGmszvtgSRxCUxJ/_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/unify-19/XcGmszvtgSRxCUxJ/_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/unify-19/XcGmszvtgSRxCUxJ/_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/unify-19/XcGmszvtgSRxCUxJ/_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/unify-19/XcGmszvtgSRxCUxJ/_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/unify-19/XcGmszvtgSRxCUxJ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create list - Unify\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create an empty list of records of one object.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Unify\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.unifygtm.com/developers/api/data/lists/create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://unify-19.mintlify.site/_mintlify/api/og/v2?division=Lists\u0026amp;title=Create+list\u0026amp;description=Create+an+empty+list+of+records+of+one+object.\u0026amp;theme=7ed7dc594dd5dcbc073e0627\u0026amp;signature=5d37414bb3d699b3e0cc823c0dda889cdc11f5e09de443e6da3e70f214da4d81\">\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 list - Unify\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create an empty list of records of one object.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://unify-19.mintlify.site/_mintlify/api/og/v2?division=Lists\u0026amp;title=Create+list\u0026amp;description=Create+an+empty+list+of+records+of+one+object.\u0026amp;theme=7ed7dc594dd5dcbc073e0627\u0026amp;signature=5d37414bb3d699b3e0cc823c0dda889cdc11f5e09de443e6da3e70f214da4d81\">\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/unify-19/XcGmszvtgSRxCUxJ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Unify\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#211F20\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.unifygtm.com/developers/api/data/lists/create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/developers/api/data/lists/create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.unifygtm.com/#organization\",\"name\":\"Unify\",\"url\":\"https://docs.unifygtm.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/unify-19/PwyIRLQXifAf3e_n/logo/light.svg?fit=max\u0026auto=format\u0026n=PwyIRLQXifAf3e_n\u0026q=85\u0026s=bb82fe528f439919b8c98a1d76b54422\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.unifygtm.com#website\",\"name\":\"Unify\",\"url\":\"https://docs.unifygtm.com\",\"publisher\":{\"@id\":\"https://docs.unifygtm.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.unifygtm.com/developers/api/data/lists/create#webpage\",\"url\":\"https://docs.unifygtm.com/developers/api/data/lists/create\",\"name\":\"Create list\",\"description\":\"Create an empty list of records of one object.\",\"dateModified\":\"2026-10-07T22:59:56.429Z\",\"isPartOf\":{\"@id\":\"https://docs.unifygtm.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.unifygtm.com/developers/api/data/lists/create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.unifygtm.com/developers/api/data/lists/create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://docs.unifygtm.com/developers/api/analytics/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Data API\",\"item\":\"https://docs.unifygtm.com/developers/api/data/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Lists\",\"item\":\"https://docs.unifygtm.com/developers/api/data/lists/overview\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Create list\",\"item\":\"https://docs.unifygtm.com/developers/api/data/lists/create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.unifygtm.com/developers/api/data/lists/create#apireference\",\"headline\":\"Create list\",\"name\":\"Create list\",\"description\":\"Create an empty list of records of one object.\",\"url\":\"https://docs.unifygtm.com/developers/api/data/lists/create\",\"mainEntityOfPage\":{\"@id\":\"https://docs.unifygtm.com/developers/api/data/lists/create#webpage\"},\"dateModified\":\"2026-10-07T22:59:56.429Z\",\"publisher\":{\"@id\":\"https://docs.unifygtm.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.unifygtm.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Unify\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Unify\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/developers/api/data/lists/create.md","siteName":"Unify","nav":{"global":{"tabs":[{"tab":"Support","href":"https://support.unifygtm.com/"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"Developers","groups":[{"group":"Unify platform","pages":[{"title":"Unify for Developers","sidebarTitle":"Introduction","href":"/developers/introduction"},{"title":"Connecting your data","sidebarTitle":"Connecting your data","href":"/developers/connecting-data"}]},{"group":"MCP","pages":[{"title":"Getting started","sidebarTitle":"Getting started","href":"/developers/mcp/getting-started"},{"title":"Tools","sidebarTitle":"Tools","href":"/developers/mcp/tools"}]},{"group":"Developer guides","pages":[{"group":"Website traffic","pages":[{"title":"Connect website traffic to Unify","sidebarTitle":"Introduction","href":"/developers/guides/website-traffic/introduction"},{"title":"Set up the Unify Intent client","sidebarTitle":"Set up Unify client","href":"/developers/guides/website-traffic/unify-intent-client"},{"title":"Capture form fills","sidebarTitle":"Capture form fills","href":"/developers/guides/website-traffic/form-fills"},{"title":"Capture button clicks","sidebarTitle":"Capture button clicks","href":"/developers/guides/website-traffic/button-clicks"}]},{"group":"Product usage data","pages":[{"title":"Connect product usage data to Unify","sidebarTitle":"Introduction","href":"/developers/guides/product-usage-data/introduction"},{"title":"Set up the Unify Intent client","sidebarTitle":"Set up Unify client","href":"/developers/guides/product-usage-data/unify-intent-client"},{"title":"Capture user logins","sidebarTitle":"Capture user logins","href":"/developers/guides/product-usage-data/user-logins"},{"title":"Capture user interactions","sidebarTitle":"Capture user interactions","href":"/developers/guides/product-usage-data/user-interactions"}]},{"group":"Connect a data system","pages":[{"title":"Connect data systems to Unify","sidebarTitle":"Overview","href":"/developers/guides/data-systems/overview"},{"title":"Sync data from Hightouch","sidebarTitle":"Hightouch destination","href":"/developers/guides/data-systems/hightouch-destination"},{"title":"Sync data from Fivetran","sidebarTitle":"Fivetran destination","href":"/developers/guides/data-systems/fivetran-destination"}]},{"group":"Send records via API","pages":[{"title":"Send records via API","sidebarTitle":"Overview","href":"/developers/guides/send-data/overview"},{"title":"Import data from a CSV","sidebarTitle":"Import data from a CSV","href":"/developers/guides/send-data/csv-import"},{"title":"Send records from Clay sheet","sidebarTitle":"Send records from Clay","href":"/developers/guides/send-data/clay-webhook"}]},{"group":"Fetch data via API","pages":[{"title":"Using query jobs","sidebarTitle":"Query jobs","href":"/developers/guides/request-data/query-jobs"},{"title":"Build a data connector","sidebarTitle":"Build a connector","href":"/developers/guides/request-data/build-connector"}]}]},{"group":"API reference","pages":[{"group":"Analytics API","pages":[{"title":"Unify Analytics API","sidebarTitle":"Overview","href":"/developers/api/analytics/overview"},{"title":"Page events","sidebarTitle":"Page events","openapi":"POST /page","href":"/developers/api/analytics/page"},{"title":"Custom events","sidebarTitle":"Custom events","openapi":"POST /track","href":"/developers/api/analytics/custom"},{"title":"Identify events","sidebarTitle":"Identify events","openapi":"POST /identify","href":"/developers/api/analytics/identify"}]},{"group":"Data API","pages":[{"title":"Unify Data API","sidebarTitle":"Overview","href":"/developers/api/data/overview"},{"title":"Standard objects and attributes","sidebarTitle":"Standard objects","href":"/developers/api/data/standard-objects"},{"group":"Objects","pages":[{"title":"List objects","openapi":"GET /data/v1/objects","href":"/developers/api/data/objects/list"},{"title":"Create object","openapi":"POST /data/v1/objects","href":"/developers/api/data/objects/create"},{"title":"Get object","openapi":"GET /data/v1/objects/{object_name}","href":"/developers/api/data/objects/get"},{"title":"Update object","openapi":"PATCH /data/v1/objects/{object_name}","href":"/developers/api/data/objects/update"},{"title":"Delete object","openapi":"DELETE /data/v1/objects/{object_name}","href":"/developers/api/data/objects/delete"}]},{"group":"Attributes","pages":[{"title":"List attributes","openapi":"GET /data/v1/objects/{object_name}/attributes","href":"/developers/api/data/attributes/list"},{"title":"Create attribute","openapi":"POST /data/v1/objects/{object_name}/attributes","href":"/developers/api/data/attributes/create"},{"title":"Get attribute","openapi":"GET /data/v1/objects/{object_name}/attributes/{attribute_name}","href":"/developers/api/data/attributes/get"},{"title":"Update attribute","openapi":"PATCH /data/v1/objects/{object_name}/attributes/{attribute_name}","href":"/developers/api/data/attributes/update"},{"title":"Delete attribute","openapi":"DELETE /data/v1/objects/{object_name}/attributes/{attribute_name}","href":"/developers/api/data/attributes/delete"},{"group":"Options","pages":[{"title":"List options","openapi":"GET /data/v1/objects/{object_name}/attributes/{attribute_name}/options","href":"/developers/api/data/attributes/options/list"},{"title":"Create option","openapi":"POST /data/v1/objects/{object_name}/attributes/{attribute_name}/options","href":"/developers/api/data/attributes/options/create"},{"title":"Get option","openapi":"GET /data/v1/objects/{object_name}/attributes/{attribute_name}/options/{option_name}","href":"/developers/api/data/attributes/options/get"},{"title":"Update option","openapi":"PATCH /data/v1/objects/{object_name}/attributes/{attribute_name}/options/{option_name}","href":"/developers/api/data/attributes/options/update"},{"title":"Delete option","openapi":"DELETE /data/v1/objects/{object_name}/attributes/{attribute_name}/options/{option_name}","href":"/developers/api/data/attributes/options/delete"}]}]},{"group":"Records","pages":[{"title":"Find unique record","sidebarTitle":"Find record","openapi":"POST /data/v1/objects/{object_name}/records/find-unique","href":"/developers/api/data/records/find-unique"},{"title":"Upsert record","openapi":"POST /data/v1/objects/{object_name}/records/upsert","href":"/developers/api/data/records/upsert"},{"title":"Get record","openapi":"GET /data/v1/objects/{object_name}/records/{record_id}","href":"/developers/api/data/records/get"},{"title":"Create record","openapi":"POST /data/v1/objects/{object_name}/records","href":"/developers/api/data/records/create"},{"title":"Update record","openapi":"PATCH /data/v1/objects/{object_name}/records/{record_id}","href":"/developers/api/data/records/update"},{"title":"Delete record","openapi":"DELETE /data/v1/objects/{object_name}/records/{record_id}","href":"/developers/api/data/records/delete"},{"group":"Query records","pages":[{"title":"Create job","sidebarTitle":"Create job","openapi":"POST /data/v1/objects/{object_name}/query-jobs","href":"/developers/api/data/records/query-records/create"},{"title":"List jobs","sidebarTitle":"List jobs","openapi":"GET /data/v1/objects/{object_name}/query-jobs","href":"/developers/api/data/records/query-records/list"},{"title":"Get job","sidebarTitle":"Get job","openapi":"GET /data/v1/objects/{object_name}/query-jobs/{job_id}","href":"/developers/api/data/records/query-records/get"},{"title":"Cancel job","sidebarTitle":"Cancel job","openapi":"POST /data/v1/objects/{object_name}/query-jobs/{job_id}/cancel","href":"/developers/api/data/records/query-records/cancel"},{"title":"Get results","sidebarTitle":"Get results","openapi":"GET /data/v1/objects/{object_name}/query-jobs/{job_id}/results","href":"/developers/api/data/records/query-records/results"}]}]},{"group":"Lists","pages":[{"title":"Lists","sidebarTitle":"Overview","href":"/developers/api/data/lists/overview"},{"title":"List lists","openapi":"GET /data/v1/lists","description":"Find lists by object or exact name.","href":"/developers/api/data/lists/list"},{"title":"Create list","openapi":"POST /data/v1/lists","href":"/developers/api/data/lists/create"},{"title":"Get list","openapi":"GET /data/v1/lists/{list_id}","description":"Get a single list by its ID.","href":"/developers/api/data/lists/get"},{"title":"Update list","openapi":"PATCH /data/v1/lists/{list_id}","href":"/developers/api/data/lists/update"},{"title":"Delete list","openapi":"DELETE /data/v1/lists/{list_id}","href":"/developers/api/data/lists/delete"},{"group":"Entries","pages":[{"title":"List entries","openapi":"GET /data/v1/lists/{list_id}/entries","href":"/developers/api/data/list-entries/list"},{"title":"Get entry","openapi":"GET /data/v1/lists/{list_id}/entries/{entry_id}","href":"/developers/api/data/list-entries/get"},{"title":"Add entries","openapi":"POST /data/v1/lists/{list_id}/entries/add","href":"/developers/api/data/list-entries/add"},{"title":"Remove entries","openapi":"POST /data/v1/lists/{list_id}/entries/remove","href":"/developers/api/data/list-entries/remove"}]}]}]},{"group":"Sequences API","pages":[{"title":"Unify Sequences API","sidebarTitle":"Overview","href":"/developers/api/sequences/overview"},{"group":"Sequences","pages":[{"title":"List sequences","openapi":"GET /sequences/v1/sequences","href":"/developers/api/sequences/sequences/list"},{"title":"Get sequence","openapi":"GET /sequences/v1/sequences/{id}","href":"/developers/api/sequences/sequences/get"},{"title":"Pause sequence","openapi":"POST /sequences/v1/sequences/{id}/pause","href":"/developers/api/sequences/sequences/pause"},{"title":"Resume sequence","openapi":"POST /sequences/v1/sequences/{id}/resume","href":"/developers/api/sequences/sequences/resume"},{"title":"Delete sequence","openapi":"DELETE /sequences/v1/sequences/{id}","href":"/developers/api/sequences/sequences/delete"},{"title":"List sequence steps","sidebarTitle":"List steps","openapi":"GET /sequences/v1/sequences/{id}/steps","href":"/developers/api/sequences/sequences/list-steps"},{"title":"Get sequence step","sidebarTitle":"Get step","openapi":"GET /sequences/v1/sequences/{id}/steps/{step_id}","href":"/developers/api/sequences/sequences/get-step"}]},{"group":"Enrollments","pages":[{"title":"Create enrollment","openapi":"POST /sequences/v1/enrollments","href":"/developers/api/sequences/enrollments/create"},{"title":"List enrollments","openapi":"GET /sequences/v1/enrollments","href":"/developers/api/sequences/enrollments/list"},{"title":"Get enrollment","openapi":"GET /sequences/v1/enrollments/{id}","href":"/developers/api/sequences/enrollments/get"},{"title":"Approve enrollment","openapi":"POST /sequences/v1/enrollments/{id}/approve","href":"/developers/api/sequences/enrollments/approve"},{"title":"Pause enrollment","openapi":"POST /sequences/v1/enrollments/{id}/pause","href":"/developers/api/sequences/enrollments/pause"},{"title":"Resume enrollment","openapi":"POST /sequences/v1/enrollments/{id}/resume","href":"/developers/api/sequences/enrollments/resume"},{"title":"Delete enrollment","openapi":"DELETE /sequences/v1/enrollments/{id}","href":"/developers/api/sequences/enrollments/delete"},{"title":"List enrollment steps","sidebarTitle":"List steps","openapi":"GET /sequences/v1/enrollments/{id}/steps","href":"/developers/api/sequences/enrollments/list-steps"},{"title":"Get enrollment step","sidebarTitle":"Get step","openapi":"GET /sequences/v1/enrollment-steps/{id}","href":"/developers/api/sequences/enrollments/get-step"},{"title":"Update enrollment step","sidebarTitle":"Update step","openapi":"PATCH /sequences/v1/enrollment-steps/{id}","href":"/developers/api/sequences/enrollments/update-step"},{"group":"Query enrollments","pages":[{"title":"Create job","sidebarTitle":"Create job","openapi":"POST /sequences/v1/enrollments/query-jobs","href":"/developers/api/sequences/enrollments/query-enrollments/create"},{"title":"List jobs","sidebarTitle":"List jobs","openapi":"GET /sequences/v1/enrollments/query-jobs","href":"/developers/api/sequences/enrollments/query-enrollments/list"},{"title":"Get job","sidebarTitle":"Get job","openapi":"GET /sequences/v1/enrollments/query-jobs/{job_id}","href":"/developers/api/sequences/enrollments/query-enrollments/get"},{"title":"Cancel job","sidebarTitle":"Cancel job","openapi":"POST /sequences/v1/enrollments/query-jobs/{job_id}/cancel","href":"/developers/api/sequences/enrollments/query-enrollments/cancel"},{"title":"Get results","sidebarTitle":"Get results","openapi":"GET /sequences/v1/enrollments/query-jobs/{job_id}/results","href":"/developers/api/sequences/enrollments/query-enrollments/results"}]},{"group":"Query enrollment steps","pages":[{"title":"Create job","sidebarTitle":"Create job","openapi":"POST /sequences/v1/enrollment-steps/query-jobs","href":"/developers/api/sequences/enrollments/query-enrollment-steps/create"},{"title":"List jobs","sidebarTitle":"List jobs","openapi":"GET /sequences/v1/enrollment-steps/query-jobs","href":"/developers/api/sequences/enrollments/query-enrollment-steps/list"},{"title":"Get job","sidebarTitle":"Get job","openapi":"GET /sequences/v1/enrollment-steps/query-jobs/{job_id}","href":"/developers/api/sequences/enrollments/query-enrollment-steps/get"},{"title":"Cancel job","sidebarTitle":"Cancel job","openapi":"POST /sequences/v1/enrollment-steps/query-jobs/{job_id}/cancel","href":"/developers/api/sequences/enrollments/query-enrollment-steps/cancel"},{"title":"Get results","sidebarTitle":"Get results","openapi":"GET /sequences/v1/enrollment-steps/query-jobs/{job_id}/results","href":"/developers/api/sequences/enrollments/query-enrollment-steps/results"}]}]}]},{"group":"Tasks API","pages":[{"title":"Unify Tasks API","sidebarTitle":"Overview","href":"/developers/api/tasks/overview"},{"group":"Tasks","pages":[{"title":"List tasks","openapi":"GET /tasks/v1/tasks","href":"/developers/api/tasks/tasks/list"},{"title":"Create task","openapi":"POST /tasks/v1/tasks","href":"/developers/api/tasks/tasks/create"},{"title":"Get task","openapi":"GET /tasks/v1/tasks/{id}","href":"/developers/api/tasks/tasks/get"},{"title":"Update task","openapi":"PATCH /tasks/v1/tasks/{id}","href":"/developers/api/tasks/tasks/update"},{"title":"Delete task","openapi":"DELETE /tasks/v1/tasks/{id}","href":"/developers/api/tasks/tasks/delete"},{"title":"Complete task","openapi":"POST /tasks/v1/tasks/{id}/complete","href":"/developers/api/tasks/tasks/complete"},{"group":"Query tasks","pages":[{"title":"Create job","sidebarTitle":"Create job","openapi":"POST /tasks/v1/tasks/query-jobs","href":"/developers/api/tasks/tasks/query-tasks/create"},{"title":"List jobs","sidebarTitle":"List jobs","openapi":"GET /tasks/v1/tasks/query-jobs","href":"/developers/api/tasks/tasks/query-tasks/list"},{"title":"Get job","sidebarTitle":"Get job","openapi":"GET /tasks/v1/tasks/query-jobs/{job_id}","href":"/developers/api/tasks/tasks/query-tasks/get"},{"title":"Cancel job","sidebarTitle":"Cancel job","openapi":"POST /tasks/v1/tasks/query-jobs/{job_id}/cancel","href":"/developers/api/tasks/tasks/query-tasks/cancel"},{"title":"Get results","sidebarTitle":"Get results","openapi":"GET /tasks/v1/tasks/query-jobs/{job_id}/results","href":"/developers/api/tasks/tasks/query-tasks/results"}]}]}]}]},{"group":"SDKs","pages":[{"group":"Intent Client","pages":[{"title":"Unify Intent Client","sidebarTitle":"Overview","href":"/developers/intent-client/overview"},{"group":"Installation","pages":[{"title":"Website tag","sidebarTitle":"Website tag","icon":"code","href":"/developers/intent-client/website-tag"},{"title":"Install React package","sidebarTitle":"React package","icon":"react","href":"/developers/intent-client/react"},{"title":"Install JavaScript package","sidebarTitle":"JavaScript package","icon":"square-js","href":"/developers/intent-client/js-client"}]},{"title":"Usage guide","sidebarTitle":"Usage guide","href":"/developers/intent-client/usage-guide"}]},{"title":"Unify Python library","sidebarTitle":"Python library","href":"/developers/sdks/python-library"},{"title":"Unify TypeScript library","sidebarTitle":"TypeScript library","href":"/developers/sdks/typescript-library"}]}]},{"tab":"Tutorials","hidden":true,"pages":[{"title":"Tutorials","href":"/tutorials/create-a-play"}]}]},"basePath":"","title":"Create list - Unify","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-C4GwDT3_.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}