BoldDesk provides multiple workflows for adding contacts manually, during ticket creation, via CC fields, automatically from customer interactions, and through the BoldDesk REST API. Contacts in BoldDesk are managed at the organizational level and are shared across all brands. As a result, contacts cannot currently be mapped to, restricted to, or managed separately for individual brands. At this time, no plan or configuration option supports brand-specific contact association.
This guide explains each method in detail, along with required permissions and built‑in validation rules that ensure clean and accurate contact data.

Adding a New Contact Manually From the Contact Module

To add a new contact from the contact module, follow the given steps:

1. Open the Contact module.

2. Click the Add Contact button on the top right to open a dialog.
   

   
   
   

3. Fill in all the required fields and click the Add button.

Adding Contacts When Creating Tickets in the Agent Portal

When creating a ticket, you can add a new contact with minimal fields. Follow the steps below to add a contact when creating a ticket:

1. Go to the Create Ticket page.

2. Click the Add new contact button under the Requester field.
   

   
   
   

3. Fill out the details and click the Create button.
   

   
   
   

A new contact will be created along with a ticket.

Adding Contacts While Adding CC

On the create ticket and ticket detail pages, you can add a new contact as the ticket’s CC.

1. Go to the Create Ticket page.

2. Click the Add new contact button to the right of the CC field.
   

   
   
   

3. A dialog box will appear, prompting you to enter your name and email address.

4. Click the Add button.
   

   
   
   

A new contact will be added, and a CC will be included on the ticket.

Adding Contacts Automatically

If a contact reaches out via email, web forms, or widgets, they will be automatically added into the system as contacts. However, the contacts will not be verified automatically. Agents can verify contacts manually or send verification links to them.

Adding Contacts Via API

You can use BoldDesk REST APIs to add contacts to your BoldDesk account. Refer here on How to Add Contact Using API to add a contact using API.

Built‑In Contact Validation Rules in BoldDesk

BoldDesk performs automatic validations during contact creation to maintain clean, duplicate‑free records.

• Email Duplicate Check (Strict Validation)
  If the email entered already exists in BoldDesk, the system:

  • Displays an alert indicating the email is already in use
  • Prevents the creation of the contact

This protects against duplicate contact records.

• Contact Group/Organization Validation
  To ensure accurate mapping:

  • Search and select the correct Contact Group/organization when adding a contact manually.
  • When adding via API, validate using the List Accounts API before submitting.
  • In the UI, BoldDesk auto‑suggests matching organizations as you type.

• Domain-Based Auto‑Matching
  If the contact’s email domain matches the domain associated with a Contact Group/organization:

  • BoldDesk automatically links the contact to that organization.

These rules ensure that contacts and organizations are always properly aligned.

Contact Email Uniqueness in BoldDesk

• Each contact (requester) has exactly one email field (no secondary emails).
• Email addresses for contacts are globally unique across the entire helpdesk (all brands).
• A contact may be created without an email (a phone‑only contact).
• The same person may have multiple contact records, but each record must use a different email address.
• Two or more contacts cannot share the same email. Creating or updating a contact with an email that already exists is blocked.
• Email is the unique identifier for email‑based ticketing and requester matching. Enforcing uniqueness prevents misrouting and unintended cross‑contact merges.

Frequently Asked Questions

1. What happens if an agent enters an email address that already exists in BoldDesk?
   BoldDesk blocks the operation. The UI displays an alert indicating the email is already in use, and the contact cannot be created.

2. Can contacts be restricted to a single brand in BoldDesk?
   No. Contacts are managed at the organization level and are shared across all brands. There is no configuration option or API override for brand-specific contact association.

3. Can a contact be created without an email address?
   Yes. BoldDesk allows phone-only contacts (contacts created without an email).

4. Can two contacts share the same email address?
   No. BoldDesk enforces global uniqueness of contact email addresses across the entire helpdesk (all brands). Duplicate emails are blocked on create or update.

5. Are contacts automatically created from email/web forms/widgets automatically verified?
   No. Automatically created contacts are not verified automatically. Agents must verify contacts manually or send verification links.

6. What permission is required to add a new contact during ticket creation?
   The agent must have Add new contact at the time of ticket creation permission enabled.

7. What permission is required to add contacts using the BoldDesk REST API?
   The agent must have Create or Edit Contact permission enabled.

8. Can BoldDesk live-sync contacts with Google Workspace?
   BoldDesk does not provide native live-sync with Google Workspace. Use a third-party integration (for example, Zapier or Make) or a custom API integration. CSV import supports periodic updates but not real-time sync.

Related Articles

1. How to Verify a Contact Manually
2. How to Send Verification or Invitation Emails to Contacts
3. How to Add and Edit Contacts in BoldDesk