How to Obtain Agent ID, Agent Group ID, Contact ID, Contact Group ID, Message ID, Filter ID
In BoldDesk, identifying entities like agents, contacts, groups, and filters is key for workflows, automation, and integrations. This guide shows how to find IDs—Agent, Group, Contact, Contact Group, Message, and Filter—via UI and URLs. Admins and developers can use these IDs for smoother helpdesk management.
How to Obtain the Agent ID
The various ways to obtain the agent ID are discussed below.
From ID Field
To obtain the Agent ID, log in to the Agent Portal, go to Admin > Users & Permissions > Agents, and click on the agent you want to view. On the agent’s profile page, you’ll see a field labeled User ID — this is the Agent ID.
From URL
You can also find the Agent ID in the URL when viewing the agent’s profile. The URL will be in the format: https://yourdomain.bolddesk.com/agent/admin/agents/1016. The number at the end (1016) is the Agent ID.
Only users with Admin access can view the Agent ID. Regular agents do not have permission to access this section.
How to Obtain the Agent Group ID
The Agent Group ID is not shown in any visible field within the portal and cannot be directly viewed in the group profile or list. However, you can still find the Group ID through the URL. To locate it, go to Admin > Groups, then click on the desired group. In the browser’s address bar, you’ll see a URL like: https://yourbolddesk.com/agent/admin/groups/25. The number at the end (25) is the Group ID.
Only users with Admin access can view the Group ID. Regular agents do not have permission to access this section.
How to Obtain the Contact ID
The various ways to obtain the Contact ID are discussed below.
From ID Field
In the Agent Portal, go to the Contacts module to view the list of all contacts. Click on any contact to open their profile. On the contact’s profile page, you will find a field labeled User ID — this is the Contact ID.
From URL
You can also find the Contact ID in the URL when viewing a contact’s profile. The URL will be in the format: https://yourdomain.bolddesk.com/agent/contacts/1132. The number at the end (1132) is the Contact ID.
This process is only used by Admins to see the Contact ID. If an Agent wants to view the Contact ID, they can do so by clicking “View Profile” under the Contact Details section on the right side of the ticket.
How to Obtain the Contact Group ID
The various ways to obtain the Contact Group ID are discussed below.
From ID Field
In the Agent Portal, go to the Contacts module and select the Contact Groups tab to view the list of all contact groups. Click on any group to open its profile. On the group’s profile page, you will find a field labeled Contact Group ID.
From URL
You can also find the Contact Group ID in the URL when viewing a contact group’s profile. The URL will be in the format: https://yourdomain.bolddesk.com/agent/contact-groups/782
The number at the end (782) is the Contact Group ID.
This method is available only to Admins. If an Agent wants to view the Contact Group ID, they can do so by clicking “View Profile” under the Contact Group Details section on the right side of any one of the tickets.
How to Obtain the Filter ID
The various ways to obtain the Filter ID are discussed below.
Predefined System Filters
You cannot view the ID of predefined system filters directly in the UI. If you want to obtain the Filter ID for a system-defined filter, you need to export the filters. After exporting, open the Excel sheet — there will be a column labeled ID, which contains the Filter ID. This is the only method to identify the Filter ID for system filters.
Custom Filters
For custom filters, the Filter ID can be found in two ways:
- From the Exported Excel Sheet – similar to system filters, the ID is shown in the exported file.
- From the URL – when a custom filter is selected in the Tickets module, the browser URL will look like this: https://yourdomain.bolddesk.com/agent/tickets?brandids=all&page=1&filterid=1001. The number at the end (1001) is the Filter ID.
How to Obtain the Message ID (Update ID)
To obtain the Message ID, open any ticket in the Agent Portal. Inside the ticket, locate the specific ticket update (such as a comment or reply). Next to each update, you’ll find a “Share” icon (🔗). Click on this icon — a pop-up will appear with options to copy the message link for both the Agent Portal and the Customer Portal. The message ID will be displayed at the end of the URL once you copy.
At the top right of the ticket, there is also a “Share” icon. This is another way to access or copy the update reference.
How to Obtain the Field ID
You can obtain field ID via URL for Ticket fields, Activity fields, User fields, Contact Group fields, Chat fields, or Visitor fields. When you open a particular field, the Field ID may appear in the URL of your browser. For instance: https://yourdomain.bolddesk.com/agent/admin/fields/11. The number at the end (11) is the Field ID.
You can also obtain the chat fields ID under chat forms by clicking on the appropriate field. The ID will be visible from the URL.
