New! Use the 1Password Credential Broker to give CI/CD and other machine workflows short-lived access to secrets, without managing service account tokens.
using RestSharp;
var options = new RestClientOptions("https://app.trelica.com/api/apps/v1");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"globalAppName\": \"Zoom\",\n \"instanceName\": \"Sales\",\n \"status\": \"Managed\"\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
{
"type": "about:blank",
"title": "One or more validation errors occurred.",
"status": 400,
"detail": "The request body failed validation. See errors for the offending fields.",
"errors": {
"email": [
"The email field is required."
]
},
"traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}
{
"type": "about:blank",
"title": "Conflict.",
"status": 409,
"detail": "The request conflicts with the current state (for example, the resource already exists).",
"traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}
Applications
Create an application
Adds a managed application to your organization. Identify the underlying app with either
globalAppId or globalAppName (exactly one is required). When supplying a name
that does not match an app in the global catalog, supply vendorName and a new local
vendor is created. Returns 409 if the application already exists.
Required scope:Apps.Write (Write access to applications)
using RestSharp;
var options = new RestClientOptions("https://app.trelica.com/api/apps/v1");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"globalAppName\": \"Zoom\",\n \"instanceName\": \"Sales\",\n \"status\": \"Managed\"\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
{
"type": "about:blank",
"title": "One or more validation errors occurred.",
"status": 400,
"detail": "The request body failed validation. See errors for the offending fields.",
"errors": {
"email": [
"The email field is required."
]
},
"traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}
{
"type": "about:blank",
"title": "Conflict.",
"status": 409,
"detail": "The request conflicts with the current state (for example, the resource already exists).",
"traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}
Custom field values, keyed by the field's lookup key. Each value is the field's value directly: a string (text/single-select), a number, an ISO-8601 date, or an array of strings (multi-select).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"1Password Developer","description":"Developer docs for 1Password. Keep secrets out of your code with the CLI, SSH agent, Environments, service accounts, SDKs, and tools for AI agents.","colors":{"primary":"#145FE4","light":"#b8d7ff","dark":"#303136"},"logo":{"light":"https://mintcdn.com/ab-634991b8/tWWm5UFlpZQ9nof8/images/logo-1password-dark.svg?fit=max\u0026auto=format\u0026n=tWWm5UFlpZQ9nof8\u0026q=85\u0026s=2c2acc6dc5f817defe70ebdef67c9b11","dark":"https://mintcdn.com/ab-634991b8/tWWm5UFlpZQ9nof8/images/logo-1password-light.svg?fit=max\u0026auto=format\u0026n=tWWm5UFlpZQ9nof8\u0026q=85\u0026s=0dae06f9dd5b1f569de5cb9fba337405"},"favicon":"https://mintcdn.com/ab-634991b8/s4Wjy03jBRs6hcHb/favicon.ico?fit=max\u0026auto=format\u0026n=s4Wjy03jBRs6hcHb\u0026q=85\u0026s=dd03b4bc604b342373aa4d3e21be4310","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","node","python","go","dotnet","java","php","powershell","ruby"]}},"background":{"color":{"light":"#ffffff","dark":"#1a1b1e"}},"navbar":{"links":[{"icon":"github","href":"https://github.com/1Password","label":"GitHub"},{"icon":"slack","href":"https://www.1password.dev/joinslack","label":"Join Slack"}],"primary":{"type":"button","label":"Try free","href":"https://1password.com/pricing/business"}},"footer":{"socials":{"github":"https://github.com/1Password","x":"https://x.com/1PasswordDev","reddit":"https://www.reddit.com/r/1Password","linkedin":"https://www.linkedin.com/company/1password","youtube":"https://www.youtube.com/1PasswordVideos","facebook":"https://www.facebook.com/1Password","instagram":"https://www.instagram.com/1password"},"links":[{"header":"Get started","items":[{"label":"Developer quickstart","href":"/get-started/developer-quickstart"},{"label":"Admin quickstart","href":"/get-started/administrator-quickstart"},{"label":"Partner quickstart","href":"/get-started/partner-quickstart"},{"label":"All setup guides","href":"/get-started"}]},{"header":"Help and resources","items":[{"label":"CLI troubleshooting","href":"/cli/app-integration"},{"label":"SSH troubleshooting","href":"/ssh/agent/troubleshooting"},{"label":"System status","href":"https://status.1password.com"},{"label":"CLI release notes","href":"/cli/release-notes"},{"label":"1Password University","href":"https://www.1password.university/?utm_ref=website-footer"},{"label":"Blog","href":"https://blog.1password.com"}]},{"header":"Community","items":[{"label":"Developer community","href":"/community"},{"label":"Events","href":"https://luma.com/1password"},{"label":"Developer Slack","href":"/joinslack"},{"label":"Newsletter","href":"https://1password.com/developer-newsletter"},{"label":"Code of Conduct","href":"/code-of-conduct"},{"label":"Projects disclaimer","href":"/community/disclaimer"}]},{"header":"Legal","items":[{"label":"Terms of Service","href":"https://1password.com/legal/terms-of-service"},{"label":"Privacy Policy","href":"https://1password.com/legal/privacy"},{"label":"Cookie Policy","href":"https://1password.com/legal/cookies"},{"label":"Accessibility","href":"https://1password.com/legal/accessibility"}]}]},"seo":{"metatags":{"canonical":"https://www.1password.dev","google-site-verification":"YserOhXnJUjFfIZ4K3qgxkVSlQZQdXtIbBiKzZ35Nvs"}},"fonts":{"heading":{"family":"Public Sans"},"body":{"family":"Public Sans"}},"banner":{"content":"**New!** Use the [1Password Credential Broker](https://www.1password.dev/brokered-access) to give CI/CD and other machine workflows short-lived access to secrets, without managing service account tokens.","dismissible":true,"color":{"light":"#145fe4","dark":"#145fe4"}},"errors":{"404":{"redirect":false,"title":"This page can't be found","description":"Our docs have moved to [www.1password.dev](https://www.1password.dev). Try searching for what you need or selecting from the list of tools."}},"contextual":{"options":["copy","view","mcp","cursor","vscode","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ab-634991b8","hasAudioNarration":false,"actualSubdomain":"ab-634991b8","customDomains":["www.1password.dev"],"gitSource":{"type":"github","owner":"1password","repo":"1password.dev","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"contextualFeedback":{"allowEmail":false},"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af4cc23835e7d1bb15472d7","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"CLI","count":320},{"language":"default","tag":"SDKs \u0026 APIs","count":120},{"language":"default","tag":"Shell Plugins","count":104},{"language":"default","tag":"Plugins","count":97},{"language":"default","tag":"CI/CD \u0026 infrastructure","count":92},{"language":"default","tag":"SaaS Manager API","count":88},{"language":"default","tag":"API Reference","count":64},{"language":"default","tag":"Reference","count":56},{"language":"default","tag":"SDKs","count":51},{"language":"default","tag":"Events API","count":44}]},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"deflection":{"enabled":true,"email":"support@1password.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"styles.css","content":":root{--op-secure-blue: #104ebb;--op-secure-blue-hover: #0e46a8;--op-iron-ore: #303136;--op-page-bg-dark: #1a1b1e;--op-white: #ffffff;--op-icy-blue: #dcebff;--op-cornflower: #b8d7ff;--op-biscuit: #fbf8f4;--op-sunbeam: #fad785;--op-tangerine: #ff8f78;--op-enable-mint: #76e0bd;--op-gold: #cbb88e;--op-status-success: #10622f;--op-status-warning: #8a4006;--op-status-error: #a71c1c;--op-status-info: var(--op-secure-blue);--op-border-ui: #949494;--op-border-ui-dark: #6b7280;--op-border-subtle: rgb(3 7 18 / 0.12);--op-border-subtle-dark: rgb(251 248 244 / 0.25);--op-border-footer-dark: rgb(251 248 244 / 0.37);--op-border-navbar-light: rgb(107 114 128 / 0.05);--op-border-navbar-dark: rgb(209 213 219 / 0.06);--op-border-card-light: rgb(3 7 18 / 0.1);--op-border-card-dark: rgb(255 255 255 / 0.1);--op-border-hero-light: rgb(255 255 255 / 0.08);--op-border-hero-dark: rgb(255 255 255 / 0.12);--op-border-badge-light: rgb(16 78 187 / 0.2);--op-border-badge-dark: rgb(184 215 255 / 0.25);--op-border-workflow-dark: rgb(251 248 244 / 0.2);--op-text-body: var(--op-iron-ore);--op-text-body-dark: var(--op-biscuit);--op-surface-card-light: var(--op-white);--op-surface-card-dark: #25262a;--op-surface-callout-light: rgb(220 235 255 / 0.45);--op-surface-callout-dark: rgb(184 215 255 / 0.08)}#content.prose{--tw-prose-body: var(--op-text-body)}.dark #content.prose{--tw-prose-body: var(--op-text-body-dark)}#content.prose :where(p,span[data-as=\"p\"],li,td,th,blockquote,figcaption):not(a.op-cta-primary span){color:var(--op-text-body)}.dark #content.prose :where(p,span[data-as=\"p\"],li,td,th,blockquote,figcaption):not(a.op-cta-primary span){color:var(--op-text-body-dark)}#content :is(p,li,div,span,button,h1,h2,h3,h4,h5,h6).text-gray-600,#content :is(p,li,div,span,button,h1,h2,h3,h4,h5,h6).text-gray-700,#content :is(p,li,span,button,h1,h2,h3,h4,h5,h6).text-gray-500{color:var(--op-text-body)}.dark #content :is(p,li,div,span,button,h1,h2,h3,h4,h5,h6).dark\\:text-gray-400,.dark #content :is(p,li,div,span,button,h1,h2,h3,h4,h5,h6).dark\\:text-gray-300,.dark #content :is(p,li,span,button,h1,h2,h3,h4,h5,h6).dark\\:text-gray-500{color:var(--op-text-body-dark)}#content .text-gray-400:not(:is(p,li,span,button,h1,h2,h3,h4,h5,h6)){color:var(--op-border-ui)}.dark #content .text-gray-400:not(:is(p,li,span,button,h1,h2,h3,h4,h5,h6)),.dark #content .text-gray-500:not(:is(p,li,span,button,h1,h2,h3,h4,h5,h6)){color:var(--op-border-ui-dark)}.dark .card-group{--background-dark: 37 38 42}.dark .card-group .card{background-color:rgb(var(--background-dark))!important}.card-group .card{border-color:var(--op-border-card-light)!important}.dark .card-group .card{border-color:var(--op-border-card-dark)!important}.op-card-surface{border:1px solid var(--op-border-card-light)}.dark .op-card-surface{border-color:var(--op-border-card-dark)}#content .hover\\:border-gray-300:hover{border-color:var(--op-iron-ore)}.dark #content .hover\\:border-gray-600:hover{border-color:var(--op-biscuit)}.community-card{border:1px solid var(--op-border-card-light);border-radius:0.5rem;background-color:var(--op-surface-card-light)}.dark .community-card{border-color:var(--op-border-card-dark);background-color:var(--op-surface-card-dark)}.community-card .community-card-chevron{color:var(--op-border-ui)}.dark .community-card .community-card-chevron{color:var(--op-cornflower)}a.community-card:hover{border-color:var(--op-secure-blue)}.dark a.community-card:hover{border-color:var(--op-cornflower)}.community-callout{border:1px solid var(--op-border-card-light);border-radius:0.5rem;background-color:var(--op-surface-callout-light)}.dark .community-callout{border-color:var(--op-border-card-dark);background-color:var(--op-surface-callout-dark)}.community-link{color:var(--op-secure-blue);text-decoration:none}.community-link:hover{color:var(--op-secure-blue-hover);text-decoration:underline}.dark .community-link{color:var(--op-cornflower)}.dark .community-link:hover{color:var(--op-white)}:is(#sidebar-content a:not([aria-current=\"page\"]),#table-of-contents,#table-of-contents a,#navbar .nav-tabs-item:not([data-active]),#navbar nav ul>li:not(#topbar-cta-button)>a,#search-bar-entry,#search-bar-entry-mobile,#assistant-entry,#assistant-entry-mobile,[data-component-name=\"theme-toggle\"]){color:var(--op-text-body)}.dark :is(#sidebar-content a:not([aria-current=\"page\"]),#table-of-contents,#table-of-contents a,#navbar .nav-tabs-item:not([data-active]),#navbar nav ul>li:not(#topbar-cta-button)>a,#search-bar-entry,#search-bar-entry-mobile,#assistant-entry,#assistant-entry-mobile,[data-component-name=\"theme-toggle\"]){color:var(--op-text-body-dark)}:is(#search-bar-entry,#search-bar-entry-mobile,#assistant-entry,#assistant-entry-mobile,[data-component-name=\"theme-toggle\"]) svg{color:inherit}#footer a.h-fit svg{background-color:var(--op-biscuit)}#footer a.h-fit:hover svg{background-color:var(--op-white)}.hero-background{background-color:var(--op-iron-ore);background-image:radial-gradient(\n ellipse 75% 100% at 100% 50%,\n rgb(20 95 228 / 0.55) 0%,\n rgb(20 95 228 / 0.2) 40%,\n transparent 70%\n )}.dark .hero-background{background-color:var(--op-page-bg-dark);background-image:radial-gradient(\n ellipse 80% 100% at 100% 50%,\n rgb(20 95 228 / 0.7) 0%,\n rgb(20 95 228 / 0.3) 45%,\n transparent 75%\n )}.hero-section{border-bottom:1px solid var(--op-border-hero-light)}.dark .hero-section{border-bottom-color:var(--op-border-hero-dark)}.hero-cta{background-color:var(--op-secure-blue);color:var(--op-white);box-shadow:0 1px 3px rgb(0 0 0 / 0.25)}.hero-cta svg,.hero-cta svg path{fill:currentColor!important;color:currentColor!important}.hero-cta:hover{background-color:var(--op-secure-blue-hover)}#content.prose a.op-cta-primary,#content a.op-cta-primary{background-color:var(--op-secure-blue);color:var(--op-white)!important;text-decoration:none}#content.prose a.op-cta-primary span[data-as=\"p\"],#content.prose a.op-cta-primary span,#content a.op-cta-primary span[data-as=\"p\"],#content a.op-cta-primary span{color:var(--op-white)!important}#content.prose a.op-cta-primary:hover,#content a.op-cta-primary:hover{background-color:var(--op-secure-blue-hover);color:var(--op-white)!important}#content.prose a.op-cta-primary:hover span[data-as=\"p\"],#content.prose a.op-cta-primary:hover span,#content a.op-cta-primary:hover span[data-as=\"p\"],#content a.op-cta-primary:hover span{color:var(--op-white)!important}#topbar-cta-button a>span.absolute{background-color:var(--op-secure-blue)!important}#topbar-cta-button a:hover>span.absolute{background-color:var(--op-secure-blue-hover)!important}#topbar-cta-button a span.z-10{color:var(--op-white)!important}#topbar-cta-button a svg{color:var(--op-white)!important}.card-group{gap:1rem}#content .card-group img[src*=\"/homepage-icons/brand/\"]{width:32px;height:32px;flex-shrink:0}.homepage-card-title{display:inline-flex;flex-wrap:wrap;align-items:center;gap:0.25rem 0.5rem}.image-button-link img{margin:10px 0}.dark #content a>div>span{color:var(--op-cornflower)!important}.docs-higlight-cards{display:grid;grid-template-columns:repeat(auto-fill, minmax(250px, 1fr));gap:1rem;margin-bottom:1rem}.highlight-card-link{color:var(--op-secure-blue)!important}.highlight-card-link:hover{color:var(--op-secure-blue-hover)!important}.dark .highlight-card-link{color:var(--op-cornflower)!important}.dark .highlight-card-link:hover{color:var(--op-white)!important}.highlight-card-link svg{background-color:var(--op-secure-blue)!important}.dark .highlight-card-link svg{background-color:var(--op-cornflower)!important}.coloredCodeWrapper .code-block>div:nth-child(3){--fade-color-light: transparent !important;--fade-color-dark: transparent !important}.badge{border-radius:0.4rem;color:var(--op-white);font-weight:700;line-height:1;padding:3px 5px}.badge--primary{background-color:var(--op-secure-blue)}.badge--secondary{background-color:var(--op-biscuit);color:var(--op-iron-ore)}.op-status-badge{display:inline-flex;flex-shrink:0;align-items:center;white-space:nowrap;vertical-align:middle;border:1px solid var(--op-border-badge-light);border-radius:0.25rem;background-color:var(--op-icy-blue);color:var(--op-iron-ore);padding:0.125rem 0.625rem;font-size:0.75rem;line-height:1rem;font-weight:600}.dark .op-status-badge{border-color:var(--op-border-badge-dark);background-color:rgb(184 215 255 / 0.12);color:var(--op-icy-blue)}.op-workflow-guide-badge{display:inline-flex;flex-shrink:0;align-items:center;white-space:nowrap;margin-top:0.75rem;border:1px solid transparent;border-radius:0.25rem;background-color:var(--op-biscuit);color:var(--op-iron-ore);padding:0.125rem 0.625rem;font-size:0.75rem;line-height:1rem;font-weight:600}.dark .op-workflow-guide-badge{border-color:var(--op-border-workflow-dark);background-color:rgb(251 248 244 / 0.1);color:var(--op-biscuit)}.op-beta-badge-inline{display:inline-flex;align-items:center;margin-left:0.5rem;vertical-align:middle}.mdx-content a[href^=\"http\"]:not([href*=\"://1password.com/\"],[href$=\"://1password.com\"],[href*=\".1password.com/\"],[href$=\".1password.com\"],[href*=\"://1password.dev/\"],[href$=\"://1password.dev\"],[href*=\".1password.dev/\"],[href$=\".1password.dev\"],[href*=\"://1password.ca/\"],[href$=\"://1password.ca\"],[href*=\".1password.ca/\"],[href$=\".1password.ca\"],[href*=\"://1password.eu/\"],[href$=\"://1password.eu\"],[href*=\".1password.eu/\"],[href$=\".1password.eu\"],[href*=\"://1password.io/\"],[href$=\"://1password.io\"],[href*=\".1password.io/\"],[href$=\".1password.io\"],[href*=\"://1password.university/\"],[href$=\"://1password.university\"],[href*=\".1password.university/\"],[href$=\".1password.university\"],[href*=\"://agilebits.com/\"],[href$=\"://agilebits.com\"],[href*=\".agilebits.com/\"],[href$=\".agilebits.com\"],[href*=\"://b5dev.com/\"],[href$=\"://b5dev.com\"],[href*=\".b5dev.com/\"],[href$=\".b5dev.com\"],[href*=\"://b5local.com/\"],[href$=\"://b5local.com\"],[href*=\".b5local.com/\"],[href$=\".b5local.com\"],[href*=\"://1infra.dev/\"],[href$=\"://1infra.dev\"],[href*=\".1infra.dev/\"],[href$=\".1infra.dev\"],[href*=\"://kolide.com/\"],[href$=\"://kolide.com\"],[href*=\".kolide.com/\"],[href$=\".kolide.com\"],[href*=\"://trelica.app/\"],[href$=\"://trelica.app\"],[href*=\".trelica.app/\"],[href$=\".trelica.app\"],[href*=\"://trelica.eu/\"],[href$=\"://trelica.eu\"],[href*=\".trelica.eu/\"],[href$=\".trelica.eu\"],[href*=\"://trelica.com/\"],[href$=\"://trelica.com\"],[href*=\".trelica.com/\"],[href$=\".trelica.com\"],[href*=\"://1password.community/\"],[href$=\"://1password.community\"],[href*=\".1password.community/\"],[href$=\".1password.community\"],[href*=\"://1pw.ca/\"],[href$=\"://1pw.ca\"],[href*=\".1pw.ca/\"],[href$=\".1pw.ca\"]):not(.card *,.op-card-surface *,.image-button-link,.community-card,.community-card *,pre *,:has(img))::after{content:\"\";display:inline-block;width:1em;height:1em;margin-left:0.25em;vertical-align:-0.125em;background-color:currentColor;-webkit-mask:var(--op-link-icon, url(\"/static/img/icons/external-link.svg\")) no-repeat center / contain;mask:var(--op-link-icon, url(\"/static/img/icons/external-link.svg\")) no-repeat center / contain}.mdx-content a:is([href*=\"://github.com/\"],[href$=\"://github.com\"],[href*=\".github.com/\"],[href$=\".github.com\"],[href*=\"://github.blog/\"],[href$=\"://github.blog\"]){--op-link-icon: url(\"/static/img/logos/github.svg\")}#content>h5,#content>h6{font-weight:700}.dark #content>h5,.dark #content>h6{color:var(--op-white)}.accordion{background-color:var(--op-icy-blue)}.dark .accordion{background-color:var(--op-surface-card-dark)}.accordion .mint-bg-white{padding:1rem}.accordion .mint-bg-white [class*=\"-mx-\"]{margin:0!important;padding:0!important;width:100%!important;--page-padding: 0px}#footer>div>div.flex.flex-col.md\\:flex-row.gap-8.justify-between.min-h-\\[76px\\]>div.flex.flex-col.sm\\:grid.max-md\\:\\!grid-cols-2.gap-8.flex-1>div>div>p{display:none!important}footer#footer.advanced-footer{display:flex!important}footer#footer{align-items:unset;background-color:var(--op-iron-ore);color:var(--op-white)}#footer img.nav-logo.dark\\:hidden{display:none!important}#footer img.nav-logo.dark\\:block{display:block!important}#footer p.font-semibold,#footer a{color:var(--op-white)}#footer>div.flex.w-full.flex-col.gap-12.justify-between.px-8.py-16.md\\:py-20.lg\\:py-28.z-20>div.h-\\[1px\\].w-full.bg-gray-100.dark\\:bg-white\\/5{background-color:var(--op-border-footer-dark)}#footer>div.flex.w-full.flex-col.gap-12.justify-between.px-8.py-16.md\\:py-20.lg\\:py-28.z-20{margin:0 auto}footer .email_form{max-width:650px;margin:auto}.codeblock_accordion{margin-top:10px}.codeblock_accordion .code-block{margin:0!important}.codeblock_accordion>div>.code-block,.codeblock_accordion>div>.code-block>div:nth-child(2){border-bottom-left-radius:0;border-bottom-right-radius:0}.codeblock_accordion .see_results_container{border-bottom-left-radius:1rem;border-bottom-right-radius:1rem}.codeblock_accordion .see_results_container .code-block,.codeblock_accordion .see_results_container .code-block>div:nth-child(2){border-top-left-radius:0;border-top-right-radius:0}.hide_bullets ul li{padding-left:0!important}.hide_bullets ul li::before{content:none!important}#navigation-items a[href^=\"/\"]:not([href^=\"//\"])>div>div:nth-child(2){display:none}a[href^=\"http\"] .flex-shrink-0 svg,a[href^=\"//\"] .flex-shrink-0 svg{display:block}h1 code,h2 code,h3 code,h4 code,h5 code,h6 code{white-space:nowrap}h2.flex.whitespace-pre-wrap span.cursor-pointer svg.icon,h4.flex.whitespace-pre-wrap span.cursor-pointer svg.icon{margin:0;vertical-align:baseline}table thead tr th code{padding-left:0!important;padding-right:0!important}.tabs.tab-container{padding:0 0.8rem 1rem;border:1px solid var(--op-border-subtle);border-radius:4px}.dark .tabs.tab-container{border-color:var(--op-border-subtle-dark)}nav-tabs-item:nth-child(3),.nav-tabs-item:nth-child(3){--tab-gap-before-divider: 8px;--nav-tabs-item-gap: 0.5rem;margin-left:var(--tab-gap-before-divider)!important;padding-left:calc(\n var(--tab-gap-before-divider) + var(--nav-tabs-item-gap)\n )!important;border-left:1px solid var(--op-border-navbar-light)}.dark nav-tabs-item:nth-child(3),.dark .nav-tabs-item:nth-child(3){border-left-color:var(--op-border-navbar-dark)}.peer.is-center~div:has(.tutorial-explorer){max-width:84rem!important}@media (max-width: 639px){.tutorial-filter-bar{display:grid!important;grid-template-columns:minmax(0, 1fr)}.tutorial-filter-search{grid-column:1 / -1;width:100%}.tutorial-filter-search input{width:100%!important}.tutorial-filter-topic,.tutorial-filter-tools{grid-column:1 / -1;width:100%}.tutorial-filter-dropdown>button,.tutorial-filter-menu{width:100%}.tutorial-filter-dropdown>button{justify-content:space-between}.tutorial-filter-menu{min-width:0!important}.tutorial-filter-sort{grid-column:1 / -1;justify-self:end;margin-left:0!important}}#navbar.is-custom .nav-tabs-item[data-active]{color:var(--op-text-body);text-shadow:none}.dark #navbar.is-custom .nav-tabs-item[data-active]{color:var(--op-text-body-dark)}#navbar.is-custom .nav-tabs-item[data-active]>div{background-color:transparent!important}#navbar.is-custom .nav-tabs-item[data-active]:hover>div{background-color:rgb(229 231 235)!important}.dark #navbar.is-custom .nav-tabs-item[data-active]:hover>div{background-color:rgb(55 65 81)!important}#footer .api-sdk-terms-notice{margin:0;padding:0 0 1.25rem;font-size:0.875rem;font-style:italic;line-height:1.5;text-align:center;color:rgb(251 248 244 / 0.8);pointer-events:auto}#footer .api-sdk-terms-notice a{position:relative;z-index:2;color:var(--op-cornflower);text-decoration:underline;text-underline-offset:2px;pointer-events:auto;cursor:pointer}a:has(>img.nav-logo){display:flex;align-items:center;gap:0.25rem}a:has(>img.nav-logo)::after{content:\"Developers\";font-weight:700;font-size:1.3125rem;line-height:1;letter-spacing:-0.01em;color:#303136;white-space:nowrap}.dark a:has(>img.nav-logo)::after,#footer a:has(>img.nav-logo)::after{color:#FFFEFB}#footer a:has(>img.nav-logo)::after{font-size:1.25rem}"}],"page":{"pagePath":"saas-manager-api/reference/applications/create-an-application","slug":"/saas-manager-api/reference/applications/create-an-application","pageMetadata":{"title":"Create an application","description":"Adds a managed application to your organization. Identify the underlying app with either\n`globalAppId` or `globalAppName` (exactly one is required). When supplying a name\nthat does not match an app in the global catalog, supply `vendorName` and a new local\nvendor is created. Returns 409 if the application already exists.\n\n**Required scope:** `Apps.Write` (Write access to applications)","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json post /api/apps/v1","href":"/saas-manager-api/reference/applications/create-an-application","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: [\"Adds a managed application to your organization. Identify the underlying app with either\\n\", _jsx(_components.code, {\n children: \"globalAppId\"\n }), \" or \", _jsx(_components.code, {\n children: \"globalAppName\"\n }), \" (exactly one is required). When supplying a name\\nthat does not match an app in the global catalog, supply \", _jsx(_components.code, {\n children: \"vendorName\"\n }), \" and a new local\\nvendor is created. Returns 409 if the application already exists.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Required scope:\"\n }), \" \", _jsx(_components.code, {\n children: \"Apps.Write\"\n }), \" (Write access to applications)\"]\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 an application","description":"Adds a managed application to your organization. Identify the underlying app with either\n`globalAppId` or `globalAppName` (exactly one is required). When supplying a name\nthat does not match an app in the global catalog, supply `vendorName` and a new local\nvendor is created. Returns 409 if the application already exists.\n\n**Required scope:** `Apps.Write` (Write access to applications)","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json post /api/apps/v1","href":"/saas-manager-api/reference/applications/create-an-application","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ab-634991b8/5ebc0d10523e8210/static/js/analytics.js","/_mintlify/custom/ab-634991b8/5bb7437b1c9dcb44/static/js/gtag-prod-sst.js","/_mintlify/custom/ab-634991b8/ee8ea0eeb20ecd1e/static/js/gtag-sst.js","/_mintlify/custom/ab-634991b8/31610123c784b7c4/api-sdk-terms-notice.js","/_mintlify/custom/ab-634991b8/3604035e212f8294/homepage-card-icons.js"],"openApiReferenceData":{"operation":{"tags":["Applications"],"summary":"Create an application","description":"Adds a managed application to your organization. Identify the underlying app with either\n`globalAppId` or `globalAppName` (exactly one is required). When supplying a name\nthat does not match an app in the global catalog, supply `vendorName` and a new local\nvendor is created. Returns 409 if the application already exists.\n\n**Required scope:** `Apps.Write` (Write access to applications)","requestBody":"21495d70-16ec-4392-ae06-63d35fe166f4","responses":{"201":"daa51257-8c69-48f3-81df-b3d4aa255208","400":"7660d575-3e29-4728-9e9b-f2cc578ef813","401":"432d7f77-7e94-4053-985d-4a37fefbbf01","403":"a43ad812-3374-482f-9807-c4166ce4dfcc","409":"67d1c6df-1476-4c27-b107-ca3a9353abd5"},"security":["e1e1f674-8c21-4824-a4f6-6e04d983ffbb"],"method":"post","type":"path","servers":["2546427b-f901-49c7-91b1-a82c39cd49e7","6a0f7815-ac3d-49fb-aabf-4b5324e7ee2c"],"path":"/api/apps/v1","baseUrlOptions":["https://app.trelica.com","https://eu.trelica.com"],"title":"Create an application","codeSamples":[],"requestExampleLanguages":["bash","node","python","go","dotnet","java","php","powershell","ruby"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"globalAppId":{"oneOf":[{"type":"string","description":"The ID of the application in the global application catalog. Provide this or globalAppName (exactly one).","uniqueKey":"globalAppId.oneOf.0","typeLabel":"string"},{"type":"null","description":"The ID of the application in the global application catalog. Provide this or globalAppName (exactly one).","uniqueKey":"globalAppId.oneOf.1","typeLabel":"null"}],"uniqueKey":"globalAppId","typeLabel":"string | null"},"globalAppName":{"oneOf":[{"type":"string","description":"The name of the application in the global application catalog. Provide this or globalAppId (exactly one).","uniqueKey":"globalAppName.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the application in the global application catalog. Provide this or globalAppId (exactly one).","uniqueKey":"globalAppName.oneOf.1","typeLabel":"null"}],"uniqueKey":"globalAppName","typeLabel":"string | null"},"vendorName":{"oneOf":[{"type":"string","description":"The vendor name. Required when globalAppName does not match a global application; a local vendor is created.","uniqueKey":"vendorName.oneOf.0","typeLabel":"string"},{"type":"null","description":"The vendor name. Required when globalAppName does not match a global application; a local vendor is created.","uniqueKey":"vendorName.oneOf.1","typeLabel":"null"}],"uniqueKey":"vendorName","typeLabel":"string | null"},"instanceName":{"oneOf":[{"type":"string","description":"The instance name, used to distinguish multiple instances of the same application","uniqueKey":"instanceName.oneOf.0","typeLabel":"string"},{"type":"null","description":"The instance name, used to distinguish multiple instances of the same application","uniqueKey":"instanceName.oneOf.1","typeLabel":"null"}],"uniqueKey":"instanceName","typeLabel":"string | null"},"status":{"oneOf":[{"enum":["New","InReview","Managed","Accepted","Ignored","PlanToClose","Closed"],"type":"string","description":"The application's status. Defaults to New.","uniqueKey":"status.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["New","InReview","Managed","Accepted","Ignored","PlanToClose","Closed"],"type":"null","description":"The application's status. Defaults to New.","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"enum\u003cstring> | null"},"roles":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"The role name","uniqueKey":"roles.oneOf.0.items.[INDEX].name","typeLabel":"string"},"members":{"type":"array","items":{"type":"object","properties":{"userId":{"oneOf":[{"type":"string","description":"The user's id","uniqueKey":"roles.oneOf.0.items.[INDEX].members.items.[INDEX].userId.oneOf.0","typeLabel":"string"},{"type":"null","description":"The user's id","uniqueKey":"roles.oneOf.0.items.[INDEX].members.items.[INDEX].userId.oneOf.1","typeLabel":"null"}],"uniqueKey":"roles.oneOf.0.items.[INDEX].members.items.[INDEX].userId","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","description":"The user's name","uniqueKey":"roles.oneOf.0.items.[INDEX].members.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The user's name","uniqueKey":"roles.oneOf.0.items.[INDEX].members.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"roles.oneOf.0.items.[INDEX].members.items.[INDEX].name","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","description":"The user's e-mail address","uniqueKey":"roles.oneOf.0.items.[INDEX].members.items.[INDEX].email.oneOf.0","typeLabel":"string"},{"type":"null","description":"The user's e-mail address","uniqueKey":"roles.oneOf.0.items.[INDEX].members.items.[INDEX].email.oneOf.1","typeLabel":"null"}],"uniqueKey":"roles.oneOf.0.items.[INDEX].members.items.[INDEX].email","typeLabel":"string | null"}},"additionalProperties":false,"description":"A member of a role","uniqueKey":"roles.oneOf.0.items.[INDEX].members.items.[INDEX]","typeLabel":"object"},"description":"Users who possess this role","uniqueKey":"roles.oneOf.0.items.[INDEX].members","typeLabel":"object[]"}},"additionalProperties":false,"description":"A role","uniqueKey":"roles.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"The application's owner roles and their members. Members are matched by ID, email or name.","uniqueKey":"roles.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"name":{"type":"string","description":"The role name"},"members":{"type":"array","items":{"type":"object","properties":{"userId":{"oneOf":[{"type":"string","description":"The user's id"},{"type":"null","description":"The user's id"}]},"name":{"oneOf":[{"type":"string","description":"The user's name"},{"type":"null","description":"The user's name"}]},"email":{"oneOf":[{"type":"string","description":"The user's e-mail address"},{"type":"null","description":"The user's e-mail address"}]}},"additionalProperties":false,"description":"A member of a role"},"description":"Users who possess this role"}},"additionalProperties":false,"description":"A role"},"description":"The application's owner roles and their members. Members are matched by ID, email or name.","uniqueKey":"roles.oneOf.1","typeLabel":"null"}],"uniqueKey":"roles","typeLabel":"object[] | null"},"customFields":{"oneOf":[{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"customFields.oneOf.0.additionalProperties","typeLabel":"any"},"description":"Custom field values, keyed by the field's lookup key","uniqueKey":"customFields.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"oneOf":[{}],"uniqueKey":"customFields.oneOf.1.additionalProperties","typeLabel":"any"},"description":"Custom field values, keyed by the field's lookup key","uniqueKey":"customFields.oneOf.1","typeLabel":"null"}],"uniqueKey":"customFields","typeLabel":"object | null"}},"additionalProperties":false,"description":"The details used to create an application","uniqueKey":"","typeLabel":"object"},"example":{"globalAppName":"Zoom","instanceName":"Sales","status":"Managed"},"examples":{"Example":{"title":"Example","value":{"globalAppName":"Zoom","instanceName":"Sales","status":"Managed"}}},"exampleType":"examples"}},"required":true,"exampleType":"examples"},"responses":{"daa51257-8c69-48f3-81df-b3d4aa255208":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The application's unique ID","uniqueKey":"id","typeLabel":"string"},"name":{"type":"string","description":"The application name","uniqueKey":"name","typeLabel":"string"},"description":{"type":"string","description":"A description of the application","uniqueKey":"description","typeLabel":"string"},"instanceName":{"type":"string","description":"The instance name, used to distinguish multiple instances of the same application","uniqueKey":"instanceName","typeLabel":"string"},"status":{"enum":["New","InReview","Managed","Accepted","Ignored","PlanToClose","Closed"],"type":"string","description":"The application's status in SaaS Manager.","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"riskLevel":{"type":"string","description":"Optional OAuth access risk level: Low, Medium or High","uniqueKey":"riskLevel","typeLabel":"string"},"vendor":{"type":"object","description":"The application's vendor","properties":{"id":{"type":"string","description":"The vendor's id","uniqueKey":"vendor.id","typeLabel":"string"},"name":{"type":"string","description":"The vendor's name","uniqueKey":"vendor.name","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"vendor","typeLabel":"object"},"licenses":{"type":"array","items":{"type":"object","properties":{"name":{"oneOf":[{"type":"string","description":"The name of the license","readOnly":true,"uniqueKey":"licenses.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the license","readOnly":true,"uniqueKey":"licenses.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"licenses.items.[INDEX].name","typeLabel":"string | null"},"licensePlanId":{"oneOf":[{"type":"string","description":"The licence plan id","readOnly":true,"uniqueKey":"licenses.items.[INDEX].licensePlanId.oneOf.0","typeLabel":"string"},{"type":"null","description":"The licence plan id","readOnly":true,"uniqueKey":"licenses.items.[INDEX].licensePlanId.oneOf.1","typeLabel":"null"}],"uniqueKey":"licenses.items.[INDEX].licensePlanId","typeLabel":"string | null"},"startDate":{"type":"string","description":"The date the license started","format":"date-time","readOnly":true,"uniqueKey":"licenses.items.[INDEX].startDate","typeLabel":"string\u003cdate-time>"},"renewalDate":{"oneOf":[{"type":"string","description":"The renewal date of the license","format":"date-time","readOnly":true,"uniqueKey":"licenses.items.[INDEX].renewalDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"The renewal date of the license","format":"date-time","readOnly":true,"uniqueKey":"licenses.items.[INDEX].renewalDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"licenses.items.[INDEX].renewalDate","typeLabel":"string\u003cdate-time> | null"},"terminatedDate":{"oneOf":[{"type":"string","description":"The date the license was terminated","format":"date-time","readOnly":true,"uniqueKey":"licenses.items.[INDEX].terminatedDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"The date the license was terminated","format":"date-time","readOnly":true,"uniqueKey":"licenses.items.[INDEX].terminatedDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"licenses.items.[INDEX].terminatedDate","typeLabel":"string\u003cdate-time> | null"},"lastModifiedDtm":{"oneOf":[{"type":"string","description":"The timestamp that this data was last updated at","format":"date-time","readOnly":true,"uniqueKey":"licenses.items.[INDEX].lastModifiedDtm.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"The timestamp that this data was last updated at","format":"date-time","readOnly":true,"uniqueKey":"licenses.items.[INDEX].lastModifiedDtm.oneOf.1","typeLabel":"null"}],"uniqueKey":"licenses.items.[INDEX].lastModifiedDtm","typeLabel":"string\u003cdate-time> | null"}},"additionalProperties":false,"description":"App license details","uniqueKey":"licenses.items.[INDEX]","typeLabel":"object"},"description":"The application's license plans","uniqueKey":"licenses","typeLabel":"object[]"},"customFields":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"customFields.additionalProperties","typeLabel":"any"},"description":"Custom field values, keyed by the field's lookup key. Each value is the field's value directly: a string (text/single-select), a number, an ISO-8601 date, or an array of strings (multi-select).","uniqueKey":"customFields","typeLabel":"object"},"createdBy":{"type":"object","description":"The user that created the application record","properties":{"userId":{"oneOf":[{"type":"string","uniqueKey":"createdBy.userId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"createdBy.userId.oneOf.1","typeLabel":"null"}],"uniqueKey":"createdBy.userId","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","uniqueKey":"createdBy.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"createdBy.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"createdBy.name","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","uniqueKey":"createdBy.email.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"createdBy.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"createdBy.email","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"createdBy","typeLabel":"object"},"createdDtm":{"type":"string","description":"The timestamp for when the application record was created","format":"date-time","uniqueKey":"createdDtm","typeLabel":"string\u003cdate-time>"},"deleted":{"type":"boolean","description":"Whether the application has been deleted","uniqueKey":"deleted","typeLabel":"boolean"},"lastModifiedDtm":{"type":"string","description":"The timestamp for when the application record was last modified","format":"date-time","uniqueKey":"lastModifiedDtm","typeLabel":"string\u003cdate-time>"},"roles":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"The role name","uniqueKey":"roles.items.[INDEX].name","typeLabel":"string"},"members":{"type":"array","items":{"type":"object","properties":{"userId":{"oneOf":[{"type":"string","description":"The user's id","uniqueKey":"roles.items.[INDEX].members.items.[INDEX].userId.oneOf.0","typeLabel":"string"},{"type":"null","description":"The user's id","uniqueKey":"roles.items.[INDEX].members.items.[INDEX].userId.oneOf.1","typeLabel":"null"}],"uniqueKey":"roles.items.[INDEX].members.items.[INDEX].userId","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","description":"The user's name","uniqueKey":"roles.items.[INDEX].members.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The user's name","uniqueKey":"roles.items.[INDEX].members.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"roles.items.[INDEX].members.items.[INDEX].name","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","description":"The user's e-mail address","uniqueKey":"roles.items.[INDEX].members.items.[INDEX].email.oneOf.0","typeLabel":"string"},{"type":"null","description":"The user's e-mail address","uniqueKey":"roles.items.[INDEX].members.items.[INDEX].email.oneOf.1","typeLabel":"null"}],"uniqueKey":"roles.items.[INDEX].members.items.[INDEX].email","typeLabel":"string | null"}},"additionalProperties":false,"description":"A member of a role","uniqueKey":"roles.items.[INDEX].members.items.[INDEX]","typeLabel":"object"},"description":"Users who possess this role","uniqueKey":"roles.items.[INDEX].members","typeLabel":"object[]"}},"additionalProperties":false,"description":"A role","uniqueKey":"roles.items.[INDEX]","typeLabel":"object"},"description":"The application's owner roles and their members","uniqueKey":"roles","typeLabel":"object[]"},"isGlobal":{"type":"boolean","description":"Whether the application is recognised in the global application catalog","uniqueKey":"isGlobal","typeLabel":"boolean"},"mainCategory":{"type":"object","description":"The application's primary category","properties":{"id":{"type":"string","description":"The tag id","uniqueKey":"mainCategory.id","typeLabel":"string"},"name":{"type":"string","description":"The tag","uniqueKey":"mainCategory.name","typeLabel":"string"},"nameIntl":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"mainCategory.nameIntl.additionalProperties","typeLabel":"string"},"description":"International version of the tag","uniqueKey":"mainCategory.nameIntl","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"mainCategory","typeLabel":"object"},"otherCategories":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The tag id","uniqueKey":"otherCategories.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","description":"The tag","uniqueKey":"otherCategories.items.[INDEX].name","typeLabel":"string"},"nameIntl":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"otherCategories.items.[INDEX].nameIntl.additionalProperties","typeLabel":"string"},"description":"International version of the tag","uniqueKey":"otherCategories.items.[INDEX].nameIntl","typeLabel":"object"}},"additionalProperties":false,"description":"A tag","uniqueKey":"otherCategories.items.[INDEX]","typeLabel":"object"},"description":"The application's additional categories","uniqueKey":"otherCategories","typeLabel":"object[]"},"domains":{"type":"array","items":{"type":"string","uniqueKey":"domains.items.[INDEX]","typeLabel":"string"},"description":"The application's domains","uniqueKey":"domains","typeLabel":"string[]"},"logoUrl":{"type":"string","description":"A URL for the application's logo","uniqueKey":"logoUrl","typeLabel":"string"},"signOnUrl":{"type":"string","description":"The application's single sign-on URL","uniqueKey":"signOnUrl","typeLabel":"string"},"links":{"type":"object","description":"Links to pages containing application details","properties":{"application":{"type":"string","description":"The application url, typically the sign on page","uniqueKey":"links.application","typeLabel":"string"},"blog":{"type":"string","description":"Official application blog url","uniqueKey":"links.blog","typeLabel":"string"},"help":{"type":"string","description":"The url of the application's documentation or help","uniqueKey":"links.help","typeLabel":"string"},"homePage":{"type":"string","description":"The home page for the application","uniqueKey":"links.homePage","typeLabel":"string"},"pricing":{"type":"string","description":"A page with application pricing details","uniqueKey":"links.pricing","typeLabel":"string"},"privacyPolicy":{"type":"string","description":"A page containing application's privacy policy","uniqueKey":"links.privacyPolicy","typeLabel":"string"},"security":{"type":"string","description":"A page containing security information for the application","uniqueKey":"links.security","typeLabel":"string"},"signUp":{"type":"string","description":"The application's sign up page","uniqueKey":"links.signUp","typeLabel":"string"},"termsOfService":{"type":"string","description":"The application's terms and conditions page. Never read, much like this text","uniqueKey":"links.termsOfService","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"links","typeLabel":"object"}},"additionalProperties":false,"description":"An application","uniqueKey":"","typeLabel":"object"},"example":{"id":"9425963fcd38ed972d209b49","name":"Asana","status":"New","riskLevel":"High","vendor":{"id":"f7f213984a1a225358c21c71","name":"Asana, Inc."},"licenses":[{"name":"Premium","licensePlanId":"PREMIUM","startDate":"2024-07-22T00:00:00Z","renewalDate":"2025-07-22T00:00:00Z","terminatedDate":"2025-10-22T00:00:00Z","lastModifiedDtm":"2024-11-27T16:00:20.895Z"},{"name":"Business","licensePlanId":"BUSINESS","startDate":"2021-06-22T00:00:00Z","renewalDate":"2022-06-22T00:00:00Z","lastModifiedDtm":"2023-05-15T12:28:57.137Z"}],"customFields":{"user_area":"support","user_vcc":"corp_support"},"deleted":false,"roles":[{"name":"IT admin","members":[{"userId":"20fcf665630fc6562182578cb7f19f1e","name":"Eduardo Wilson","email":"eduardo.wilson@example.com"}]},{"name":"App owner","members":[{"userId":"0372c6f6fc51bc128389337de1146143","name":"Eduardo Jung","email":"eduardo.jung@example.com"}]}],"isGlobal":false,"mainCategory":{"id":"03823a9d2e817efcce22f52e","name":"Project Management"},"otherCategories":[{"id":"cab66910ac7cc93acdcc0338","name":"Project Management \u0026 Tracking"},{"id":"22d0532b27e33b61e53a6fc5","name":"Team Coordination \u0026 Comms"},{"id":"74e38311e5ad68ef2ab9dbb2","name":"Task Management"}],"logoUrl":"https://app-files.trelica.com/public/4ad42e9e68cf46e3bc59cb8eab35886c","links":{"application":"https://app.asana.com/"}},"examples":{"Example":{"title":"Example","value":{"id":"9425963fcd38ed972d209b49","name":"Asana","status":"New","riskLevel":"High","vendor":{"id":"f7f213984a1a225358c21c71","name":"Asana, Inc."},"licenses":[{"name":"Premium","licensePlanId":"PREMIUM","startDate":"2024-07-22T00:00:00Z","renewalDate":"2025-07-22T00:00:00Z","terminatedDate":"2025-10-22T00:00:00Z","lastModifiedDtm":"2024-11-27T16:00:20.895Z"},{"name":"Business","licensePlanId":"BUSINESS","startDate":"2021-06-22T00:00:00Z","renewalDate":"2022-06-22T00:00:00Z","lastModifiedDtm":"2023-05-15T12:28:57.137Z"}],"customFields":{"user_area":"support","user_vcc":"corp_support"},"deleted":false,"roles":[{"name":"IT admin","members":[{"userId":"20fcf665630fc6562182578cb7f19f1e","name":"Eduardo Wilson","email":"eduardo.wilson@example.com"}]},{"name":"App owner","members":[{"userId":"0372c6f6fc51bc128389337de1146143","name":"Eduardo Jung","email":"eduardo.jung@example.com"}]}],"isGlobal":false,"mainCategory":{"id":"03823a9d2e817efcce22f52e","name":"Project Management"},"otherCategories":[{"id":"cab66910ac7cc93acdcc0338","name":"Project Management \u0026 Tracking"},{"id":"22d0532b27e33b61e53a6fc5","name":"Team Coordination \u0026 Comms"},{"id":"74e38311e5ad68ef2ab9dbb2","name":"Task Management"}],"logoUrl":"https://app-files.trelica.com/public/4ad42e9e68cf46e3bc59cb8eab35886c","links":{"application":"https://app.asana.com/"}}}},"exampleType":"examples"}},"exampleType":"examples"},"7660d575-3e29-4728-9e9b-f2cc578ef813":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type.","uniqueKey":"type","typeLabel":"string"},"title":{"type":"string","description":"A short, human-readable summary of the problem.","uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","description":"The HTTP status code.","format":"int32","uniqueKey":"status","typeLabel":"integer\u003cint32>"},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem.","uniqueKey":"detail","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"description":"Validation errors keyed by field name. Present on 400 responses.","uniqueKey":"errors","typeLabel":"object"},"traceId":{"type":"string","description":"A trace identifier for correlating the error with SaaS Manager support.","uniqueKey":"traceId","typeLabel":"string"}},"additionalProperties":false,"description":"An error response (RFC 7807 problem details).","uniqueKey":"","typeLabel":"object"},"example":{"type":"about:blank","title":"One or more validation errors occurred.","status":400,"detail":"The request body failed validation. See errors for the offending fields.","errors":{"email":["The email field is required."]},"traceId":"00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"},"examples":{"Example":{"title":"Example","value":{"type":"about:blank","title":"One or more validation errors occurred.","status":400,"detail":"The request body failed validation. See errors for the offending fields.","errors":{"email":["The email field is required."]},"traceId":"00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"}}},"exampleType":"examples"}},"exampleType":"examples"},"432d7f77-7e94-4053-985d-4a37fefbbf01":{"description":"Unauthorized","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"a43ad812-3374-482f-9807-c4166ce4dfcc":{"description":"Forbidden","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"67d1c6df-1476-4c27-b107-ca3a9353abd5":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type.","uniqueKey":"type","typeLabel":"string"},"title":{"type":"string","description":"A short, human-readable summary of the problem.","uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","description":"The HTTP status code.","format":"int32","uniqueKey":"status","typeLabel":"integer\u003cint32>"},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem.","uniqueKey":"detail","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"description":"Validation errors keyed by field name. Present on 400 responses.","uniqueKey":"errors","typeLabel":"object"},"traceId":{"type":"string","description":"A trace identifier for correlating the error with SaaS Manager support.","uniqueKey":"traceId","typeLabel":"string"}},"additionalProperties":false,"description":"An error response (RFC 7807 problem details).","uniqueKey":"","typeLabel":"object"},"example":{"type":"about:blank","title":"Conflict.","status":409,"detail":"The request conflicts with the current state (for example, the resource already exists).","traceId":"00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"},"examples":{"Example":{"title":"Example","value":{"type":"about:blank","title":"Conflict.","status":409,"detail":"The request conflicts with the current state (for example, the resource already exists).","traceId":"00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"e1e1f674-8c21-4824-a4f6-6e04d983ffbb":{"oauth2":{"type":"oauth2","description":"OAuth 2.0. Obtain an access token via the Client Credentials or Authorization Code flow, then send it as `Authorization: Bearer \u003ctoken>`.","flows":{"clientCredentials":{"tokenUrl":"https://app.trelica.com/connect/token","scopes":{"Apps.Read":"Read-only access to applications","Apps.Users.Read":"Read-only access to application accounts","Apps.Write":"Write access to applications","Assets.Read":"Read-only access to devices","Assets.Write":"Write access to devices","AuditLog.Read":"Read-only access to the audit log","Contracts.Read":"Read-only access to contracts","Contracts.Write":"Write access to contracts","People.Read":"Read-only access to people and teams","People.Write":"Write access to people and teams","Users.Read":"Read-only access to users with access to SaaS Manager","Users.Write":"Write access to users with access to SaaS Manager","Workflows.Read":"Read-only access to workflow definitions","Workflows.Runs.Read":"Read-only access to workflow runs","Workflows.Runs.Execute":"Execute workflow run actions","Workflows.Runs.ReadSecrets":"Read workflow run secrets","offline_access":"Issue a refresh token alongside the access token (Authorization Code flow)"}},"authorizationCode":{"authorizationUrl":"https://app.trelica.com/connect/authorize","tokenUrl":"https://app.trelica.com/connect/token","scopes":{"Apps.Read":"Read-only access to applications","Apps.Users.Read":"Read-only access to application accounts","Apps.Write":"Write access to applications","Assets.Read":"Read-only access to devices","Assets.Write":"Write access to devices","AuditLog.Read":"Read-only access to the audit log","Contracts.Read":"Read-only access to contracts","Contracts.Write":"Write access to contracts","People.Read":"Read-only access to people and teams","People.Write":"Write access to people and teams","Users.Read":"Read-only access to users with access to SaaS Manager","Users.Write":"Write access to users with access to SaaS Manager","Workflows.Read":"Read-only access to workflow definitions","Workflows.Runs.Read":"Read-only access to workflow runs","Workflows.Runs.Execute":"Execute workflow run actions","Workflows.Runs.ReadSecrets":"Read workflow run secrets","offline_access":"Issue a refresh token alongside the access token (Authorization Code flow)"}}},"scopes":["Apps.Write"]}}},"servers":{"2546427b-f901-49c7-91b1-a82c39cd49e7":{"url":"https://app.trelica.com","description":"United States"},"6a0f7815-ac3d-49fb-aabf-4b5324e7ee2c":{"url":"https://eu.trelica.com","description":"Europe"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"oauth2","description":"OAuth 2.0. Obtain an access token via the Client Credentials or Authorization Code flow, then send it as `Authorization: Bearer \u003ctoken>`.","flows":{"clientCredentials":{"tokenUrl":"https://app.trelica.com/connect/token","scopes":{"Apps.Read":"Read-only access to applications","Apps.Users.Read":"Read-only access to application accounts","Apps.Write":"Write access to applications","Assets.Read":"Read-only access to devices","Assets.Write":"Write access to devices","AuditLog.Read":"Read-only access to the audit log","Contracts.Read":"Read-only access to contracts","Contracts.Write":"Write access to contracts","People.Read":"Read-only access to people and teams","People.Write":"Write access to people and teams","Users.Read":"Read-only access to users with access to SaaS Manager","Users.Write":"Write access to users with access to SaaS Manager","Workflows.Read":"Read-only access to workflow definitions","Workflows.Runs.Read":"Read-only access to workflow runs","Workflows.Runs.Execute":"Execute workflow run actions","Workflows.Runs.ReadSecrets":"Read workflow run secrets","offline_access":"Issue a refresh token alongside the access token (Authorization Code flow)"}},"authorizationCode":{"authorizationUrl":"https://app.trelica.com/connect/authorize","tokenUrl":"https://app.trelica.com/connect/token","scopes":{"Apps.Read":"Read-only access to applications","Apps.Users.Read":"Read-only access to application accounts","Apps.Write":"Write access to applications","Assets.Read":"Read-only access to devices","Assets.Write":"Write access to devices","AuditLog.Read":"Read-only access to the audit log","Contracts.Read":"Read-only access to contracts","Contracts.Write":"Write access to contracts","People.Read":"Read-only access to people and teams","People.Write":"Write access to people and teams","Users.Read":"Read-only access to users with access to SaaS Manager","Users.Write":"Write access to users with access to SaaS Manager","Workflows.Read":"Read-only access to workflow definitions","Workflows.Runs.Read":"Read-only access to workflow runs","Workflows.Runs.Execute":"Execute workflow run actions","Workflows.Runs.ReadSecrets":"Read workflow run secrets","offline_access":"Issue a refresh token alongside the access token (Authorization Code flow)"}}},"scopes":["Apps.Write"]},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"OAuth 2.0. Obtain an access token via the Client Credentials or Authorization Code flow, then send it as `Authorization: Bearer \u003ctoken>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"oauth2","name":"Authorization"}],"title":"oauth2"}]},"originalFileLocation":"openapi/saas_manager_api.json"},"subdomain":"ab-634991b8","siteName":"1Password Developer","title":"Create an application - 1Password Developer","relatedPagesConfig":{"enabled":true,"limit":3,"mode":"automatic"},"contextualStarterQuestions":[],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-11T20:12:30.467Z","originalFileLocation":"saas-manager-api/reference/applications/create-an-application.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=\"Adds a managed application to your organization. Identify the underlying app with either globalAppId or globalAppName (exactly one is required). When supplying a name that does not match an app in the global catalog, supply vendorName and a new local vendor is created. Returns 409 if the application already exists. Required scope: Apps.Write (Write access to applications)\">\u003cmeta data-mint-head name=\"application-name\" content=\"1Password Developer\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ab-634991b8/cic7o6CrHhA6877e/_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/ab-634991b8/cic7o6CrHhA6877e/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ab-634991b8/cic7o6CrHhA6877e/_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/ab-634991b8/cic7o6CrHhA6877e/_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/ab-634991b8/cic7o6CrHhA6877e/_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/ab-634991b8/cic7o6CrHhA6877e/_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/ab-634991b8/cic7o6CrHhA6877e/_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/ab-634991b8/cic7o6CrHhA6877e/_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/ab-634991b8/cic7o6CrHhA6877e/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create an application - 1Password Developer\">\u003cmeta data-mint-head property=\"og:description\" content=\"Adds a managed application to your organization. Identify the underlying app with either globalAppId or globalAppName (exactly one is required). When supplying a name that does not match an app in the global catalog, supply vendorName and a new local vendor is created. Returns 409 if the application already exists. Required scope: Apps.Write (Write access to applications)\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"1Password Developer\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.1password.dev/saas-manager-api/reference/applications/create-an-application\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ab-634991b8.mintlify.site/_mintlify/api/og/v2?division=Applications\u0026amp;title=Create+an+application\u0026amp;description=Adds+a+managed+application+to+your+organization.+Identify+the+underlying+app+with+either%0A%60globalAppId%60+or+%60globalAppName%60+%28exactly+one+is+required%29.+When+supply\u0026amp;theme=4f276e23841331680610e0c6\u0026amp;signature=1f162354048331a618a4281eed25e54d3a9120874fd82e7fe9c1e6d0c6698e57\">\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 an application - 1Password Developer\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Adds a managed application to your organization. Identify the underlying app with either globalAppId or globalAppName (exactly one is required). When supplying a name that does not match an app in the global catalog, supply vendorName and a new local vendor is created. Returns 409 if the application already exists. Required scope: Apps.Write (Write access to applications)\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ab-634991b8.mintlify.site/_mintlify/api/og/v2?division=Applications\u0026amp;title=Create+an+application\u0026amp;description=Adds+a+managed+application+to+your+organization.+Identify+the+underlying+app+with+either%0A%60globalAppId%60+or+%60globalAppName%60+%28exactly+one+is+required%29.+When+supply\u0026amp;theme=4f276e23841331680610e0c6\u0026amp;signature=1f162354048331a618a4281eed25e54d3a9120874fd82e7fe9c1e6d0c6698e57\">\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/ab-634991b8/cic7o6CrHhA6877e/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"1Password Developer\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#145FE4\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"YserOhXnJUjFfIZ4K3qgxkVSlQZQdXtIbBiKzZ35Nvs\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.1password.dev/saas-manager-api/reference/applications/create-an-application\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/saas-manager-api/reference/applications/create-an-application.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.1password.dev/#organization\",\"name\":\"1Password Developer\",\"url\":\"https://www.1password.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ab-634991b8/tWWm5UFlpZQ9nof8/images/logo-1password-dark.svg?fit=max\u0026auto=format\u0026n=tWWm5UFlpZQ9nof8\u0026q=85\u0026s=2c2acc6dc5f817defe70ebdef67c9b11\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.1password.dev#website\",\"name\":\"1Password Developer\",\"url\":\"https://www.1password.dev\",\"publisher\":{\"@id\":\"https://www.1password.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.1password.dev/saas-manager-api/reference/applications/create-an-application#webpage\",\"url\":\"https://www.1password.dev/saas-manager-api/reference/applications/create-an-application\",\"name\":\"Create an application\",\"description\":\"Adds a managed application to your organization. Identify the underlying app with either globalAppId or globalAppName (exactly one is required). When supplying a name that does not match an app in the global catalog, supply vendorName and a new local vendor is created. Returns 409 if the application already exists. Required scope: Apps.Write (Write access to applications)\",\"dateModified\":\"2026-11-11T20:12:30.467Z\",\"isPartOf\":{\"@id\":\"https://www.1password.dev#website\"},\"breadcrumb\":{\"@id\":\"https://www.1password.dev/saas-manager-api/reference/applications/create-an-application#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.1password.dev/saas-manager-api/reference/applications/create-an-application#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"SaaS Manager API\",\"item\":\"https://www.1password.dev/saas-manager-api\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Reference\",\"item\":\"https://www.1password.dev/saas-manager-api/reference/people/list-people\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Applications\",\"item\":\"https://www.1password.dev/saas-manager-api/reference/applications/list-applications\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Create an application\",\"item\":\"https://www.1password.dev/saas-manager-api/reference/applications/create-an-application\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.1password.dev/saas-manager-api/reference/applications/create-an-application#apireference\",\"headline\":\"Create an application\",\"name\":\"Create an application\",\"description\":\"Adds a managed application to your organization. Identify the underlying app with either globalAppId or globalAppName (exactly one is required). When supplying a name that does not match an app in the global catalog, supply vendorName and a new local vendor is created. Returns 409 if the application already exists. Required scope: Apps.Write (Write access to applications)\",\"url\":\"https://www.1password.dev/saas-manager-api/reference/applications/create-an-application\",\"mainEntityOfPage\":{\"@id\":\"https://www.1password.dev/saas-manager-api/reference/applications/create-an-application#webpage\"},\"dateModified\":\"2026-11-11T20:12:30.467Z\",\"publisher\":{\"@id\":\"https://www.1password.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://www.1password.dev#website\"}}]}\u003c/script>","agentPointerHref":"/saas-manager-api/reference/applications/create-an-application.md","siteName":"1Password Developer","nav":{"global":null,"tabs":[{"tab":"Get started","pages":[{"title":"Get started","href":"/get-started/developer-quickstart"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli"}]},{"tab":"SSH \u0026 Git","pages":[{"title":"SSH \u0026 Git","href":"/ssh"}]},{"tab":"Environments","pages":[{"title":"Environments","href":"/environments"}]},{"tab":"AI agents","pages":[{"title":"AI agents","href":"/security-for-ai"}]},{"tab":"Service Accounts","pages":[{"title":"Service Accounts","href":"/service-accounts"}]},{"tab":"CI/CD \u0026 infrastructure","pages":[{"title":"CI/CD \u0026 infrastructure","href":"/integrations"}]},{"tab":"SDKs \u0026 APIs","menu":[{"item":"SDKs","icon":"cube","pages":[{"title":"SDKs","href":"/sdks"}]},{"item":"Events API","icon":"sensor-triangle-exclamation","pages":[{"title":"Events API","href":"/events-api"}]},{"item":"Users API","icon":"id-badge","pages":[{"title":"Users API","href":"/users-api"}]},{"item":"SaaS Manager API","icon":"chart-line","groups":[{"group":"SaaS Manager API","pages":[{"title":"1Password SaaS Manager API","sidebarTitle":"Overview","href":"/saas-manager-api"},{"group":"API Reference","pages":[{"group":"People","pages":[{"title":"List people","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/people/v1","href":"/saas-manager-api/reference/people/list-people"},{"title":"Get a person","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/people/v1/{id}","href":"/saas-manager-api/reference/people/get-a-person"},{"title":"Create or replace a person","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json put /api/people/v1/{id}","href":"/saas-manager-api/reference/people/create-or-replace-a-person"},{"title":"Update selected details of a person","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json patch /api/people/v1/{id}","href":"/saas-manager-api/reference/people/update-selected-details-of-a-person"},{"title":"List a person's applications","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/people/v1/{id}/apps","href":"/saas-manager-api/reference/people/list-a-persons-applications"}]},{"group":"Teams","pages":[{"title":"Create or update a team","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json put /api/people/v1/teams","href":"/saas-manager-api/reference/teams/create-or-update-a-team"},{"title":"Get a team","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/people/v1/teams/{id}","href":"/saas-manager-api/reference/teams/get-a-team"},{"title":"Delete a team","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json delete /api/people/v1/teams/{id}","href":"/saas-manager-api/reference/teams/delete-a-team"},{"title":"List teams","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/people/v1/teams/list","href":"/saas-manager-api/reference/teams/list-teams"},{"title":"Get the team hierarchy","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/people/v1/teams/tree","href":"/saas-manager-api/reference/teams/get-the-team-hierarchy"}]},{"group":"Applications","pages":[{"title":"List applications","description":"Returns a paginated list of the applications in your organization. Use `filter` and\n`q` to narrow the results, and follow the `next` link (also provided in the\n`link` response header) to page through large result sets.\n\n**Required scope:** `Apps.Read` (Read-only access to applications)","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/apps/v1","href":"/saas-manager-api/reference/applications/list-applications"},{"title":"Create an application","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json post /api/apps/v1","href":"/saas-manager-api/reference/applications/create-an-application"},{"title":"Get an application","description":"Fetches a single application (a managed SaaS app in your organization) by its ID.\n\n**Required scope:** `Apps.Read` (Read-only access to applications)","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/apps/v1/{appId}","href":"/saas-manager-api/reference/applications/get-an-application"},{"title":"Update selected details of an application","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json patch /api/apps/v1/{id}","href":"/saas-manager-api/reference/applications/update-selected-details-of-an-application"},{"title":"List application accounts","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/apps/v1/{appId}/users","href":"/saas-manager-api/reference/applications/list-application-accounts"},{"title":"Get application categories","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/apps/v1/categories","href":"/saas-manager-api/reference/applications/get-application-categories"},{"title":"List application custom fields","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/apps/v1/customfields","href":"/saas-manager-api/reference/applications/list-application-custom-fields"}]},{"group":"Devices","pages":[{"title":"List devices","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/assets/v1","href":"/saas-manager-api/reference/devices/list-devices"},{"title":"Get a device","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/assets/v1/{id}","href":"/saas-manager-api/reference/devices/get-a-device"},{"title":"Create or replace a device","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json put /api/assets/v1/{id}","href":"/saas-manager-api/reference/devices/create-or-replace-a-device"},{"title":"Delete a device","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json delete /api/assets/v1/{id}","href":"/saas-manager-api/reference/devices/delete-a-device"},{"title":"Update selected details of a device","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json patch /api/assets/v1/{id}","href":"/saas-manager-api/reference/devices/update-selected-details-of-a-device"},{"title":"List device custom fields","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/assets/v1/customfields","href":"/saas-manager-api/reference/devices/list-device-custom-fields"}]},{"group":"Contracts","pages":[{"title":"List contracts","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/contracts/v1","href":"/saas-manager-api/reference/contracts/list-contracts"},{"title":"Create or update a contract","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json put /api/contracts/v1","href":"/saas-manager-api/reference/contracts/create-or-update-a-contract"},{"title":"Get a contract","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/contracts/v1/{id}","href":"/saas-manager-api/reference/contracts/get-a-contract"},{"title":"Delete a contract","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json delete /api/contracts/v1/{id}","href":"/saas-manager-api/reference/contracts/delete-a-contract"}]},{"group":"Workflows","pages":[{"title":"List workflows","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/workflows/v1","href":"/saas-manager-api/reference/workflows/list-workflows"},{"title":"Get a workflow","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/workflows/v1/{workflowId}","href":"/saas-manager-api/reference/workflows/get-a-workflow"},{"title":"List workflow runs","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/workflows/v1/{workflowId}/runs","href":"/saas-manager-api/reference/workflows/list-workflow-runs"},{"title":"Get a workflow run","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/workflows/v1/{workflowId}/runs/{runId}","href":"/saas-manager-api/reference/workflows/get-a-workflow-run"},{"title":"Fire a signal","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json post /api/workflows/v1/{workflowId}/runs/{runId}/firedSignals/{activityId}/{signalName}","href":"/saas-manager-api/reference/workflows/fire-a-signal"}]},{"group":"Audit log","pages":[{"title":"List audit log events","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/audit/v1/logs","href":"/saas-manager-api/reference/audit-log/list-audit-log-events"}]},{"group":"SCIM","pages":[{"title":"List resource types","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/scim/v2/ResourceTypes","href":"/saas-manager-api/reference/scim/list-resource-types"},{"title":"List users","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/scim/v2/Users","href":"/saas-manager-api/reference/scim/list-users"},{"title":"Create a user","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json post /api/scim/v2/Users","href":"/saas-manager-api/reference/scim/create-a-user"},{"title":"Get a user","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/scim/v2/Users/{userId}","href":"/saas-manager-api/reference/scim/get-a-user"},{"title":"Replace a user","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json put /api/scim/v2/Users/{userId}","href":"/saas-manager-api/reference/scim/replace-a-user"},{"title":"Delete a user","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json delete /api/scim/v2/Users/{userId}","href":"/saas-manager-api/reference/scim/delete-a-user"},{"title":"Update a user","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json patch /api/scim/v2/Users/{userId}","href":"/saas-manager-api/reference/scim/update-a-user"},{"title":"Get the User resource type","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/scim/v2/ResourceTypes/User","href":"/saas-manager-api/reference/scim/get-the-user-resource-type"}]},{"group":"Authentication","pages":[{"title":"Request an access token","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json post /connect/token","href":"/saas-manager-api/reference/authentication/request-an-access-token"},{"title":"Authorize (Authorization Code flow)","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /connect/authorize","href":"/saas-manager-api/reference/authentication/authorize-authorization-code-flow"}]}]}]}]},{"item":"Partnership API","icon":"users","pages":[{"title":"Partnership API","href":"/partnership-api/reference"}]},{"item":"Accounts API","icon":"user-gear","pages":[{"title":"Accounts API","href":"/accounts-api"}]},{"item":"Web Development","icon":"code","pages":[{"title":"Web Development","href":"/web/add-1password-button-website"}]}]},{"tab":"Community","menu":[{"item":"Developer community","icon":"users","href":"/community"},{"item":"Events","icon":"calendar","href":"https://luma.com/1password"},{"item":"Newsletter","icon":"envelope","href":"https://1password.com/developer-newsletter"},{"item":"Slack","icon":"slack","href":"https://www.1password.dev/joinslack"},{"item":"1Password Academy","icon":"graduation-cap","href":"https://www.1password.academy/path/1password-developer-tools"}]},{"tab":"Agentic Autofill partner guide","hidden":true,"pages":[{"title":"Agentic Autofill partner guide","href":"/agentic-autofill/partners"}]}]},"basePath":"","title":"Create an application - 1Password Developer","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-DV3Oq1fY.js","dist-C-XZBk9h.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-D3Isdib3.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","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","AssistantPageLink--qIqmmVG.js"]}