{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ziik.io API docs","colors":{"primary":"#2a79ff","light":"#75a8ff","dark":"#2a79ff"},"logo":{"light":"https://mintcdn.com/ziik/XGBy0jppV3iL5Bou/logo/light.svg?fit=max\u0026auto=format\u0026n=XGBy0jppV3iL5Bou\u0026q=85\u0026s=e9ee9f29e1e2703be68c906ed13771f3","dark":"https://mintcdn.com/ziik/XGBy0jppV3iL5Bou/logo/dark.svg?fit=max\u0026auto=format\u0026n=XGBy0jppV3iL5Bou\u0026q=85\u0026s=c0bee07462dbee0e7b95e3bb8368e26d"},"favicon":"/favicon.ico","navbar":{"links":[{"href":"https://www.ziik.io/contact-us","label":"Support"}]},"footer":{"socials":{}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Contact us","icon":"book-open-cover","href":"https://www.ziik.io/contact-us"},{"anchor":"Helpcenter","icon":"book-open-cover","href":"https://help.ziik.io/"},{"anchor":"Blog","icon":"newspaper","href":"https://www.ziik.io/blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ziik","hasAudioNarration":false,"actualSubdomain":"ziik","customDomains":["docs.ziik.io"],"gitSource":{"type":"github","owner":"ziikio","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae943ba79df2a22b14b27ce:success","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API Reference","count":60},{"language":"default","tag":"Conversations","count":14},{"language":"default","tag":"Users","count":10},{"language":"default","tag":"Docs","count":9},{"language":"default","tag":"Posts","count":8},{"language":"default","tag":"Units","count":7},{"language":"default","tag":"Groups","count":6},{"language":"default","tag":"User types","count":6},{"language":"default","tag":"Recommended reads","count":4},{"language":"default","tag":"User unit memberships","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"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":"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":[],"page":{"pagePath":"api-reference/user-unit-memberships/add-unit-membership","slug":"/api-reference/user-unit-memberships/add-unit-membership","pageMetadata":{"title":"Add unit membership","description":"Creates or updates a unit membership for the user (unit, department, user types). Returns the membership and sets Location header.","deprecated":null,"version":null,"openapi":"/openapi.yaml post /users/{user}/units","href":"/api-reference/user-unit-memberships/add-unit-membership","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Creates or updates a unit membership for the user (unit, department, user types). Returns the membership and sets Location header.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Add unit membership","description":"Creates or updates a unit membership for the user (unit, department, user types). Returns the membership and sets Location header.","deprecated":null,"version":null,"openapi":"/openapi.yaml post /users/{user}/units","href":"/api-reference/user-unit-memberships/add-unit-membership","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["User unit memberships"],"summary":"Add unit membership","description":"Creates or updates a unit membership for the user (unit, department, user types). Returns the membership and sets Location header.","operationId":"6982f2d3b5ce25286407f12ac5a742e5","parameters":["521422fe-4ee3-405d-a9df-284c9032e7ee"],"requestBody":"a9d54fca-76c0-43cb-9926-f86618fabf1e","responses":{"201":"ed5eb9c5-7d4f-4140-9b63-ecfd0430c423","404":"d4e56c2a-de9e-4a2a-8138-68c536c85987","422":"c4ce6673-38c4-4ec7-abb8-41b841fd29e2"},"method":"post","type":"path","servers":[],"security":[],"path":"/users/{user}/units","baseUrlOptions":[],"title":"Add unit membership","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"521422fe-4ee3-405d-a9df-284c9032e7ee":{"name":"user","in":"path","description":"User ID","required":true,"schema":{"type":"integer","isRequired":true,"description":"User ID","uniqueKey":"","typeLabel":"integer"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["unit"],"properties":{"unit":{"description":"Unit ID","type":"integer","isRequired":true,"uniqueKey":"unit","typeLabel":"integer"},"userTypes":{"description":"User type IDs","type":"array","items":{"type":"integer","uniqueKey":"userTypes.items.[INDEX]","typeLabel":"integer"},"uniqueKey":"userTypes","typeLabel":"integer[]"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"unit":123,"userTypes":[123]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"ed5eb9c5-7d4f-4140-9b63-ecfd0430c423":{"description":"Unit membership created","content":{"application/json":{"schema":{"properties":{"id":{"type":"integer","example":1,"uniqueKey":"id","typeLabel":"integer"},"abilities":{"description":"Permission abilities when permissions relation loaded","type":"object","additionalProperties":{"type":"boolean","uniqueKey":"abilities.additionalProperties","typeLabel":"boolean"},"uniqueKey":"abilities","typeLabel":"object"},"unit":{"properties":{"content_type":{"type":"string","example":"unit","uniqueKey":"unit.content_type","typeLabel":"string"},"id":{"type":"integer","example":1,"uniqueKey":"unit.id","typeLabel":"integer"},"reference":{"oneOf":[{"type":"string","uniqueKey":"unit.reference.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"unit.reference.oneOf.1","typeLabel":"null"}],"uniqueKey":"unit.reference","typeLabel":"string | null"},"name":{"type":"string","example":"HQ","uniqueKey":"unit.name","typeLabel":"string"},"description":{"oneOf":[{"type":"string","uniqueKey":"unit.description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"unit.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"unit.description","typeLabel":"string | null"},"level":{"description":"Depth in unit tree","type":"integer","uniqueKey":"unit.level","typeLabel":"integer"},"path":{"description":"Materialized path","type":"string","uniqueKey":"unit.path","typeLabel":"string"},"unit_type":{"type":"string","example":"unit","uniqueKey":"unit.unit_type","typeLabel":"string"},"falldown":{"oneOf":[{"description":"From pivot when in context","type":"boolean","uniqueKey":"unit.falldown.oneOf.0","typeLabel":"boolean"},{"description":"From pivot when in context","type":"null","uniqueKey":"unit.falldown.oneOf.1","typeLabel":"null"}],"uniqueKey":"unit.falldown","typeLabel":"boolean | null"},"features":{"oneOf":[{"type":"array","items":{"type":"object","uniqueKey":"unit.features.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"unit.features.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object"},"uniqueKey":"unit.features.oneOf.1","typeLabel":"null"}],"uniqueKey":"unit.features","typeLabel":"object[] | null"},"departments":{"oneOf":[{"type":"array","items":{"type":"object","uniqueKey":"unit.departments.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"unit.departments.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object"},"uniqueKey":"unit.departments.oneOf.1","typeLabel":"null"}],"uniqueKey":"unit.departments","typeLabel":"object[] | null"},"parent":{"oneOf":[{"description":"Parent unit when loaded","type":"object","uniqueKey":"unit.parent.oneOf.0","typeLabel":"object"},{"description":"Parent unit when loaded","type":"null","uniqueKey":"unit.parent.oneOf.1","typeLabel":"null"}],"uniqueKey":"unit.parent","typeLabel":"object | null"},"image":{"oneOf":[{"description":"Unit image when loaded","type":"object","uniqueKey":"unit.image.oneOf.0","typeLabel":"object"},{"description":"Unit image when loaded","type":"null","uniqueKey":"unit.image.oneOf.1","typeLabel":"null"}],"uniqueKey":"unit.image","typeLabel":"object | null"},"children":{"oneOf":[{"type":"array","items":{"type":"object","uniqueKey":"unit.children.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"unit.children.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object"},"uniqueKey":"unit.children.oneOf.1","typeLabel":"null"}],"uniqueKey":"unit.children","typeLabel":"object[] | null"},"addresses":{"description":"Company, delivery, invoicing addresses","type":"object","uniqueKey":"unit.addresses","typeLabel":"object"},"contact":{"description":"Contact name and phone","type":"object","uniqueKey":"unit.contact","typeLabel":"object"},"opening_hours":{"description":"Office hours and closed days","type":"object","uniqueKey":"unit.opening_hours","typeLabel":"object"},"geo":{"properties":{"lat":{"oneOf":[{"type":"number","uniqueKey":"unit.geo.lat.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"unit.geo.lat.oneOf.1","typeLabel":"null"}],"uniqueKey":"unit.geo.lat","typeLabel":"number | null"},"lng":{"oneOf":[{"type":"number","uniqueKey":"unit.geo.lng.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"unit.geo.lng.oneOf.1","typeLabel":"null"}],"uniqueKey":"unit.geo.lng","typeLabel":"number | null"}},"type":"object","uniqueKey":"unit.geo","typeLabel":"object"},"stats":{"oneOf":[{"properties":{"users":{"type":"integer","uniqueKey":"unit.stats.oneOf.0.users","typeLabel":"integer"},"children":{"type":"integer","uniqueKey":"unit.stats.oneOf.0.children","typeLabel":"integer"},"children_total":{"type":"integer","uniqueKey":"unit.stats.oneOf.0.children_total","typeLabel":"integer"}},"type":"object","uniqueKey":"unit.stats.oneOf.0","typeLabel":"object"},{"properties":{"users":{"type":"integer"},"children":{"type":"integer"},"children_total":{"type":"integer"}},"type":"null","uniqueKey":"unit.stats.oneOf.1","typeLabel":"null"}],"uniqueKey":"unit.stats","typeLabel":"object | null"},"permissions":{"description":"Permission flags for current user","type":"object","uniqueKey":"unit.permissions","typeLabel":"object"},"url":{"type":"string","example":"api/units/1","uniqueKey":"unit.url","typeLabel":"string"}},"type":"object","uniqueKey":"unit","typeLabel":"object"},"department":{"oneOf":[{"description":"Department when loaded","type":"object","uniqueKey":"department.oneOf.0","typeLabel":"object"},{"description":"Department when loaded","type":"null","uniqueKey":"department.oneOf.1","typeLabel":"null"}],"uniqueKey":"department","typeLabel":"object | null"},"userTypes":{"description":"User types when loaded","type":"array","items":{"type":"object","uniqueKey":"userTypes.items.[INDEX]","typeLabel":"object"},"uniqueKey":"userTypes","typeLabel":"object[]"},"permissions":{"oneOf":[{"description":"Current user permission flags when includePermissions set","properties":{"edit":{"type":"boolean","uniqueKey":"permissions.oneOf.0.edit","typeLabel":"boolean"},"delete":{"type":"boolean","uniqueKey":"permissions.oneOf.0.delete","typeLabel":"boolean"}},"type":"object","uniqueKey":"permissions.oneOf.0","typeLabel":"object"},{"description":"Current user permission flags when includePermissions set","properties":{"edit":{"type":"boolean"},"delete":{"type":"boolean"}},"type":"null","uniqueKey":"permissions.oneOf.1","typeLabel":"null"}],"uniqueKey":"permissions","typeLabel":"object | null"},"integrationMemberships":{"description":"Integration memberships when loaded","type":"array","items":{"type":"object","uniqueKey":"integrationMemberships.items.[INDEX]","typeLabel":"object"},"uniqueKey":"integrationMemberships","typeLabel":"object[]"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":1,"abilities":{},"unit":{"content_type":"unit","id":1,"reference":"\u003cstring>","name":"HQ","description":"\u003cstring>","level":123,"path":"\u003cstring>","unit_type":"unit","falldown":true,"features":[{}],"departments":[{}],"parent":{},"image":{},"children":[{}],"addresses":{},"contact":{},"opening_hours":{},"geo":{"lat":123,"lng":123},"stats":{"users":123,"children":123,"children_total":123},"permissions":{},"url":"api/units/1"},"department":{},"userTypes":[{}],"permissions":{"edit":true,"delete":true},"integrationMemberships":[{}]}}},"exampleType":"generated"}},"exampleType":"generated"},"d4e56c2a-de9e-4a2a-8138-68c536c85987":{"description":"User not found","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"c4ce6673-38c4-4ec7-abb8-41b841fd29e2":{"description":"Validation error","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{},"servers":{}},"originalFileLocation":"openapi.yaml"},"subdomain":"ziik","siteName":"Ziik.io API docs","title":"Add unit membership - Ziik.io API docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-23T11:50:49.422Z","originalFileLocation":"api-reference/user-unit-memberships/add-unit-membership.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Creates or updates a unit membership for the user (unit, department, user types). Returns the membership and sets Location header.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ziik.io API docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ziik/CMTUSWplWQMfvgbI/_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/ziik/CMTUSWplWQMfvgbI/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ziik/CMTUSWplWQMfvgbI/_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/ziik/CMTUSWplWQMfvgbI/_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/ziik/CMTUSWplWQMfvgbI/_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/ziik/CMTUSWplWQMfvgbI/_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/ziik/CMTUSWplWQMfvgbI/_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/ziik/CMTUSWplWQMfvgbI/_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/ziik/CMTUSWplWQMfvgbI/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Add unit membership - Ziik.io API docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates or updates a unit membership for the user (unit, department, user types). Returns the membership and sets Location header.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ziik.io API docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ziik.io/api-reference/user-unit-memberships/add-unit-membership\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ziik.mintlify.site/_mintlify/api/og/v2?division=User+unit+memberships\u0026amp;title=Add+unit+membership\u0026amp;description=Creates+or+updates+a+unit+membership+for+the+user+%28unit%2C+department%2C+user+types%29.+Returns+the+membership+and+sets+Location+header.\u0026amp;theme=db0cf3b191eec410ae9bfc26\u0026amp;signature=91d3b6e36afe036dfa9ffc5170986bcfb1889c2fcfb367df914296e4f306e87f\">\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=\"Add unit membership - Ziik.io API docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates or updates a unit membership for the user (unit, department, user types). Returns the membership and sets Location header.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ziik.mintlify.site/_mintlify/api/og/v2?division=User+unit+memberships\u0026amp;title=Add+unit+membership\u0026amp;description=Creates+or+updates+a+unit+membership+for+the+user+%28unit%2C+department%2C+user+types%29.+Returns+the+membership+and+sets+Location+header.\u0026amp;theme=db0cf3b191eec410ae9bfc26\u0026amp;signature=91d3b6e36afe036dfa9ffc5170986bcfb1889c2fcfb367df914296e4f306e87f\">\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/ziik/CMTUSWplWQMfvgbI/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ziik.io API docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2a79ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ziik.io/api-reference/user-unit-memberships/add-unit-membership\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/user-unit-memberships/add-unit-membership.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ziik.io/#organization\",\"name\":\"Ziik.io API docs\",\"url\":\"https://docs.ziik.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ziik/XGBy0jppV3iL5Bou/logo/light.svg?fit=max\u0026auto=format\u0026n=XGBy0jppV3iL5Bou\u0026q=85\u0026s=e9ee9f29e1e2703be68c906ed13771f3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ziik.io#website\",\"name\":\"Ziik.io API docs\",\"url\":\"https://docs.ziik.io\",\"publisher\":{\"@id\":\"https://docs.ziik.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ziik.io/api-reference/user-unit-memberships/add-unit-membership#webpage\",\"url\":\"https://docs.ziik.io/api-reference/user-unit-memberships/add-unit-membership\",\"name\":\"Add unit membership\",\"description\":\"Creates or updates a unit membership for the user (unit, department, user types). Returns the membership and sets Location header.\",\"dateModified\":\"2026-03-23T11:50:49.422Z\",\"isPartOf\":{\"@id\":\"https://docs.ziik.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ziik.io/api-reference/user-unit-memberships/add-unit-membership#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ziik.io/api-reference/user-unit-memberships/add-unit-membership#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"User unit memberships\",\"item\":\"https://docs.ziik.io/api-reference/user-unit-memberships/list-user-unit-memberships\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Add unit membership\",\"item\":\"https://docs.ziik.io/api-reference/user-unit-memberships/add-unit-membership\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ziik.io/api-reference/user-unit-memberships/add-unit-membership#apireference\",\"headline\":\"Add unit membership\",\"name\":\"Add unit membership\",\"description\":\"Creates or updates a unit membership for the user (unit, department, user types). Returns the membership and sets Location header.\",\"url\":\"https://docs.ziik.io/api-reference/user-unit-memberships/add-unit-membership\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ziik.io/api-reference/user-unit-memberships/add-unit-membership#webpage\"},\"dateModified\":\"2026-03-23T11:50:49.422Z\",\"publisher\":{\"@id\":\"https://docs.ziik.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ziik.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ziik.io API docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ziik.io API docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/user-unit-memberships/add-unit-membership.md","siteName":"Ziik.io API docs","nav":{"global":{"anchors":[{"anchor":"Contact us","icon":"book-open-cover","href":"https://www.ziik.io/contact-us"},{"anchor":"Helpcenter","icon":"book-open-cover","href":"https://help.ziik.io/"},{"anchor":"Blog","icon":"newspaper","href":"https://www.ziik.io/blog"}]},"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":""}]},{"tab":"API Reference","groups":[{"group":"Auth","pages":[{"title":"Authenticate","deprecated":null,"version":null,"openapi":"/openapi.yaml post /authenticate","href":"/api-reference/auth/authenticate"},{"title":"Renew token","deprecated":null,"version":null,"openapi":"/openapi.yaml post /renew","href":"/api-reference/auth/renew-token"}]},{"group":"Posts","pages":[{"title":"Get multiple posts by ID","deprecated":null,"version":null,"openapi":"/openapi.yaml get /content/collection/{contentIDs}","href":"/api-reference/posts/get-multiple-posts-by-id"},{"title":"Get a post","deprecated":null,"version":null,"openapi":"/openapi.yaml get /content/{content}","href":"/api-reference/posts/get-a-post"},{"title":"Delete a post","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /content/{content}","href":"/api-reference/posts/delete-a-post"},{"title":"Update a post","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /content/{content}","href":"/api-reference/posts/update-a-post"},{"title":"Create a post","deprecated":null,"version":null,"openapi":"/openapi.yaml post /content","href":"/api-reference/posts/create-a-post"},{"title":"List post IDs by user","deprecated":null,"version":null,"openapi":"/openapi.yaml get /content/user/{user}/{type}","href":"/api-reference/posts/list-post-ids-by-user"},{"title":"List global post IDs","deprecated":null,"version":null,"openapi":"/openapi.yaml get /content/global/{type}/{sorting}","href":"/api-reference/posts/list-global-post-ids"},{"title":"List post IDs by group","deprecated":null,"version":null,"openapi":"/openapi.yaml get /content/group/{group}/{type}/{sorting}","href":"/api-reference/posts/list-post-ids-by-group"}]},{"group":"Counters","pages":[{"title":"Get counters","deprecated":null,"version":null,"openapi":"/openapi.yaml get /counters","href":"/api-reference/counters/get-counters"}]},{"group":"Groups","pages":[{"title":"List groups","deprecated":null,"version":null,"openapi":"/openapi.yaml get /groups","href":"/api-reference/groups/list-groups"},{"title":"Create a group","deprecated":null,"version":null,"openapi":"/openapi.yaml post /groups","href":"/api-reference/groups/create-a-group"},{"title":"Get a group","deprecated":null,"version":null,"openapi":"/openapi.yaml get /groups/{group}","href":"/api-reference/groups/get-a-group"},{"title":"Delete a group","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /groups/{group}","href":"/api-reference/groups/delete-a-group"},{"title":"Update a group","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /groups/{group}","href":"/api-reference/groups/update-a-group"},{"title":"Search groups","deprecated":null,"version":null,"openapi":"/openapi.yaml get /groups/search/{search}","href":"/api-reference/groups/search-groups"}]},{"group":"Languages","pages":[{"title":"List languages","deprecated":null,"version":null,"openapi":"/openapi.yaml get /settings/languages","href":"/api-reference/languages/list-languages"}]},{"group":"Timezones","pages":[{"title":"List timezones","deprecated":null,"version":null,"openapi":"/openapi.yaml get /settings/timezones","href":"/api-reference/timezones/list-timezones"}]},{"group":"Units","pages":[{"title":"List units","deprecated":null,"version":null,"openapi":"/openapi.yaml get /units","href":"/api-reference/units/list-units"},{"title":"Create unit","deprecated":null,"version":null,"openapi":"/openapi.yaml post /units","href":"/api-reference/units/create-unit"},{"title":"List basic units","deprecated":null,"version":null,"openapi":"/openapi.yaml get /units/basic","href":"/api-reference/units/list-basic-units"},{"title":"Get unit by ID","deprecated":null,"version":null,"openapi":"/openapi.yaml get /units/{unit}","href":"/api-reference/units/get-unit-by-id"},{"title":"Delete unit","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /units/{unit}","href":"/api-reference/units/delete-unit"},{"title":"Update unit","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /units/{unit}","href":"/api-reference/units/update-unit"},{"title":"Get unit by reference","deprecated":null,"version":null,"openapi":"/openapi.yaml get /units/reference/{unit}","href":"/api-reference/units/get-unit-by-reference"}]},{"group":"User unit memberships","pages":[{"title":"List user unit memberships","description":"Returns all unit memberships (unit, department, user types) for the given user.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /users/{user}/units","href":"/api-reference/user-unit-memberships/list-user-unit-memberships"},{"title":"Add unit membership","deprecated":null,"version":null,"openapi":"/openapi.yaml post /users/{user}/units","href":"/api-reference/user-unit-memberships/add-unit-membership"},{"title":"Remove unit membership","description":"Deletes a unit membership for the user. User must have at least one remaining membership.","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /users/{user}/units/{unit}","href":"/api-reference/user-unit-memberships/remove-unit-membership"},{"title":"Update unit membership","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /users/{user}/units/{unit}","href":"/api-reference/user-unit-memberships/update-unit-membership"}]},{"group":"Users","pages":[{"title":"Get users","deprecated":null,"version":null,"openapi":"/openapi.yaml get /users","href":"/api-reference/users/get-users"},{"title":"Post users","deprecated":null,"version":null,"openapi":"/openapi.yaml post /users","href":"/api-reference/users/post-users"},{"title":"Get user by ID","deprecated":null,"version":null,"openapi":"/openapi.yaml get /users/{userId}","href":"/api-reference/users/get-user-by-id"},{"title":"Get user by reference","deprecated":null,"version":null,"openapi":"/openapi.yaml get /users/reference/{reference}","href":"/api-reference/users/get-user-by-reference"},{"title":"Get collection of users by IDs","deprecated":null,"version":null,"openapi":"/openapi.yaml get /users/collection/{userIDs}","href":"/api-reference/users/get-collection-of-users-by-ids"},{"title":"Delete user","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /users/{user}","href":"/api-reference/users/delete-user"},{"title":"Update user","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /users/{user}","href":"/api-reference/users/update-user"},{"title":"Deactivate user","deprecated":null,"version":null,"openapi":"/openapi.yaml post /users/{user}/deactivate","href":"/api-reference/users/deactivate-user"},{"title":"Reactivate user","deprecated":null,"version":null,"openapi":"/openapi.yaml post /users/{user}/reactivate","href":"/api-reference/users/reactivate-user"},{"title":"User birthdays","deprecated":null,"version":null,"openapi":"/openapi.yaml get /users/birthdays","href":"/api-reference/users/user-birthdays"}]},{"group":"User types","pages":[{"title":"List user types","deprecated":null,"version":null,"openapi":"/openapi.yaml get /usertypes","href":"/api-reference/user-types/list-user-types"},{"title":"Create user type","deprecated":null,"version":null,"openapi":"/openapi.yaml post /usertypes","href":"/api-reference/user-types/create-user-type"},{"title":"List basic user types","deprecated":null,"version":null,"openapi":"/openapi.yaml get /usertypes/basic","href":"/api-reference/user-types/list-basic-user-types"},{"title":"Get user type","deprecated":null,"version":null,"openapi":"/openapi.yaml get /usertypes/{userType}","href":"/api-reference/user-types/get-user-type"},{"title":"Delete user type","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /usertypes/{userType}","href":"/api-reference/user-types/delete-user-type"},{"title":"Update user type","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /usertypes/{userType}","href":"/api-reference/user-types/update-user-type"}]},{"group":"Conversations","pages":[{"title":"List conversations","deprecated":null,"version":null,"openapi":"/openapi.yaml get /conversations","href":"/api-reference/conversations/list-conversations"},{"title":"Create conversation with first message","deprecated":null,"version":null,"openapi":"/openapi.yaml post /conversations","href":"/api-reference/conversations/create-conversation-with-first-message"},{"title":"Get a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml get /conversations/{conversation}","href":"/api-reference/conversations/get-a-conversation"},{"title":"Delete a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /conversations/{conversation}","href":"/api-reference/conversations/delete-a-conversation"},{"title":"Update a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /conversations/{conversation}","href":"/api-reference/conversations/update-a-conversation"},{"title":"Create a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /conversations/create","href":"/api-reference/conversations/create-a-conversation"},{"title":"Archive a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /conversations/{conversation}/archive","href":"/api-reference/conversations/archive-a-conversation"},{"title":"Unarchive a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /conversations/{conversation}/unarchive","href":"/api-reference/conversations/unarchive-a-conversation"},{"title":"List messages in a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml get /conversations/{conversation}/messages","href":"/api-reference/conversations/list-messages-in-a-conversation"},{"title":"Create a new message in a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /conversations/{conversation}/messages","href":"/api-reference/conversations/create-a-new-message-in-a-conversation"},{"title":"Get a single message in a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml get /conversations/{conversation}/messages/{message}","href":"/api-reference/conversations/get-a-single-message-in-a-conversation"},{"title":"Delete a message in a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /conversations/{conversation}/messages/{message}","href":"/api-reference/conversations/delete-a-message-in-a-conversation"},{"title":"Update a message in a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /conversations/{conversation}/messages/{message}","href":"/api-reference/conversations/update-a-message-in-a-conversation"},{"title":"Finalize message update","deprecated":null,"version":null,"openapi":"/openapi.yaml post /conversations/{conversation}/messages/{message}/finalize-update","href":"/api-reference/conversations/finalize-message-update"}]}]}]},"basePath":"","title":"Add unit membership - Ziik.io API docs","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"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","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.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"]}