Finding your switchboard and responder IDs for AI agents

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.


What's my plan?






All Suites

Team, Growth, Professional, Enterprise, or Enterprise Plus









Support

Team, Professional, or Enterprise







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.
In this scenario, you can use two APIs in combination to find all of your Zendesk
instance’s available responders and their corresponding IDs.


Note: This guide uses Postman. If you don't have Postman, you can sign up for
an account on the Postman website and download the app.

This article contains the following topics:

Finding your switchboard ID
Finding your responder IDs

Related articles:


Setting per-channel default responders using an
API call in Sunshine Conversations

Getting a list of integration IDs from messaging
without connecting to AI agents



Finding your switchboard ID

Use the List Switchboards API call to find your
switchboard ID. The switchboard is automatically created when you deploy messaging on your Zendesk instance.
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.
To find your switchboard ID

In Admin Center, click
Apps and integrations in the sidebar, then select APIs > Conversations
API.
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. For help, see Using the Conversations API
keys.

Note the following information:
App ID
Key ID

Secret key

Note: 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.





In Postman, use one of the following request URLs, depending on your region:
For the US:
https://api.smooch.io/v2/apps/{appId}/switchboards

For the EU:
https://api.eu-1.smooch.io/v2/apps/{appId}/switchboards Replace
{appId} with the App ID you noted above.



In Auth Type, select Basic Auth.
In Username, enter the key ID you noted above.
In Password, enter the secret key you noted above.
Click Send.
Note the switchboard ID that's returned.


Now that you have your switchboard ID, follow the instructions in the next section to
find your responder IDs.



Finding your responder IDs

Use the List Switchboard Integrations API call to
find your responder IDs.
To find your responder IDs

In Postman, use one of the following request URLs, depending on your region:
For the US:
https://api.smooch.io/v2/apps/{appId}/switchboards/{switchboardId}/switchboardIntegrations

For the EU:
https://api.eu-1.smooch.io/v2/apps/{appId}/switchboards/{switchboardId}/switchboardIntegrations
Replace {appId} with the same app ID you noted above, and
replace {switchboardId} with the switchboard ID you noted
above.



In Auth Type, select Basic Auth.
In Username, enter the key ID you noted above.
In Password, enter the secret key you noted above.
Click Send.
Note the responder IDs that are returned.


You now have your responder IDs, which you can use to update your integrations and
add or remove them from the AI agents workspace.


{
"@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"