Skip to main content


Clearbit offers real-time intelligence across your stack to improve acquisition, conversion, & operations.

This integration adds quirks to Uniform that map to data from Clearbit. These quirks can be used to configure personalization instructions.

Add quirk definitions

  1. In Uniform, open your project.

  2. Navigate to the Integrations tab.

  3. Click Clearbit.

  4. Click Add to project.

  5. Navigate to Personalization > Quirks.

    About this step

    You will see a list of quirks that were added by the Clearbit integration.

Set quirks

You need to retrieve data from Clearbit and set that data into quirks. Uniform provides components you can use to do this without having to write code for Clearbit.

Before you start

You need a Clearbit API key in order to retrieve data from Clearbit. For information on how to locate your API key, see the Clearbit support site.

  1. Add the following package to your application:

  2. Add following code:

    import { 
    } from "@uniformdev/context-cdp-clearbit";

    const client = createClearbitClient({
    apiKey: "!!! YOUR CLEARBIT API KEY !!!",
    const quirks = await fetchClearbitQuirks({
    visitorIp: "!!! VISITOR IP ADDRESS !!!",
    quirksConfig: {
    company: {
    name: true,
    category: {
    sector: true
    About this step

    This code retrieves data from Clearbit using the specified IP address.


    For more information on the quirks that are available, see the package reference for the Clearbit integration.

  3. To add this data to the Uniform context so it can be used during classification and personalization, use the following code:

    const manifest = {};
    const context = new Context({ manifest });
    context.update({ quirks });
    About this step

    This code can be used anywhere you have access to the Uniform context (e.g. edge-side personalization).