{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OnlySocial API","description":"APIs, webhooks, the MCP server and the Partner API for OnlySocial.","colors":{"primary":"#3B82F6","light":"#60A5FA","dark":"#1D4ED8"},"logo":{"light":"https://mintcdn.com/onlysocial/LJSprGB5_BPvOyDE/logo/onlysocial.png?fit=max\u0026auto=format\u0026n=LJSprGB5_BPvOyDE\u0026q=85\u0026s=f11759a50722ae8548a860bed9c1d8ee","dark":"https://mintcdn.com/onlysocial/LJSprGB5_BPvOyDE/logo/onlysocial.png?fit=max\u0026auto=format\u0026n=LJSprGB5_BPvOyDE\u0026q=85\u0026s=f11759a50722ae8548a860bed9c1d8ee","href":"https://onlysocial.io"},"favicon":"https://mintcdn.com/onlysocial/LJSprGB5_BPvOyDE/favicon.png?fit=max\u0026auto=format\u0026n=LJSprGB5_BPvOyDE\u0026q=85\u0026s=0792889c34deb2cb2fd16f1a9d80f2bb","api":{"playground":{"display":"interactive"}},"navbar":{"links":[{"href":"https://help.onlysocial.io","label":"Help centre"}],"primary":{"type":"button","label":"Open OnlySocial","href":"https://app.onlysocial.io"}},"footer":{"socials":{"website":"https://onlysocial.io"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"onlysocial","hasAudioNarration":false,"actualSubdomain":"onlysocial","customDomains":[],"gitSource":{"type":"github","owner":"ytm2014","repo":"onlysocial-doc","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6ae53ba728ef3858e045345f"},"chroma":{"latestBuiltDeploymentHistoryId":"6ae54c4795df02a8afc3cedf","collectionId":"92312e7a-dd33-41ff-b4b4-a88eea0aed63","liveDeploymentHistoryId":"6ae54c4795df02a8afc3cedf","schemaVersion":"v3"},"entitlements":{},"buildId":"6ae54c4795df02a8afc3cedf","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"Messaging API","count":50},{"language":"default","tag":"Link in Bio API","count":42},{"language":"default","tag":"Reference","count":41},{"language":"default","tag":"Publishing API","count":29},{"language":"default","tag":"Partner API","count":19},{"language":"default","tag":"Media","count":15},{"language":"default","tag":"Endpoints","count":14},{"language":"default","tag":"Guides","count":10},{"language":"default","tag":"Contacts","count":10},{"language":"default","tag":"Conversations \u0026 Messages","count":10}]},"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":"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":"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":"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":"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":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"biolinks/short-links/create-a-short-link","slug":"/biolinks/short-links/create-a-short-link","pageMetadata":{"title":"Create a short link","description":"New links are created **paused**.\n\n**Required permission:** `biolinks:links:write`","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json post /links","href":"/biolinks/short-links/create-a-short-link","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"New links are created \", _jsx(_components.strong, {\n children: \"paused\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Required permission:\"\n }), \" \", _jsx(_components.code, {\n children: \"biolinks:links:write\"\n })]\n })]\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 short link","description":"New links are created **paused**.\n\n**Required permission:** `biolinks:links:write`","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json post /links","href":"/biolinks/short-links/create-a-short-link","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Short links"],"summary":"Create a short link","operationId":"links.store","description":"New links are created **paused**.\n\n**Required permission:** `biolinks:links:write`","parameters":["dc2e8d73-12eb-44eb-9293-2ddcac9f89ed"],"requestBody":"1446964e-2b60-4bb0-97a4-838ff99f24df","responses":{"201":"0ebc8296-2713-4cfe-8475-52040a373b8c"},"method":"post","type":"path","servers":["7435bc82-777c-43c8-b513-558dd92f8ecc"],"security":["eae57f5a-eca3-4b8d-a984-02c42246860e","dad7470d-c1e7-479a-99b6-ecd626b350e3"],"path":"/links","baseUrlOptions":["https://app.onlysocial.io/api/v1/biolinks"],"title":"Create a short link","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"dc2e8d73-12eb-44eb-9293-2ddcac9f89ed":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":200,"isRequired":true,"description":"8–200 letters, digits, `.`, `_`, `:` or `-`. Retry with the same key and exact same body to get the original response.","uniqueKey":"","typeLabel":"string"},"description":"8–200 letters, digits, `.`, `_`, `:` or `-`. Retry with the same key and exact same body to get the original response."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["destination"],"properties":{"destination":{"type":"string","maxLength":2048,"example":"https://example.com/autumn-sale","description":"An `http`, `https`, `mailto` or `tel` URL.","isRequired":true,"uniqueKey":"destination","typeLabel":"string"},"title":{"oneOf":[{"type":"string","maxLength":120,"uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":120,"uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"slug":{"oneOf":[{"type":"string","maxLength":60,"example":"sale","uniqueKey":"slug.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":60,"example":"sale","uniqueKey":"slug.oneOf.1","typeLabel":"null"}],"uniqueKey":"slug","typeLabel":"string | null"},"domain":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"domain.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"domain","typeLabel":"string\u003cuuid> | null"},"settings":{"type":"object","properties":{"password":{"type":"string","maxLength":100,"description":"Write-only. Never returned.","uniqueKey":"settings.password","typeLabel":"string"},"clear_password":{"type":"boolean","uniqueKey":"settings.clear_password","typeLabel":"boolean"},"forward_query":{"type":"boolean","description":"Pass the visitor's query string on to the destination.","uniqueKey":"settings.forward_query","typeLabel":"boolean"},"http_status":{"type":"integer","enum":[301,302,303,307,308],"default":302,"uniqueKey":"settings.http_status","typeLabel":"enum\u003cinteger>"},"sensitive_content":{"type":"boolean","uniqueKey":"settings.sensitive_content","typeLabel":"boolean"},"utm":{"type":"object","properties":{"source":{"type":"string","maxLength":80,"uniqueKey":"settings.utm.source","typeLabel":"string"},"medium":{"type":"string","maxLength":80,"uniqueKey":"settings.utm.medium","typeLabel":"string"},"campaign":{"type":"string","maxLength":80,"uniqueKey":"settings.utm.campaign","typeLabel":"string"}},"uniqueKey":"settings.utm","typeLabel":"object"},"pixels":{"type":"array","maxItems":100,"items":{"type":"string","format":"uuid","uniqueKey":"settings.pixels.items.[INDEX]","typeLabel":"string\u003cuuid>"},"description":"Pixel IDs from this workspace. Replaces the current selection.","uniqueKey":"settings.pixels","typeLabel":"string\u003cuuid>[]"}},"uniqueKey":"settings","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"destination":"https://example.com/autumn-sale","title":"\u003cstring>","slug":"sale","domain":"3c90c3cc-0d44-4b50-8888-8dd25736052a","settings":{"password":"\u003cstring>","clear_password":true,"forward_query":true,"http_status":302,"sensitive_content":true,"utm":{"source":"\u003cstring>","medium":"\u003cstring>","campaign":"\u003cstring>"},"pixels":["3c90c3cc-0d44-4b50-8888-8dd25736052a"]}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"0ebc8296-2713-4cfe-8475-52040a373b8c":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"revision":{"type":"string","uniqueKey":"data.revision","typeLabel":"string"},"id":{"type":"string","format":"uuid","uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"slug":{"type":"string","uniqueKey":"data.slug","typeLabel":"string"},"domain":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"data.domain.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"data.domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.domain","typeLabel":"string\u003cuuid> | null"},"public_url":{"type":"string","uniqueKey":"data.public_url","typeLabel":"string"},"title":{"oneOf":[{"type":"string","uniqueKey":"data.title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.title.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.title","typeLabel":"string | null"},"destination":{"type":"string","uniqueKey":"data.destination","typeLabel":"string"},"status":{"type":"string","enum":["active","paused"],"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"disabled":{"type":"boolean","uniqueKey":"data.disabled","typeLabel":"boolean"},"has_password":{"type":"boolean","uniqueKey":"data.has_password","typeLabel":"boolean"},"settings":{"type":"object","description":"`utm`, `forward_query`, `http_status`, `sensitive_content`.","uniqueKey":"data.settings","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"revision":"\u003cstring>","id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","slug":"\u003cstring>","domain":"3c90c3cc-0d44-4b50-8888-8dd25736052a","public_url":"\u003cstring>","title":"\u003cstring>","destination":"\u003cstring>","status":"active","disabled":true,"has_password":true,"settings":{},"created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"eae57f5a-eca3-4b8d-a984-02c42246860e":{"bearerAuth":{"type":"http","scheme":"bearer","description":"A workspace API key: `Authorization: Bearer osk_...`","scopes":[],"schemeName":"bearerAuth"}},"dad7470d-c1e7-479a-99b6-ecd626b350e3":{"apiKeyHeader":{"type":"apiKey","in":"header","name":"x-api-key","description":"The same workspace API key in the `x-api-key` header.","scopes":[],"schemeName":"apiKeyHeader"}}},"servers":{"7435bc82-777c-43c8-b513-558dd92f8ecc":{"url":"https://app.onlysocial.io/api/v1/biolinks","description":"OnlySocial"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"A workspace API key: `Authorization: Bearer osk_...`","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A workspace API key: `Authorization: Bearer osk_...`","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"The same workspace API key in the `x-api-key` header.","scopes":[],"schemeName":"apiKeyHeader"},"schema":{"title":"x-api-key","type":"string","description":"The same workspace API key in the `x-api-key` header.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyHeader","name":"x-api-key"}],"title":"apiKeyHeader"}]},"originalFileLocation":"api-reference/biolinks.openapi.json"},"subdomain":"onlysocial","siteName":"OnlySocial API","title":"Create a short link - OnlySocial API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-31T01:50:41.118Z","originalFileLocation":"biolinks/short-links/create-a-short-link.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=\"New links are created paused. Required permission: biolinks:links:write\">\u003cmeta data-mint-head name=\"application-name\" content=\"OnlySocial API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/onlysocial/e8F8GK-eppzL_Bf4/_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/onlysocial/e8F8GK-eppzL_Bf4/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/onlysocial/e8F8GK-eppzL_Bf4/_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/onlysocial/e8F8GK-eppzL_Bf4/_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/onlysocial/e8F8GK-eppzL_Bf4/_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/onlysocial/e8F8GK-eppzL_Bf4/_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/onlysocial/e8F8GK-eppzL_Bf4/_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/onlysocial/e8F8GK-eppzL_Bf4/_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/onlysocial/e8F8GK-eppzL_Bf4/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a short link - OnlySocial API\">\u003cmeta data-mint-head property=\"og:description\" content=\"New links are created paused. Required permission: biolinks:links:write\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OnlySocial API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://onlysocial.mintlify.app/biolinks/short-links/create-a-short-link\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://onlysocial.mintlify.app/_mintlify/api/og/v2?division=Short+links\u0026amp;title=Create+a+short+link\u0026amp;description=New+links+are+created+**paused**.%0A%0A**Required+permission%3A**+%60biolinks%3Alinks%3Awrite%60\u0026amp;theme=413d59e57a1f6eb782bd67f2\u0026amp;signature=323915b4e74653684914cf0397cbd8e5886f94d7ae356685400d3194d3ef0ce0\">\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 short link - OnlySocial API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"New links are created paused. Required permission: biolinks:links:write\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://onlysocial.mintlify.app/_mintlify/api/og/v2?division=Short+links\u0026amp;title=Create+a+short+link\u0026amp;description=New+links+are+created+**paused**.%0A%0A**Required+permission%3A**+%60biolinks%3Alinks%3Awrite%60\u0026amp;theme=413d59e57a1f6eb782bd67f2\u0026amp;signature=323915b4e74653684914cf0397cbd8e5886f94d7ae356685400d3194d3ef0ce0\">\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/onlysocial/e8F8GK-eppzL_Bf4/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OnlySocial API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B82F6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://onlysocial.mintlify.app/biolinks/short-links/create-a-short-link\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/biolinks/short-links/create-a-short-link.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://onlysocial.mintlify.app/#organization\",\"name\":\"OnlySocial API\",\"url\":\"https://onlysocial.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/onlysocial/LJSprGB5_BPvOyDE/logo/onlysocial.png?fit=max\u0026auto=format\u0026n=LJSprGB5_BPvOyDE\u0026q=85\u0026s=f11759a50722ae8548a860bed9c1d8ee\"}},{\"@type\":\"WebSite\",\"@id\":\"https://onlysocial.mintlify.app#website\",\"name\":\"OnlySocial API\",\"url\":\"https://onlysocial.mintlify.app\",\"publisher\":{\"@id\":\"https://onlysocial.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://onlysocial.mintlify.app/biolinks/short-links/create-a-short-link#webpage\",\"url\":\"https://onlysocial.mintlify.app/biolinks/short-links/create-a-short-link\",\"name\":\"Create a short link\",\"description\":\"New links are created paused. Required permission: biolinks:links:write\",\"dateModified\":\"2026-10-31T01:50:41.118Z\",\"isPartOf\":{\"@id\":\"https://onlysocial.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://onlysocial.mintlify.app/biolinks/short-links/create-a-short-link#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://onlysocial.mintlify.app/biolinks/short-links/create-a-short-link#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reference\",\"item\":\"https://onlysocial.mintlify.app/biolinks/pages/list-pages\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Short links\",\"item\":\"https://onlysocial.mintlify.app/biolinks/short-links/list-short-links\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create a short link\",\"item\":\"https://onlysocial.mintlify.app/biolinks/short-links/create-a-short-link\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://onlysocial.mintlify.app/biolinks/short-links/create-a-short-link#apireference\",\"headline\":\"Create a short link\",\"name\":\"Create a short link\",\"description\":\"New links are created paused. Required permission: biolinks:links:write\",\"url\":\"https://onlysocial.mintlify.app/biolinks/short-links/create-a-short-link\",\"mainEntityOfPage\":{\"@id\":\"https://onlysocial.mintlify.app/biolinks/short-links/create-a-short-link#webpage\"},\"dateModified\":\"2026-10-31T01:50:41.118Z\",\"publisher\":{\"@id\":\"https://onlysocial.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://onlysocial.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OnlySocial API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"OnlySocial API","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"Messaging API","pages":[{"title":"Messaging API","href":"/messaging/account/get-the-authenticated-workspace"}]},{"tab":"Publishing API","pages":[{"title":"Publishing API","href":"/publishing/diagnostics/check-your-key"}]},{"tab":"Link in Bio API","groups":[{"group":"Overview","pages":[{"title":"Link in Bio API overview","href":"/biolinks/overview"}]},{"group":"Reference","pages":[{"group":"Pages","pages":[{"title":"List pages","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /pages","href":"/biolinks/pages/list-pages"},{"title":"Create a page","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json post /pages","href":"/biolinks/pages/create-a-page"},{"title":"Get a page","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /pages/{page}","href":"/biolinks/pages/get-a-page"},{"title":"Delete a page","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json delete /pages/{page}","href":"/biolinks/pages/delete-a-page"},{"title":"Update a page","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json patch /pages/{page}","href":"/biolinks/pages/update-a-page"},{"title":"Set page status","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json put /pages/{page}/status","href":"/biolinks/pages/set-page-status"},{"title":"Duplicate a page","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json post /pages/{page}/duplicate","href":"/biolinks/pages/duplicate-a-page"},{"title":"Change a page theme","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json post /pages/{page}/theme","href":"/biolinks/pages/change-a-page-theme"}]},{"group":"Blocks","pages":[{"title":"List blocks","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /pages/{page}/blocks","href":"/biolinks/blocks/list-blocks"},{"title":"Add a block","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json post /pages/{page}/blocks","href":"/biolinks/blocks/add-a-block"},{"title":"Reorder blocks","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json put /pages/{page}/blocks/order","href":"/biolinks/blocks/reorder-blocks"},{"title":"Get a block","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /pages/{page}/blocks/{block}","href":"/biolinks/blocks/get-a-block"},{"title":"Delete a block","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json delete /pages/{page}/blocks/{block}","href":"/biolinks/blocks/delete-a-block"},{"title":"Update a block","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json patch /pages/{page}/blocks/{block}","href":"/biolinks/blocks/update-a-block"}]},{"group":"Short links","pages":[{"title":"List short links","description":"**Required permission:** `biolinks:links:read`","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /links","href":"/biolinks/short-links/list-short-links"},{"title":"Create a short link","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json post /links","href":"/biolinks/short-links/create-a-short-link"},{"title":"Get a short link","description":"**Required permission:** `biolinks:links:read`","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /links/{link}","href":"/biolinks/short-links/get-a-short-link"},{"title":"Delete a short link","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json delete /links/{link}","href":"/biolinks/short-links/delete-a-short-link"},{"title":"Update a short link","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json patch /links/{link}","href":"/biolinks/short-links/update-a-short-link"},{"title":"Set short link status","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json put /links/{link}/status","href":"/biolinks/short-links/set-short-link-status"}]},{"group":"Catalogue","pages":[{"title":"Get the catalogue","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /catalog","href":"/biolinks/catalogue/get-the-catalogue"}]},{"group":"Analytics","pages":[{"title":"Get page analytics","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /pages/{page}/analytics","href":"/biolinks/analytics/get-page-analytics"},{"title":"Get short link analytics","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /links/{link}/analytics","href":"/biolinks/analytics/get-short-link-analytics"}]},{"group":"Submissions","pages":[{"title":"List form submissions","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /submissions","href":"/biolinks/submissions/list-form-submissions"},{"title":"Get a submission","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /submissions/{submission}","href":"/biolinks/submissions/get-a-submission"},{"title":"Delete a submission","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json delete /submissions/{submission}","href":"/biolinks/submissions/delete-a-submission"}]},{"group":"QR codes","pages":[{"title":"List QR codes","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /qr","href":"/biolinks/qr-codes/list-qr-codes"},{"title":"Create a QR code","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json post /qr","href":"/biolinks/qr-codes/create-a-qr-code"},{"title":"Get a QR code","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /qr/{qr}","href":"/biolinks/qr-codes/get-a-qr-code"},{"title":"Delete a QR code","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json delete /qr/{qr}","href":"/biolinks/qr-codes/delete-a-qr-code"},{"title":"Get a QR code matrix","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /qr/{qr}/matrix","href":"/biolinks/qr-codes/get-a-qr-code-matrix"}]},{"group":"Pixels","pages":[{"title":"List pixels","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /pixels","href":"/biolinks/pixels/list-pixels"},{"title":"Create a pixel","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json post /pixels","href":"/biolinks/pixels/create-a-pixel"},{"title":"Delete a pixel","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json delete /pixels/{pixel}","href":"/biolinks/pixels/delete-a-pixel"}]},{"group":"Domains","pages":[{"title":"List usable domains","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /domains/available","href":"/biolinks/domains/list-usable-domains"},{"title":"List domains","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /domains","href":"/biolinks/domains/list-domains"},{"title":"Connect a domain","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json post /domains","href":"/biolinks/domains/connect-a-domain"},{"title":"Get a domain","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /domains/{domain}","href":"/biolinks/domains/get-a-domain"},{"title":"Remove a domain","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json delete /domains/{domain}","href":"/biolinks/domains/remove-a-domain"},{"title":"Verify a domain","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json post /domains/{domain}/verify","href":"/biolinks/domains/verify-a-domain"},{"title":"Get a domain operation","deprecated":null,"version":null,"openapi":"/api-reference/biolinks.openapi.json get /domain-operations/{operation}","href":"/biolinks/domains/get-a-domain-operation"}]}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]},{"tab":"Partner API","pages":[{"title":"Partner API","href":"/partner/overview"}]}]},"basePath":"","title":"Create a short link - OnlySocial API","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}