API authentication using your community API secret. The value below is sent as the Authorization header verbatim, so paste the whole header value including the prefix: Token token=
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Zapnito Developer Docs","description":"Zapnito developer documentation. Integrate expert knowledge communities using the API, webhooks and MCP server, with guides, references and examples.","colors":{"primary":"#A28BFE","light":"#A28BFE","dark":"#A28BFE"},"logo":{"light":"https://mintcdn.com/zapnito-3f02a250/tVIYGk7DEJxtk1do/images/Zapnito-Horizontal-Gray.png?fit=max\u0026auto=format\u0026n=tVIYGk7DEJxtk1do\u0026q=85\u0026s=ff03ba675b6fd54f1e518b37e67dba4c","dark":"https://mintcdn.com/zapnito-3f02a250/tVIYGk7DEJxtk1do/images/Zapnito-Horizontal-White.png?fit=max\u0026auto=format\u0026n=tVIYGk7DEJxtk1do\u0026q=85\u0026s=bf0f9160c98cf86c277a6028e5e7ddd0"},"favicon":{"light":"https://mintcdn.com/zapnito-3f02a250/3A3P17JjWbqJP6iZ/images/favicon.svg?fit=max\u0026auto=format\u0026n=3A3P17JjWbqJP6iZ\u0026q=85\u0026s=c421cde1e0bc51e19e3d77c9512b1ad7","dark":"https://mintcdn.com/zapnito-3f02a250/3A3P17JjWbqJP6iZ/images/favicon.svg?fit=max\u0026auto=format\u0026n=3A3P17JjWbqJP6iZ\u0026q=85\u0026s=c421cde1e0bc51e19e3d77c9512b1ad7"},"api":{"playground":{"display":"interactive"}},"appearance":{"default":"dark","strict":false},"background":{"color":{"dark":"#18181B"}},"navbar":{"links":[{"href":"https://knowledge.zapnito.com","label":"Community"}],"primary":{"type":"button","label":"Get a Demo","href":"https://zapnito.com/demo"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/zapnito"}},"seo":{"metatags":{"og:site_name":"Zapnito Docs"},"organization":{"name":"Zapnito","url":"https://zapnito.com","sameAs":["https://linkedin.com/company/zapnito"]},"indexing":"all"},"fonts":{"heading":{"family":"Inter"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"dark","fonts":{"family":"Inter"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"zapnito-3f02a250","hasAudioNarration":false,"actualSubdomain":"zapnito-3f02a250","customDomains":["docs.zapnito.com"],"gitSource":{"type":"github","owner":"zapnito","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ada8b7c0187b2d0736a5161","collectionId":"9c23d7b9-53ab-4e75-a3bc-9e3365b5d87e","liveDeploymentHistoryId":"6ada8b7c0187b2d0736a5161","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ae20daa8ffbca586928b31e","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"API","count":61},{"language":"default","tag":"V1 API","count":56},{"language":"default","tag":"Webhooks","count":15},{"language":"default","tag":"Getting started","count":10},{"language":"default","tag":"Users","count":10},{"language":"default","tag":"Badges","count":8},{"language":"default","tag":"Groups","count":6},{"language":"default","tag":"Organisations","count":6},{"language":"default","tag":"Third-Party Resources","count":6},{"language":"default","tag":"Docs","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":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":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api/v1/tags/create-a-tag","slug":"/api/v1/tags/create-a-tag","pageMetadata":{"title":"Create a tag","description":"Creates a tag in the community, optionally as a child of an existing parent tag. Requires tags to be enabled for the community","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json post /api/v1/tags","href":"/api/v1/tags/create-a-tag","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Creates a tag in the community, optionally as a child of an existing parent tag. Requires tags to be enabled for the community\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a tag","description":"Creates a tag in the community, optionally as a child of an existing parent tag. Requires tags to be enabled for the community","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json post /api/v1/tags","href":"/api/v1/tags/create-a-tag","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create a tag","tags":["Tags"],"operationId":"createTag","description":"Creates a tag in the community, optionally as a child of an existing parent tag. Requires tags to be enabled for the community","security":["bb73a736-188e-470a-9200-20fa79f0dcb8"],"parameters":[],"responses":{"201":"4177c197-40fe-4c9d-862b-38501e6a9593","401":"71b8395a-71e8-4828-8f4b-a31189ad9d3f","405":"6c0ab779-d5a9-498a-90ae-bd02a187f4f5","422":"42a415bb-fa97-44a5-97d7-37a29438e7b0"},"requestBody":"bfffbd70-0118-4204-a5ee-1819aa5e9fa9","method":"post","type":"path","servers":["e1d66cab-603f-4bd4-942c-85bf8a80649b"],"path":"/api/v1/tags","baseUrlOptions":["https://{host}"],"title":"Create a tag","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tag":{"type":"object","properties":{"name":{"type":"string","example":"IBM","isRequired":true,"uniqueKey":"tag.name","typeLabel":"string"},"external_url":{"type":"string","example":"https://www.ibm.com","uniqueKey":"tag.external_url","typeLabel":"string"},"external_id":{"type":"string","example":"1234","uniqueKey":"tag.external_id","typeLabel":"string"},"parent_name":{"type":"string","example":"Companies","description":"Name of an existing tag to create this tag under (case-insensitive). The request is rejected if no tag has this name. Leave blank for a top-level tag","uniqueKey":"tag.parent_name","typeLabel":"string"}},"required":["name"],"isRequired":true,"uniqueKey":"tag","typeLabel":"object"}},"required":["tag"],"uniqueKey":"","typeLabel":"object"},"examples":{"new_tag":{"title":"new_tag","value":{"tag":{"name":"IBM"}}}},"exampleType":"examples"}},"required":true,"description":"Tag payload wrapped in a tag object","exampleType":"examples"},"responses":{"4177c197-40fe-4c9d-862b-38501e6a9593":{"description":"The tag was created","content":{"application/json":{"examples":{"example":{"title":"example","value":{"tag":{"name":"IBM","external_url":"https://www.ibm.com","external_id":"123","parent_name":"Companies","content_urls":["https://example.com/posts/how-we-improved-onboarding"]}}}},"schema":{"type":"object","properties":{"tag":{"type":"object","properties":{"name":{"type":"string","example":"IBM","isRequired":true,"uniqueKey":"tag.name","typeLabel":"string"},"content_urls":{"type":"array","items":{"type":"string","uniqueKey":"tag.content_urls.items.[INDEX]","typeLabel":"string"},"example":["https://example.com/posts/how-we-improved-onboarding"],"isRequired":true,"uniqueKey":"tag.content_urls","typeLabel":"string[]"},"external_url":{"oneOf":[{"type":"string","example":"https://www.ibm.com","uniqueKey":"tag.external_url.oneOf.0","typeLabel":"string"},{"type":"null","example":"https://www.ibm.com","uniqueKey":"tag.external_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"tag.external_url","typeLabel":"string | null"},"external_id":{"oneOf":[{"type":"string","example":"123","uniqueKey":"tag.external_id.oneOf.0","typeLabel":"string"},{"type":"null","example":"123","uniqueKey":"tag.external_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"tag.external_id","typeLabel":"string | null"},"parent_name":{"oneOf":[{"type":"string","example":"Companies","description":"Name of the parent tag. Null for a top-level tag","uniqueKey":"tag.parent_name.oneOf.0","typeLabel":"string"},{"type":"null","example":"Companies","description":"Name of the parent tag. Null for a top-level tag","uniqueKey":"tag.parent_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"tag.parent_name","typeLabel":"string | null"}},"required":["name","content_urls"],"isRequired":true,"uniqueKey":"tag","typeLabel":"object"}},"required":["tag"],"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"71b8395a-71e8-4828-8f4b-a31189ad9d3f":{"description":"The API key is missing or invalid. The response body is the text `HTTP Token: Access denied.`","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"6c0ab779-d5a9-498a-90ae-bd02a187f4f5":{"description":"Tags are not enabled for the community","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"string","uniqueKey":"errors.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"errors","typeLabel":"string[]"}},"required":["errors"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"42a415bb-fa97-44a5-97d7-37a29438e7b0":{"description":"The request failed validation","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"errors.oneOf.0","typeLabel":"string[]"},{"type":"object","properties":{"name":{"type":"array","items":{"type":"string","uniqueKey":"errors.oneOf.1.name.items.[INDEX]","typeLabel":"string"},"example":["has already been taken"],"uniqueKey":"errors.oneOf.1.name","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"errors.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"errors","typeLabel":"string[] | object"}},"required":["errors"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"bb73a736-188e-470a-9200-20fa79f0dcb8":{"tokenAuth":{"type":"apiKey","name":"Authorization","in":"header","description":"API authentication using your community API secret. The value below is sent as the Authorization header verbatim, so paste the whole header value including the prefix: Token token=\u003capi-key>","x-default":"Token token=\u003capi-key>","scopes":[],"schemeName":"tokenAuth"}}},"servers":{"e1d66cab-603f-4bd4-942c-85bf8a80649b":{"url":"https://{host}","description":"Your community domain","variables":{"host":{"default":"your-community.com","description":"Your community domain, for example your-community.com"}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","name":"Authorization","in":"header","description":"API authentication using your community API secret. The value below is sent as the Authorization header verbatim, so paste the whole header value including the prefix: Token token=\u003capi-key>","x-default":"Token token=\u003capi-key>","scopes":[],"schemeName":"tokenAuth"},"schema":{"title":"Authorization","type":"string","description":"API authentication using your community API secret. The value below is sent as the Authorization header verbatim, so paste the whole header value including the prefix: Token token=\u003capi-key>","isRequired":true,"default":"Token token=\u003capi-key>","typeLabel":"string","deprecated":false},"schemeName":"tokenAuth","name":"Authorization"}],"title":"tokenAuth"}]},"originalFileLocation":"https://api.zapnito.com/api/docs/v1/swagger.json"},"subdomain":"zapnito-3f02a250","siteName":"Zapnito Developer Docs","title":"Create a tag - Zapnito Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T14:58:55.700Z","originalFileLocation":"api/v1/tags/create-a-tag.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=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Creates a tag in the community, optionally as a child of an existing parent tag. Requires tags to be enabled for the community\">\u003cmeta data-mint-head name=\"application-name\" content=\"Zapnito Developer 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/zapnito-3f02a250/wgbbMe5r6eLuLS5J/_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/zapnito-3f02a250/wgbbMe5r6eLuLS5J/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/zapnito-3f02a250/wgbbMe5r6eLuLS5J/_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/zapnito-3f02a250/wgbbMe5r6eLuLS5J/_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/zapnito-3f02a250/wgbbMe5r6eLuLS5J/_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/zapnito-3f02a250/wgbbMe5r6eLuLS5J/_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/zapnito-3f02a250/wgbbMe5r6eLuLS5J/_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/zapnito-3f02a250/wgbbMe5r6eLuLS5J/_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/zapnito-3f02a250/wgbbMe5r6eLuLS5J/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a tag - Zapnito Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a tag in the community, optionally as a child of an existing parent tag. Requires tags to be enabled for the community\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Zapnito Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.zapnito.com/api/v1/tags/create-a-tag\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://zapnito-3f02a250.mintlify.app/_mintlify/api/og/v2?division=Tags\u0026amp;title=Create+a+tag\u0026amp;description=Creates+a+tag+in+the+community%2C+optionally+as+a+child+of+an+existing+parent+tag.+Requires+tags+to+be+enabled+for+the+community\u0026amp;theme=6fa956a31e3605b39bec0ece\u0026amp;signature=d64ccd6c47bee1e7e871b0e523bb2565e3940fb55a3ea59726662d6716c0ed11\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a tag - Zapnito Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a tag in the community, optionally as a child of an existing parent tag. Requires tags to be enabled for the community\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://zapnito-3f02a250.mintlify.app/_mintlify/api/og/v2?division=Tags\u0026amp;title=Create+a+tag\u0026amp;description=Creates+a+tag+in+the+community%2C+optionally+as+a+child+of+an+existing+parent+tag.+Requires+tags+to+be+enabled+for+the+community\u0026amp;theme=6fa956a31e3605b39bec0ece\u0026amp;signature=d64ccd6c47bee1e7e871b0e523bb2565e3940fb55a3ea59726662d6716c0ed11\">\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/zapnito-3f02a250/wgbbMe5r6eLuLS5J/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Zapnito Developer Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#A28BFE\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.zapnito.com/api/v1/tags/create-a-tag\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/v1/tags/create-a-tag.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://zapnito.com/#organization\",\"name\":\"Zapnito\",\"url\":\"https://zapnito.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/zapnito-3f02a250/tVIYGk7DEJxtk1do/images/Zapnito-Horizontal-Gray.png?fit=max\u0026auto=format\u0026n=tVIYGk7DEJxtk1do\u0026q=85\u0026s=ff03ba675b6fd54f1e518b37e67dba4c\"},\"sameAs\":[\"https://linkedin.com/company/zapnito\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.zapnito.com#website\",\"name\":\"Zapnito Developer Docs\",\"url\":\"https://docs.zapnito.com\",\"publisher\":{\"@id\":\"https://zapnito.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.zapnito.com/api/v1/tags/create-a-tag#webpage\",\"url\":\"https://docs.zapnito.com/api/v1/tags/create-a-tag\",\"name\":\"Create a tag\",\"description\":\"Creates a tag in the community, optionally as a child of an existing parent tag. Requires tags to be enabled for the community\",\"dateModified\":\"2026-10-28T14:58:55.700Z\",\"isPartOf\":{\"@id\":\"https://docs.zapnito.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.zapnito.com/api/v1/tags/create-a-tag#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.zapnito.com/api/v1/tags/create-a-tag#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"V1 API\",\"item\":\"https://docs.zapnito.com/api/v1/badges/list-badges\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tags\",\"item\":\"https://docs.zapnito.com/api/v1/tags/list-tags\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create a tag\",\"item\":\"https://docs.zapnito.com/api/v1/tags/create-a-tag\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.zapnito.com/api/v1/tags/create-a-tag#apireference\",\"headline\":\"Create a tag\",\"name\":\"Create a tag\",\"description\":\"Creates a tag in the community, optionally as a child of an existing parent tag. Requires tags to be enabled for the community\",\"url\":\"https://docs.zapnito.com/api/v1/tags/create-a-tag\",\"mainEntityOfPage\":{\"@id\":\"https://docs.zapnito.com/api/v1/tags/create-a-tag#webpage\"},\"dateModified\":\"2026-10-28T14:58:55.700Z\",\"publisher\":{\"@id\":\"https://zapnito.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.zapnito.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Zapnito Developer Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Zapnito Developer Docs","nav":{"global":null,"tabs":[{"tab":"Docs","icon":"book-open","pages":[{"title":"Docs","href":""}]},{"tab":"API","icon":"code","groups":[{"group":"Getting started","pages":[{"title":"Zapnito API overview","sidebarTitle":"API overview","href":"/api/v1/overview"},{"title":"API authentication and headers","sidebarTitle":"Authentication","href":"/api/v1/authentication"},{"title":"Validate your API key","href":"/api/v1/ping"},{"title":"API pagination","sidebarTitle":"Pagination","href":"/api/v1/pagination"},{"title":"API responses and errors","sidebarTitle":"Responses and errors","href":"/api/v1/errors"}]},{"group":"V1 API","icon":"gear","pages":[{"group":"Badges","pages":[{"title":"List badges","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/badges","href":"/api/v1/badges/list-badges"},{"title":"Create a badge","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json post /api/v1/badges","href":"/api/v1/badges/create-a-badge"},{"title":"Get a badge","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/badges/{id}","href":"/api/v1/badges/get-a-badge"},{"title":"Update a badge","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json put /api/v1/badges/{id}","href":"/api/v1/badges/update-a-badge"},{"title":"Delete a badge","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json delete /api/v1/badges/{id}","href":"/api/v1/badges/delete-a-badge"},{"title":"Update a badge (PATCH)","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json patch /api/v1/badges/{id}","href":"/api/v1/badges/update-a-badge-patch"},{"title":"Assign a badge","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json post /api/v1/badges/{badge_id}/assign","href":"/api/v1/badges/assign-a-badge"},{"title":"Unassign a badge","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json delete /api/v1/badges/{badge_id}/unassign","href":"/api/v1/badges/unassign-a-badge"}]},{"group":"Channels","pages":[{"title":"List channel contents","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/channels/{channel_id}/contents","href":"/api/v1/channels/list-channel-contents"},{"title":"List channels","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/channels","href":"/api/v1/channels/list-channels"}]},{"group":"Contents","pages":[{"title":"List contents","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/contents","href":"/api/v1/contents/list-contents"},{"title":"Get a piece of content","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/contents/{id}","href":"/api/v1/contents/get-a-piece-of-content"},{"title":"Publish a piece of content","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json post /api/v1/contents/{id}/publish","href":"/api/v1/contents/publish-a-piece-of-content"},{"title":"Schedule a piece of content","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json post /api/v1/contents/{id}/schedule","href":"/api/v1/contents/schedule-a-piece-of-content"},{"title":"Unpublish a piece of content","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json post /api/v1/contents/{id}/unpublish","href":"/api/v1/contents/unpublish-a-piece-of-content"}]},{"group":"Custom Fields","pages":[{"title":"List custom fields","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/custom_fields","href":"/api/v1/custom-fields/list-custom-fields"}]},{"group":"Groups","pages":[{"title":"List group users","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/groups/{uuid}/users","href":"/api/v1/groups/list-group-users"},{"title":"Add a user to a group","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json post /api/v1/groups/{uuid}/users","href":"/api/v1/groups/add-a-user-to-a-group"},{"title":"Remove a user from a group","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json delete /api/v1/groups/{uuid}/users","href":"/api/v1/groups/remove-a-user-from-a-group"},{"title":"Create a group","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json post /api/v1/groups","href":"/api/v1/groups/create-a-group"}]},{"group":"Identity","pages":[{"title":"Get the community identity","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/identity","href":"/api/v1/identity/get-the-community-identity"}]},{"group":"Invitations","pages":[{"title":"Invite a user","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json post /api/v1/invitations","href":"/api/v1/invitations/invite-a-user"}]},{"group":"Organisations","pages":[{"title":"Add a user to an organisation","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json post /api/v1/organisations/{organisation_id}/users","href":"/api/v1/organisations/add-a-user-to-an-organisation"},{"title":"Remove a user from an organisation","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json delete /api/v1/organisations/{organisation_id}/users","href":"/api/v1/organisations/remove-a-user-from-an-organisation"},{"title":"List organisations","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/organisations","href":"/api/v1/organisations/list-organisations"},{"title":"Create an organisation","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json post /api/v1/organisations","href":"/api/v1/organisations/create-an-organisation"},{"title":"Update an organisation","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json put /api/v1/organisations/{id}","href":"/api/v1/organisations/update-an-organisation"},{"title":"Update an organisation (PATCH)","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json patch /api/v1/organisations/{id}","href":"/api/v1/organisations/update-an-organisation-patch"}]},{"group":"Health Check","pages":[{"title":"Check the API key","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/ping","href":"/api/v1/health-check/check-the-api-key"}]},{"group":"Posts","pages":[{"title":"List posts","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/posts","href":"/api/v1/posts/list-posts"},{"title":"Create a post","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json post /api/v1/posts","href":"/api/v1/posts/create-a-post"},{"title":"Get a post","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/posts/{id}","href":"/api/v1/posts/get-a-post"},{"title":"Update a post","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json put /api/v1/posts/{id}","href":"/api/v1/posts/update-a-post"},{"title":"Update a post (PATCH)","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json patch /api/v1/posts/{id}","href":"/api/v1/posts/update-a-post-patch"}]},{"group":"Rest Hooks","pages":[{"title":"Subscribe to a rest hook","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json post /api/v1/rest_hooks/{key}/subscriptions","href":"/api/v1/rest-hooks/subscribe-to-a-rest-hook"},{"title":"Unsubscribe from a rest hook","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json delete /api/v1/rest_hooks/{key}/subscriptions/{id}","href":"/api/v1/rest-hooks/unsubscribe-from-a-rest-hook"},{"title":"Get a sample rest hook payload","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/rest_hooks/{key}/sample","href":"/api/v1/rest-hooks/get-a-sample-rest-hook-payload"}]},{"group":"Rooms","pages":[{"title":"List rooms","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/rooms","href":"/api/v1/rooms/list-rooms"},{"title":"Create a room","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json post /api/v1/rooms","href":"/api/v1/rooms/create-a-room"},{"title":"Get a room","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/rooms/{id}","href":"/api/v1/rooms/get-a-room"}]},{"group":"Tags","pages":[{"title":"List tags","description":"Returns all tags in the community, ordered by position, optionally limited to the children of a parent tag. Requires tags to be enabled for the community","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/tags","href":"/api/v1/tags/list-tags"},{"title":"Create a tag","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json post /api/v1/tags","href":"/api/v1/tags/create-a-tag"},{"title":"Tag content","description":"Applies an existing tag to one or more items of content. Content is identified by its URL, its slug, or both. Identifiers that match no content are ignored, as long as at least one matches. The tag is matched by name (case-insensitive)","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json put /api/v1/tags/contents","href":"/api/v1/tags/tag-content"}]},{"group":"Third-Party Resources","pages":[{"title":"List third-party resources","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/third_party_resources","href":"/api/v1/third-party-resources/list-third-party-resources"},{"title":"Create a third-party resource","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json post /api/v1/third_party_resources","href":"/api/v1/third-party-resources/create-a-third-party-resource"},{"title":"Get a third-party resource","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/third_party_resources/{id}","href":"/api/v1/third-party-resources/get-a-third-party-resource"},{"title":"Update a third-party resource","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json put /api/v1/third_party_resources/{id}","href":"/api/v1/third-party-resources/update-a-third-party-resource"},{"title":"Delete a third-party resource","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json delete /api/v1/third_party_resources/{id}","href":"/api/v1/third-party-resources/delete-a-third-party-resource"},{"title":"Update a third-party resource (PATCH)","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json patch /api/v1/third_party_resources/{id}","href":"/api/v1/third-party-resources/update-a-third-party-resource-patch"}]},{"group":"Users","pages":[{"title":"Update a notification preference","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json put /api/v1/users/{user_email}/notification_preferences","href":"/api/v1/users/update-a-notification-preference"},{"title":"Update a notification preference (PATCH)","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json patch /api/v1/users/{user_email}/notification_preferences","href":"/api/v1/users/update-a-notification-preference-patch"},{"title":"List users","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/users","href":"/api/v1/users/list-users"},{"title":"Update a user (deprecated)","deprecated":true,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json put /api/v1/users","href":"/api/v1/users/update-a-user-deprecated"},{"title":"Get a user","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/users/{email}","href":"/api/v1/users/get-a-user"},{"title":"Update a user","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json put /api/v1/users/{email}","href":"/api/v1/users/update-a-user"},{"title":"Update a user (PATCH)","deprecated":null,"version":null,"openapi":"https://api.zapnito.com/api/docs/v1/swagger.json patch /api/v1/users/{email}","href":"/api/v1/users/update-a-user-patch"}]}]}]},{"tab":"Webhooks","icon":"cloud","pages":[{"title":"Webhooks","href":"/webhooks/overview"}]}]},"title":"Create a tag - Zapnito Developer Docs","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}