Linking to Graphite

graphiteConnect supports deep links that navigate users directly to specific areas of the application — including connections, individual profile questions, and file fields. These links are useful for directing suppliers or internal users to the exact location of a question that requires attention.

Connection Links

The connections screen is the entry point for all information shared between your company and a supplier or customer.

A connection link is constructed from three components:

Component	Description	Source
Base URL	`https://app.graphiteconnect.com` (production)	Static
Entity ID	The entity ID of the connected company	Returned in the profile API call
Connection ID	The unique identifier for the connection	Returned in the connection section of the profile API call

Base Connection URL Format

https://app.graphiteconnect.com/connections/{entityId}/{connectionId}

Linking to a Specific Question

To generate a link that takes a user directly to a specific question within a supplier's connection profile, append the answerKey query parameter:

https://app.graphiteconnect.com/connections/{entityId}/{connectionId}?answerKey=W9_Document

Replace W9_Document with the answer key for the question you want to link to.

Linking to a Question in a Multiple Group

If a question is inside a multiple group (e.g., Bank Accounts, Locations, or ERP_Record), you must also include the instanceId parameter to identify which instance of the group to navigate to:

https://app.graphiteconnect.com/connections/{entityId}/{connectionId}?answerKey=Bank_Account_Number&instanceId=7a3c1f2e89b04d5a6e91c2f8

The instanceId value corresponds to the _id field of the specific group instance returned in the profile data.

File Object URLs

File objects in the profile data include a pre-built graphiteUrl field that links directly to the question associated with that file. You can use this URL as-is to direct users to a specific file question in the graphiteConnect UI:

{
  "fileId": "5f8a2c1e4b3d7f9a0c2e6b4d",
  "mimeType": "application/pdf",
  "fileName": "W9_Form_2024.pdf",
  "graphiteUrl": "https://app.graphiteconnect.com/connections/US1234/CONN5678?answerKey=W9_Document"
}

See File Data Layout for full details on file objects in the API.