Finding your switchboard and responder IDs for AI agents

<body>
<p id="docs-hc-snippet" style="display: none;">If you've integrated AI agents with your Zendesk instance, it's possible that all of your channels are already using an AI agent as a default responder. If you want certain channels to use an essential AI agent instead, you need to find the AI agent's responder ID to set it as the default responder.</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">If you've integrated AI agents with your Zendesk instance, it's possible that all of your
channels are already using an AI agent as a default responder. If you want certain
channels to use an essential AI agent instead, you need to find the AI agent's responder
ID to set it as the default responder. </p>
<p class="p">In this scenario, you can use two APIs in combination to find all of your Zendesk
instance’s available responders and their corresponding IDs. </p>
<div class="p">
<div class="note" id="switchboard_finding__note_jj3_tyq_ffc">
<span class="notetitle">Note:</span> This guide uses <a class="xref" href="https://www.postman.com/product/what-is-postman/" target="_blank">Postman</a>. If you don't have Postman, you can sign up for
an account on the <a class="xref" href="https://identity.getpostman.com/signup" target="_blank">Postman website</a> and download the app. </div>
</div>
<p class="p">This article contains the following topics: </p>
<ul class="ul" id="switchboard_finding__ul_dvg_ryq_ffc">
<li class="li"><a class="xref" href="#topic_r3h_myq_ffc">Finding your switchboard ID</a></li>
<li class="li"><a class="xref" href="#topic_uqv_myq_ffc">Finding your responder IDs</a></li>
</ul>
<p class="p">Related articles: </p>
<ul class="ul" id="switchboard_finding__ul_tdx_qyq_ffc">
<li class="li">
<a class="xref" href="https://support.zendesk.com/hc/en-us/articles/8357757911834" target="_blank">Setting per-channel default responders using an
API call in Sunshine Conversations</a>
</li>
<li class="li"><a class="xref" href="https://support.zendesk.com/hc/en-us/articles/8357757769114" target="_blank">Getting a list of integration IDs from messaging
without connecting to AI agents</a></li>
</ul>
</div>
<div aria-labelledby="ariaid-title2" class="topic nested1" id="topic_r3h_myq_ffc">
<h2 class="title topictitle2" id="ariaid-title2">Finding your switchboard ID</h2>
<div class="body">
<p class="p">Use the <a class="xref" href="https://docs.smooch.io/rest/#operation/ListSwitchboards" target="_blank">List Switchboards</a> API call to find your
switchboard ID. The switchboard is automatically created when you <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/5746900266906" target="_blank">deploy messaging</a> on your Zendesk instance. </p>
<p class="p">By default, you have only one switchboard. However, you can create more switchboards
using the API. Most organizations will not have created an extra switchboard, but if
you did, you’ll need to check all of your switchboards until you find the one with
AI agents. </p>
<p class="p"><strong class="ph b">To find your switchboard ID</strong></p>
<ol class="ol" id="topic_r3h_myq_ffc__ol_ebh_xyq_ffc">
<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_r3h_myq_ffc__d9e2287" 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; Conversations
API</strong>.</span></li>
<li class="li">Select the API key you created when you integrated with AI agents, or else
create a new API key to use for the API call that can be deleted when you're
done.<p class="p">For help, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4576088682266" target="_blank">Using the Conversations API
keys</a>.</p>
</li>
<li class="li">Note the following information: <ul class="ul" id="topic_r3h_myq_ffc__ol_l1v_dzq_ffc">
<li class="li"><strong class="ph b">App ID</strong></li>
<li class="li"><strong class="ph b">Key ID</strong></li>
<li class="li">
<strong class="ph b">Secret key</strong><div class="p">
<div class="note" id="topic_r3h_myq_ffc__note_bgl_2zq_ffc">
<span class="notetitle">Note:</span> For security reasons, you can't actually
see the secret key for your original API key in Admin Center. If
you didn't save the secret key somewhere safe, you'll need to
create a new API key instead.</div>
</div>
<p class="p"><img class="image" id="topic_r3h_myq_ffc__image_ixz_fzq_ffc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/aiaa_api_key_details_example.png" width="450"></p>
</li>
</ul>
</li>
<li class="li">In Postman, use one of the following request URLs, depending on your region: <ul class="ul" id="topic_r3h_myq_ffc__ol_izn_hzq_ffc">
<li class="li">For the US:
<em class="ph i">https://api.smooch.io/v2/apps/{appId}/switchboards</em>
</li>
<li class="li">For the EU:
<em class="ph i">https://api.eu-1.smooch.io/v2/apps/{appId}/switchboards</em><p class="p">Replace
<em class="ph i">{appId}</em> with the App ID you noted above. </p>
</li>
</ul>
</li>
<li class="li">In <strong class="ph b">Auth Type</strong>, select <strong class="ph b">Basic Auth</strong>. </li>
<li class="li">In <strong class="ph b">Username</strong>, enter the key ID you noted above. </li>
<li class="li">In <strong class="ph b">Password</strong>, enter the secret key you noted above. </li>
<li class="li">Click <strong class="ph b">Send</strong>. </li>
<li class="li">Note the switchboard ID that's returned.<p class="p"><img class="image" id="topic_r3h_myq_ffc__image_hdl_lzq_ffc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/aiaa_postman_switchboard_ids.png" width="800"></p>
</li>
</ol>
<p class="p">Now that you have your switchboard ID, follow the instructions in the next section to
find your responder IDs.</p>
</div>
</div>
<div aria-labelledby="ariaid-title3" class="topic nested1" id="topic_uqv_myq_ffc">
<h2 class="title topictitle2" id="ariaid-title3">Finding your responder IDs</h2>
<div class="body">
<p class="p">Use the <a class="xref" href="https://docs.smooch.io/rest/#operation/ListSwitchboardIntegrations" target="_blank">List Switchboard Integrations</a> API call to
find your responder IDs. </p>
<p class="p"><strong class="ph b">To find your responder IDs</strong></p>
<ol class="ol" id="topic_uqv_myq_ffc__ol_pnf_c2r_ffc">
<li class="li">In Postman, use one of the following request URLs, depending on your region: <ul class="ul" id="topic_uqv_myq_ffc__ol_wby_f2r_ffc">
<li class="li">For the US:
<em class="ph i">https://api.smooch.io/v2/apps/{appId}/switchboards/{switchboardId}/switchboardIntegrations</em>
</li>
<li class="li">For the EU:
<em class="ph i">https://api.eu-1.smooch.io/v2/apps/{appId}/switchboards/{switchboardId}/switchboardIntegrations</em>
<p class="p">Replace <em class="ph i">{appId}</em> with the same app ID you noted above, and
replace <em class="ph i">{switchboardId}</em> with the switchboard ID you noted
above.</p>
</li>
</ul>
</li>
<li class="li">In <strong class="ph b">Auth Type</strong>, select <strong class="ph b">Basic Auth</strong>. </li>
<li class="li">In <strong class="ph b">Username</strong>, enter the key ID you noted above. </li>
<li class="li">In <strong class="ph b">Password</strong>, enter the secret key you noted above. </li>
<li class="li">Click <strong class="ph b">Send</strong>. </li>
<li class="li">Note the responder IDs that are returned.<p class="p"><img class="image" id="topic_uqv_myq_ffc__image_qh3_k2r_ffc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/aiaa_postman_responder_ids.png" width="800"></p>
</li>
</ol>
<p class="p">You now have your responder IDs, which you can use to update your integrations and
add or remove them from the AI agents workspace.</p>
</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/9200200370970",
"url": "https://support.zendesk.com/hc/en-us/articles/9200200370970",
"headline": "Finding your switchboard and responder IDs for AI agents",
"description": "You can find your switchboard and responder IDs for AI agents by using specific API calls with Postman, enabling you to manage default responders in your messaging channels.",
"articleSection": "Integrating other platforms with AI agents",
"datePublished": "2025-04-29T19:21:41+00:00",
"dateModified": "2026-05-12T17:48:58.450061+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/9200200370970"
},
"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>