Managing external OAuth clients

<body>
<p id="docs-hc-snippet" style="display: none;">The external OAuth clients page displays a list of Zendesk Marketplace apps and integrations that use external (global) OAuth tokens to authenticate and connect to your Zendesk account. These tokens are typically used by Marketplace apps that Zendesk admins install in their Zendesk instance.</p>
<div class="article-banners">
<div id="docs-wmp-link">
<a href="https://support.zendesk.com/hc/en-us/articles/5411234991258-plan" rel="noopener" target="_blank">What's my plan?</a>
</div>

<div class="article-banner" id="suite_all">
<table>
<tbody>
<tr>
<td>
<strong>All Suites</strong>
</td>
<td>Team, Growth, Professional, Enterprise, or Enterprise Plus</td>
</tr>
</tbody>
</table>
</div>

<div class="article-banner" id="support_all">
<table>
<tbody>
<tr>
<td>
<strong>Support</strong>
</td>
<td>Team, Professional, or Enterprise</td>
</tr>
</tbody>
</table>
</div>

</div>

<div class="body">

<p class="p">The external OAuth clients page displays a list of Zendesk Marketplace apps and integrations
that use external (global) OAuth tokens to authenticate and connect to your Zendesk account.
These tokens are typically used by Marketplace apps that Zendesk admins install in their
Zendesk instance. </p>
<p class="p">Developers of these apps must obtain a global OAuth client from Zendesk, which is then used
to create global OAuth tokens (“external” tokens) for authenticating the app’s API requests
across multiple Zendesk customers. For example, if you install a Marketplace app like
Geckoboard in your Zendesk instance, the app uses a global OAuth token, and the corresponding
client will appear on this page. This allows you to view all third-party integrations that are
authorized to access your Zendesk account, regardless of which team member set them up. For
more information about global OAuth clients, see <a class="xref" href="https://developer.zendesk.com/documentation/marketplace/building-a-marketplace-app/set-up-a-global-oauth-client/" target="_blank">Set up a global OAuth client</a>.</p>
<p class="p">Global OAuth clients created on or after February 2, 2026 have default expiration times for
access and refresh tokens. For the default, minimum, and maximum expiration times, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408845965210#topic_jkc_dcm_dcc" target="_blank">Using OAuth authentication with your application</a>.</p>
<div class="p">
<div class="note" id="topic-1__note_k4r_1hg_wfc">
<span class="notetitle">Note:</span> You can't create global OAuth tokens directly in Admin Center like
you can with API tokents. For more information, see <a class="xref" href="https://developer.zendesk.com/documentation/marketplace/building-a-marketplace-app/set-up-a-global-oauth-client/" target="_blank">Setting up a global OAuth client</a>.</div>
</div>
<p class="p">Topics covered in this article:</p>
<ul class="ul" id="topic-1__ul_znb_jfs_qk">
<li class="li"><a class="xref" href="#topic_jth_dhg_wfc">Accessing the external OAuth clients page</a></li>
<li class="li"><a class="xref" href="#topic_ncl_ly2_yfc">Searching external OAuth clients</a></li>
<li class="li"><a class="xref" href="#topic_m5p_p3g_wfc">Viewing external OAuth tokens</a></li>
<li class="li"><a class="xref" href="#topic_jnv_bjg_wfc">Viewing scopes for external OAuth tokens</a></li>
<li class="li"><a class="xref" href="#topic_qf5_x32_yfc">Viewing audit logs for external OAuth tokens (Enterprise)</a></li>
<li class="li"><a class="xref" href="#topic_umn_kjg_wfc">Deleting external OAuth tokens</a></li>
</ul>
</div>
<div aria-labelledby="ariaid-title2" class="topic nested1" id="topic_jth_dhg_wfc">
<h2 class="title topictitle2" id="ariaid-title2">Accessing the external OAuth clients page</h2>
<div class="body">
<p class="p">You can access the external OAuth clients that have been granted access to your
account.</p>
<p class="p"><strong class="ph b">To access the external OAuth clients page</strong></p>
<ul class="ul" id="topic_jth_dhg_wfc__ol_ns1_ghg_wfc">
<li class="li">
<span class="ph">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" target="_blank">Admin Center</a>, click <img class="image" id="topic_jth_dhg_wfc__image_k1v_ttr_tfc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_apps_integrations_icon.png">
<strong class="ph b">Apps and integrations</strong> in the sidebar, then select <strong class="ph b">APIs &gt; External OAuth
clients</strong>.</span><p class="p">A list of clients appears. It shows external OAuth client information including the
client name, number of tokens, company name associated with the OAuth client, client
identifier, and date last used.</p>
<p class="p"><img class="image img-screenshot" id="topic_jth_dhg_wfc__image_mtt_ryy_j2c" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/external-oauth-client-list.png" width="500"></p>
</li>
</ul>
</div>
</div>
<div aria-labelledby="ariaid-title3" class="topic nested1" id="topic_ncl_ly2_yfc">
<h2 class="title topictitle2" id="ariaid-title3">Searching external OAuth clients</h2>
<div class="body">
<p class="p">If you have a large number of external OAuth clients, or you need to locate clients that
include a specific keyword, you can use the search feature.</p>
<p class="p"><strong class="ph b">To search for an external OAuth client</strong></p>
<ol class="ol" id="topic_ncl_ly2_yfc__ol_vm1_4y2_yfc">
<li class="li"><span class="ph">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" target="_blank">Admin Center</a>, click <img class="image" id="topic_ncl_ly2_yfc__image_k1v_ttr_tfc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_apps_integrations_icon.png">
<strong class="ph b">Apps and integrations</strong> in the sidebar, then select <strong class="ph b">APIs &gt; External OAuth
clients</strong>.</span></li>
<li class="li">Enter your search term or keywords in the search bar.<p class="p">As you type, the list displays
external OAuth clients matching your search term.</p>
</li>
</ol>
</div>
</div>
<div aria-labelledby="ariaid-title4" class="topic nested1" id="topic_m5p_p3g_wfc">
<h2 class="title topictitle2" id="ariaid-title4">Viewing external OAuth tokens</h2>
<div class="body">
<p class="p">You can view tokens created for an external OAuth client, allowing you to monitor active
tokens and identify those that may require revocation.</p>
<p class="p"><strong class="ph b">To view external OAuth tokens</strong></p>
<ol class="ol" id="topic_m5p_p3g_wfc__ol_xq1_s3g_wfc">
<li class="li"><span class="ph">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" target="_blank">Admin Center</a>, click <img class="image" id="topic_m5p_p3g_wfc__image_k1v_ttr_tfc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_apps_integrations_icon.png">
<strong class="ph b">Apps and integrations</strong> in the sidebar, then select <strong class="ph b">APIs &gt; External OAuth
clients</strong>.</span></li>
<li class="li">Find the client in the list whose tokens you want to view.</li>
<li class="li">Click the options menu (<img class="image" id="topic_m5p_p3g_wfc__image_ljg_fqg_wfc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/sell_icon_menu_vertical.png" width="20">) next to the client and select <strong class="ph b">View
token</strong>.<p class="p">A list of access tokens for the external OAuth client appears.</p>
<p class="p"><img class="image img-screenshot" id="topic_m5p_p3g_wfc__image_sfk_jy2_yfc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/external-oauth-client-tokens.png" width="500"></p>
</li>
</ol>
</div>
</div>
<div aria-labelledby="ariaid-title5" class="topic nested1" id="topic_jnv_bjg_wfc">
<h2 class="title topictitle2" id="ariaid-title5">Viewing scopes for external OAuth tokens</h2>
<div class="body">
<p class="p"><a class="xref" href="https://developer.zendesk.com/api-reference/ticketing/oauth/oauth_tokens/#scopes" target="_blank">Scopes</a> are the permissions that define exactly what
actions an app can perform or what data it can access on your behalf.</p>
<p class="p"><strong class="ph b">To view the scopes for an external OAuth token</strong></p>
<ol class="ol" id="topic_jnv_bjg_wfc__ol_s3t_fjg_wfc">
<li class="li"><span class="ph">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" target="_blank">Admin Center</a>, click <img class="image" id="topic_jnv_bjg_wfc__image_k1v_ttr_tfc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_apps_integrations_icon.png">
<strong class="ph b">Apps and integrations</strong> in the sidebar, then select <strong class="ph b">APIs &gt; External OAuth
clients</strong>.</span></li>
<li class="li">Find the client in the list.</li>
<li class="li">Click the options menu (<img class="image" id="topic_jnv_bjg_wfc__image_rcw_ywb_cgc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/sell_icon_menu_vertical.png" width="20">) next to the client and select <strong class="ph b">View
token</strong>.</li>
<li class="li">Find the token you want to view for scopes.</li>
<li class="li">Click the options menu (<img class="image" id="topic_jnv_bjg_wfc__image_dkt_lcc_cgc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/sell_icon_menu_vertical.png" width="20">) next to the token and select <strong class="ph b">View
scope</strong>.</li>
</ol>
</div>
</div>
<div aria-labelledby="ariaid-title6" class="topic nested1" id="topic_qf5_x32_yfc">
<h2 class="title topictitle2" id="ariaid-title6">Viewing audit logs for external OAuth tokens (Enterprise)</h2>
<div class="body">
<p class="p">On Enterprise plans, the audit log shows changes made to the token since it was created.
For more information, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408828001434-Viewing-the-audit-log-for-changes-to-your-account" target="_blank">Viewing the audit log for changes to your
account</a>.</p>
<p class="p"><strong class="ph b">To view audit logs for an external OAuth token</strong></p>
<ol class="ol" id="topic_qf5_x32_yfc__ol_ldy_bj2_yfc">
<li class="li"><span class="ph">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" target="_blank">Admin Center</a>, click <img class="image" id="topic_qf5_x32_yfc__image_k1v_ttr_tfc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_apps_integrations_icon.png">
<strong class="ph b">Apps and integrations</strong> in the sidebar, then select <strong class="ph b">APIs &gt; External OAuth
clients</strong>.</span></li>
<li class="li">Find the client in the list.</li>
<li class="li">Click the options menu (<img class="image" id="topic_qf5_x32_yfc__image_mdy_bj2_yfc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/sell_icon_menu_vertical.png" width="20">) next to the client and select <strong class="ph b">View
token</strong>.</li>
<li class="li">Find the token you want to view for audit logs.</li>
<li class="li">Click the options menu (<img class="image" id="topic_qf5_x32_yfc__image_ndy_bj2_yfc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/sell_icon_menu_vertical.png" width="20">) next to the token and select <strong class="ph b">View audit
logs</strong>.</li>
</ol>
</div>
</div>
<div aria-labelledby="ariaid-title7" class="topic nested1" id="topic_umn_kjg_wfc">
<h2 class="title topictitle2" id="ariaid-title7">Deleting external OAuth tokens</h2>
<div class="body">
<p class="p">If you believe an external OAuth token has been compromised, or if you no longer need a
token or think it might be lost or forgotten, it should be deleted. Deleting unused or
potentially compromised tokens helps keep your account secure and organized. To completely
revoke an integration’s access to your account, delete all tokens associated with that
client. Team members can always reauthorize the integration later if needed.</p>
<p class="p"><strong class="ph b">To delete external OAuth tokens</strong></p>
<ol class="ol" id="topic_umn_kjg_wfc__ol_l4g_njg_wfc">
<li class="li"><span class="ph">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" target="_blank">Admin Center</a>, click <img class="image" id="topic_umn_kjg_wfc__image_k1v_ttr_tfc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_apps_integrations_icon.png">
<strong class="ph b">Apps and integrations</strong> in the sidebar, then select <strong class="ph b">APIs &gt; External OAuth
clients</strong>.</span></li>
<li class="li">Find the client in the list.</li>
<li class="li">Click the options menu (<img class="image" id="topic_umn_kjg_wfc__image_pgw_2qg_wfc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/sell_icon_menu_vertical.png" width="20">) next to the client and select <strong class="ph b">View
token</strong>.</li>
<li class="li">To delete an individual token:<ul class="ul" id="topic_umn_kjg_wfc__ul_yyn_pjg_wfc">
<li class="li">Find the token you want to delete.</li>
<li class="li">Click the options menu (<img class="image" id="topic_umn_kjg_wfc__image_h5x_2qg_wfc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/sell_icon_menu_vertical.png" width="20">) next to the token and select
<strong class="ph b">Delete</strong>.</li>
<li class="li">When a confirmation message appears, click <strong class="ph b">Delete token</strong>.<p class="p"><img class="image img-screenshot" id="topic_umn_kjg_wfc__image_sgw_ry2_yfc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/external-oauth-client-delete-token.png" width="500"></p>
</li>
</ul>
</li>
<li class="li">To delete multiple tokens:<ul class="ul" id="topic_umn_kjg_wfc__ul_nrg_rjg_wfc">
<li class="li">Select the tokens you want to delete.</li>
<li class="li">Click the options menu (<img class="image" id="topic_umn_kjg_wfc__image_sb1_fqg_wfc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/sell_icon_menu_vertical.png" width="20">) next to any of the selected tokens and select
<strong class="ph b">Delete</strong>.<p class="p"><img class="image img-screenshot" id="topic_umn_kjg_wfc__image_dgb_nbc_cgc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/external-oauth-bulk-delete.png" width="500"></p>
</li>
</ul>
</li>
</ol>
</div>
</div>
<script id="docs-schema-markup" type="application/ld+json">{
"@context": "https://schema.org",
"@type": "TechArticle",
"@id": "https://support.zendesk.com/hc/en-us/articles/9447118302362",
"url": "https://support.zendesk.com/hc/en-us/articles/9447118302362",
"headline": "Managing external OAuth clients",
"description": "You can manage and monitor external OAuth clients and their tokens that authenticate third-party apps and integrations connected to your account, including viewing, searching, auditing, and deleting tokens to maintain security and control access.",
"articleSection": "Account access",
"datePublished": "2025-07-03T22:39:30+00:00",
"dateModified": "2026-08-21T22:37:50.256060+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/9447118302362"
},
"author": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"publisher": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"isPartOf": {
"@type": "WebSite",
"name": "Zendesk Help",
"@id": "https://support.zendesk.com/hc/"
},
"about": {
"@type": "SoftwareApplication",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
}
}</script>
</body>