Skip to main content

Karbon

Connect Karbon to Socket so your people and organisations sync in, and new prospects sync back out.

Written by Amy Mall

Connect Karbon with Socket to sync your People and Organisation records into Socket and sync new Prospects from Socket into Karbon.

The Karbon integration is available to practices in the United Kingdom, Ireland, and Canada. Setup is the same in each.

Step 1: Connecting Karbon to Socket

Go to Practice Settings in Socket, then Integrations. Here, you'll find the option to connect Karbon. Selecting this prompts you to enter an access key and an optional tenant key.

The Karbon connection form in Socket, with the Access Key and Tenant Key boxes

Getting your access key from Karbon

To find your access key, open Karbon and go to Settings, then Connected Apps. Locate Socket in the list and select Connect. This takes you to a dedicated Socket Connection page within Karbon, where you see a token. This is your access key. Select Copy to clipboard, then go back to Socket and paste it in the Karbon Access Key box.

The tenant key

The tenant key is optional but allows for deep linking, which means you can directly open a specific client or contact in Karbon from within Socket. You can find your tenant key in the URL of Karbon. It appears between the main Karbon domain and the following forward slash. Copy this code, without the hash symbol, and enter it in the Karbon Tenant Key box in Socket.

A Karbon URL with the tenant key highlighted between the domain and the next forward slash

Syncing clients and contacts

Once you have entered the access key and tenant key, select Save in Socket. This triggers the sync process, where Socket fetches your clients and contacts from Karbon. If you have thousands of records, this may take a few minutes, and you can leave the page and return later. For most users, syncing takes a few seconds. When the process is complete, Karbon displays as connected in Socket.

Step 2: Mapping contact types

After syncing, you see a message indicating that Karbon is connected. There is an optional step where you can Map Contact Types, which opens its own page under Integrations > Karbon.

If you have Contact Types in Karbon, map them to Socket. This makes sure the correct data is pushed between the systems. The page shows a row per Socket entity type and a column per Socket status. Select a cell and pick the Karbon contact types that belong there. Each status can take several, so a Karbon client whose type is any of them arrives in Socket with that status.

Where a status has more than one type, a Written to Karbon dropdown picks which of them Socket gives a new prospect or client when it pushes them to Karbon. A client already in Karbon under one of the other types is left as it is.

One Karbon type can't sit under two statuses in the same row. If it does, the row shows the clash and Save is disabled until you fix it. Apply to rows copies a mapping down the grid, with an Empty rows only option that leaves rows you've already filled alone.

The Map Contact Types page, with a row per Socket entity type, a column per status, and the Written to Karbon dropdown

Select Save and you land back on Integrations. Once connected, the button on the Karbon card reads Contact Types, which reopens the page.

Step 3: Managing clients in Socket

Once Karbon is connected, clients only appear in Socket when required. If you go to the Clients section and see "No clients found", this is normal. Clients are imported on demand, meaning you only see them appear for selection when you create a new Proposal.

Go to Start a New Proposal in Socket. Choose an existing client from the list. The data for People and Organisations from Karbon appears, with icons distinguishing between individuals and companies.

The Existing Client list in the proposal wizard, showing Karbon people and organisations with icons for individuals and companies

When you select a client, Socket recognises details like whether it's a limited company. You can adjust these details within Socket as needed. The contacts associated with the client are also imported from Karbon.

If a new client is already in Karbon

If you type a new client's name in the proposal wizard or on a lead form and Karbon already holds a record with that name that isn't linked to Socket, a warning names Karbon and offers two choices: Use the Karbon Record, which links the Socket client to that record so nothing new is pushed to Karbon, or Create New Anyway. You can still save the client. Choosing the client from your Existing Client list skips the check, since that record is already linked.

Syncing client data

Socket syncs data via webhooks from Karbon, so when client data is updated in Karbon it updates in Socket as well.

It can sometimes take a short time to reflect after the change is made. If the update doesn't show correctly, go into the client details, select External Links in the top right, select the edit icon next to the Karbon link, and then select Sync client.

The External Links panel on a client record, with the edit icon next to the Karbon link

The Karbon link editor on a client record, with the Sync client option

Creating work in Karbon from your proposals

As well as syncing clients and contacts, Socket can create work items in Karbon automatically when a proposal is confirmed. You map the services on your pricing menu to your Karbon work templates, and Socket creates a work item for each template linked to the services a client has taken.

See Creating Karbon Work Items from Proposals for how to set up the mapping and what to expect in Karbon.

Did this answer your question?