How to Locate Entity IDs in BoldDesk
In BoldDesk, every core entity—such as agents, contacts, groups, filters, fields, ticket updates, and chat conversations—is assigned a system‑generated unique ID. These IDs are essential for accurately configuring automations, building reports, troubleshooting workflows, and working with BoldDesk APIs.
This article explains how to locate commonly used BoldDesk IDs directly from the Agent Portal UI and supported browser URL patterns.
Use Cases
You may need entity IDs in BoldDesk when:
- Building or troubleshooting ticket automations
- Configuring reports and dashboards
- Querying or integrating with BoldDesk APIs
- Diagnosing issues with specific tickets, messages, or chats
- Referencing entities in support or internal documentation
- Managing large teams, contacts, or workflows programmatically
Finding the Agent ID
The various ways to obtain the agent ID are discussed below.
Navigation Path (Admin Only)
Admin → Users & Permissions → Agents
1: Agent Profile Field
-
Open the Agents list.
-
Select the required agent.
-
Locate the User ID field on the agent profile.
The User ID value is the Agent ID.
Browser URL
-
While viewing the agent profile, check the browser URL. The URL will be in the format: https://yourdomain.bolddesk.com/agent/admin/agents/1016.
-
The numeric value at the end of the URL represents the Agent ID.
Only users with Admin access can view the Agent ID. Regular agents do not have permission to access this section.
Finding the Agent Group ID
Navigation Path (Admin Only)
Admin → Groups
Browser URL
-
Open the required group.
-
Locate the numeric value at the end of the browser URL.
That value represents the Agent Group ID.
- Only users with Admin access can view the Group ID. Regular agents do not have permission to access this section.
- Agent Group IDs are not displayed as visible fields and are available only through the URL.
Finding the Contact ID
Navigation Path
Contacts → Open Contact Profile
The various ways to obtain the Contact ID are discussed below.
1: Contact Profile Field
-
Open the contact profile.
-
Locate the User ID field.
-
This value is the Contact ID.
2: Browser URL
-
The number at the end of the contact profile URL represents 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.
Agent Access from Tickets
Agents without Admin access can:
-
Open a ticket
-
Select View Profile under Contact Details/Requester Details
-
Use the profile view or URL to identify the Contact ID
Finding the Contact Group ID
Navigation Path
Contacts → Contact Groups → Open Group
The various ways to obtain the Contact Group ID are discussed below.
1: Contact Group Profile Field
-
Locate the Contact Group ID field on the group profile.
2: Browser URL
-
The numeric value at the end of the contact group profile URL represents 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.
Agent Access from Tickets
Agents without Admin setting permission can locate the Contact Group ID from:
Contact Group Details → View Profile within a ticket
Finding the Filter ID
The various ways to obtain the Filter ID are discussed below.
Predefined System Filters
-
System‑defined filters do not expose IDs directly in the UI.
-
To obtain a system filter ID:
- Export the filters
- Locate the ID column in the exported file
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.
Finding the Message ID (Update ID)
Navigation Path
Tickets → Open Ticket
-
Locate the required ticket update (reply or note).
-
Select the copy icon next to More option icon.
-
Copy the generated link.
-
The numeric value at the end of the URL is the Message ID.
Finding the Field ID
Navigation Path
Admin → Fields
Method
-
Open the required field.
-
The numeric value at the end of the browser URL represents 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.
Finding the Chat Conversation ID
Each chat conversation in BoldDesk has a unique Conversation ID, used for reporting, APIs, and troubleshooting.
You can obtain the Conversation ID in either of the following ways:
1: Browser URL
-
Open the chat conversation in the Agent Portal.
-
The Conversation ID appears as part of the URL.
2: Copy ID Option
-
Open the conversation view.
-
Select Copy ID to copy the Conversation ID to the clipboard.
These methods help agents and administrators accurately reference specific conversations without manually searching or extracting details.
Troubleshooting ID Visibility
Admin Pages Are Not Accessible
- The signed-in user does not have Admin permissions
System Filter ID Is Not Visible
- System filter IDs are available only via export
Agent Needs Contact or Contact Group ID
- Use View Profile from the ticket’s right-side panel
FAQs
-
Can entity IDs be edited or changed?
No. All IDs are system-generated and cannot be modified. -
Are Message IDs the same as Ticket IDs?
No. Message IDs identify individual updates within a ticket. -
Can non-admin agents view all IDs?
No. Some IDs are restricted to Admin users only. -
Are IDs required for API usage?
Yes. Most BoldDesk API operations require entity IDs.
