Setup guide for TD SYNNEX Digital Bridge

TD SYNNEX Digital Bridge integrates TD SYNNEX pricing, inventory and ordering with HubSpot deals and products, so your team can quote and order from TD SYNNEX without leaving HubSpot.

Guide version 1.2 · Applies to the TD SYNNEX Digital Bridge app for HubSpot · Support: itdbridgesupport@tdsynnex.com

TD SYNNEX Digital Bridge lets HubSpot users:

Install the app

Before you begin

Connect your HubSpot account

  1. Log in to TD SYNNEX Digital Bridge.
  2. Navigate to Connector Bridge and open the HubSpot connector.
  3. Click Connect (under Manage Connection). You are sent to HubSpot.
  4. If you have several HubSpot accounts, select the one to connect and click Choose Account.
  5. Review the requested scopes on this screen. TD SYNNEX Digital Bridge requests access to read contacts; read and write companies, deals, line items and products; read line item property definitions; create deal properties; read owners; and e-commerce access. The permissions table explains what each one is used for.
  6. Click Connect app.
  7. You are redirected to Digital Bridge, where the HubSpot connector now shows the connection as active and the configuration options appear.

You can also start from HubSpot: go to Marketplaces, App Marketplace, search for TD SYNNEX Digital Bridge and click Install app. HubSpot sends you to Digital Bridge to sign in, then shows the same scope approval screen; continue from step 5.

Connecting links your whole HubSpot account, not just your user. One connection serves every HubSpot user in the account; nobody else needs a TD SYNNEX login.

Configure the app

In Digital Bridge

  1. In Digital Bridge, navigate to Connector Bridge and open the HubSpot connector.
  2. Turn on the features your team uses:
    • Get TD SYNNEX Products: pricing, inventory, suggested retail price and MAP price for the products on your deals.
    • Create Orders: electronic order submission from a deal.
    • Get Order Status: acceptance, release, shipment and tracking updates written back to the deal.
    • Invoice Sync: invoice numbers written back to the deal when TD SYNNEX invoices the order.
  3. Review the Integration Timeline and Sync Activity Log tabs; these are where sync results and errors appear later.

In HubSpot

Connecting adds the TD SYNNEX properties to deals and products and makes two cards available on deal records, TD SYNNEX Price & Availability and TD SYNNEX Orders. If the cards do not appear on your deals, a HubSpot admin adds them once for everyone:

  1. Open any deal and click Customize record (top right), then choose the deal record view your team uses.
  2. Click Add cards, filter by the TD SYNNEX Digital Bridge app, add TD SYNNEX Price & Availability and TD SYNNEX Orders, and save the view.

Use the app

Price and availability lookups and order submission are manual actions you take on a deal. Order status, tracking, ship date and invoice updates are automatic: Digital Bridge writes them to the deal as the order progresses at TD SYNNEX, with no action required in HubSpot.

Check price and availability

  1. On the deal, add the products you are quoting as line items. The product SKU is what TD SYNNEX uses to find the item.
  2. Open the TD SYNNEX Price & Availability tab and set TD SYNNEX Sync Price to Get TDS Price. Digital Bridge fetches current values from TD SYNNEX; they typically appear within a minute and the field changes to TDS Price Updated when done. Use the Refresh button at the top of the card if the table has not updated.
  3. Read the products table on the tab: name, SKU, TD SYNNEX inventory, suggested retail price, your net price and MAP price.

Set Sync Price again whenever you want fresh numbers, for example before sending a quote.

Submit an order

  1. Make sure the deal's line items, quantities, and associated company and contact are correct. These become the order.
  2. Open the TD SYNNEX Orders tab. Leave TDS Dropship at False to ship to your default address on file with TD SYNNEX, or set it to True to ship directly to the end customer and fill in the ship-to company, address, city, state, postal code, country and contact fields that appear. Hover the ? next to each section for help.
  3. Set Submit Order To TD SYNNEX to True. The order is transmitted electronically; the card shows the order as submitted and awaiting confirmation.

Track an order

When TD SYNNEX accepts the order, the Orders card switches to the order view: the status tag at the top shows the TD SYNNEX order status and the card lists the CPO ID (the order reference), ship date, tracking numbers and invoice number. From then on the card updates automatically: the status moves through TDS Received, TDS Accepted, TDS Released, TDS Shipped, TDS Invoiced and TDS Closed, and tracking numbers, ship date and invoice number fill in as they become available. The Refresh button re-reads the deal if a value has not shown up yet.

Submitting is a one-way action from HubSpot. To change or cancel an order after submission, contact TD SYNNEX through your usual order desk and reference the CPO ID shown on the deal.

Disconnect the app

Disconnecting stops all syncing between HubSpot and TD SYNNEX. Price lookups and order submission from HubSpot stop working, and order status, tracking and invoice updates no longer reach your deals. Existing values already written to deals and products remain on your HubSpot records, and orders already submitted to TD SYNNEX are not affected.

  1. Log in to TD SYNNEX Digital Bridge.
  2. Navigate to Connector Bridge and open the HubSpot connector.
  3. Under Manage Connection, click Disconnect.
  4. Confirm. The connector shows as disconnected, and HubSpot's access token for your account is revoked.

To reconnect later, follow Install the app again; your feature settings in Digital Bridge are kept.

Uninstall the app

To remove TD SYNNEX Digital Bridge from your HubSpot account, follow the uninstall instructions in HubSpot's Knowledge Base article Install apps in the HubSpot Marketplace: click the settings icon, go to Integrations, Connected Apps, click Actions on TD SYNNEX Digital Bridge, click Uninstall, type uninstall and confirm.

Uninstalling revokes the app's access to your HubSpot account and removes the TD SYNNEX cards from deal records. It has the same effect on syncing as disconnecting. The TD SYNNEX properties and the values already written to deals and products stay in HubSpot; if you no longer want them, delete the properties from Settings, Properties (this permanently removes those values from your records). Orders already submitted to TD SYNNEX are not affected, and TD SYNNEX keeps its own order records according to its retention policy.

Data, permissions and privacy

Data the app reads and writes

HubSpot objectDirectionWhat is used
DealsTwo-wayLine items and shipping details are read to build orders; order status, CPO ID, tracking, ship date and invoice number are written back.
Products and line itemsTwo-waySKU and quantity are read; TD SYNNEX inventory, suggested retail price, net price and MAP price are written to the product.
CompaniesTwo-wayRead to identify the ordering account; TD SYNNEX account details may be written back.
ContactsFrom HubSpotRead for the order contact. The integration never creates or updates contacts.
OwnersFrom HubSpotDeal owner is read to attribute orders.

Properties the app adds

ObjectPropertyInternal namePurpose
DealSubmit Order to TD SYNNEXtds_submit_orderSet by a user to submit the deal as an order.
DealTD SYNNEX Sync Pricetds_sync_priceSet by a user to refresh pricing and availability.
DealTD SYNNEX Order Statustds_order_statusWritten by TD SYNNEX as the order progresses.
DealTD SYNNEX CPO IDtds_cpo_idOrder reference assigned by TD SYNNEX.
DealTD SYNNEX Tracking #tds_tracking_numbersCarrier tracking numbers once shipped.
DealTD SYNNEX Invoice #tds_invoice_numberInvoice number once invoiced.
DealTD SYNNEX Ship Datetds_ship_dateShip date once shipped.
DealTD SYNNEX Dropship and ship-to fieldstds_dropship, tds_ship_company, tds_ship_address1, tds_ship_address2, tds_ship_city, tds_ship_state, tds_ship_postal, tds_ship_country, tds_ship_contactDirect-to-customer shipping details.
ProductTD SYNNEX Inventory, Suggested Retail Price, Net Price, MAP Pricetds_inventory, tds_sug_retail_price, tds_net_price, tds_map_priceValues returned by a price and availability sync.

Permissions the app requests

ScopeWhy the app needs it
crm.objects.deals.read, crm.objects.deals.writeRead deals to build orders and sync requests; write order status and references back.
crm.objects.line_items.read, crm.objects.line_items.write, crm.schemas.line_items.readRead the products and quantities on a deal; update line item values.
crm.objects.products.read, crm.objects.products.write, e-commerceMatch products by SKU and write pricing and inventory to them.
crm.objects.companies.read, crm.objects.companies.writeIdentify the ordering account and keep account details in sync.
crm.objects.contacts.readIdentify the order contact.
crm.schemas.deals.writeCreate the TD SYNNEX deal properties listed above.
crm.objects.owners.readAttribute orders to the deal owner.
oauthStandard HubSpot app authorization.

Data and privacy

When you submit an order or request pricing, Digital Bridge transmits the relevant deal data (line items, quantities, the ordering company and contact, and ship-to details when drop-shipping) to TD SYNNEX to fulfil the request, and writes the results back to HubSpot. Your TD SYNNEX credentials stay with TD SYNNEX; HubSpot holds only an authorization token for the app, which you can revoke at any time by disconnecting or uninstalling. TD SYNNEX processes this data under its privacy policy and your TD SYNNEX customer agreement.

Troubleshooting and support

SymptomWhat to check
The TD SYNNEX tabs are missing on dealsAdd the cards to the deal record view (see Configure the app). Confirm the app is listed under Settings, Integrations, Connected apps.
The tab shows "Unable to load TD SYNNEX order details"Refresh the record. If it persists, the user may lack permission to view the deal's properties; ask a HubSpot admin to check property access.
Sync Price does nothingConfirm the product SKUs match TD SYNNEX part numbers and that Get TD SYNNEX Products is enabled in Connector Bridge. Check the Sync Activity Log there.
Order Submitted never gets checkedConfirm Create Orders is enabled, the deal has line items, and the company and contact are associated. Check the Integration Timeline for a rejection reason.
Status, tracking or invoice stop updatingThe HubSpot connection may have been revoked (for example by a user who left). Reconnect from Connector Bridge following Install the app.

Still stuck? Email itdbridgesupport@tdsynnex.com with your HubSpot account ID (Settings, Account defaults), the deal URL and, for orders, the CPO ID.