Skip to main content

How to set up the Qomon <> New/Mode integration

This article explains how to integrate your Qomon and New/Mode spaces to sync data.

Written by Hendrik Giesecke

Connecting New/Mode to Qomon

New/Mode can automatically sync your supporters' data (first name, last name, email, address, phone number, and opt-in status) into your Qomon account. This guide walks you through connecting the two platforms and setting up your data mapping.

The setup has four parts:

  1. Start the connection from New/Mode

  2. Generate an API key in Qomon

  3. Paste the key into New/Mode to link your account

  4. Map your data and start syncing

Note: Connecting more than one CRM to the same New/Mode account requires New/Mode's Movement Builder plan or above.

Step 1: Start the integration from New/Mode

  1. Log in to your New/Mode account.

  2. In the left-hand menu, click Integrations.

  3. On the Integrations page, find the Qomon card and click Connect.

A modal window will open, asking you to link your account with an API Key and an API Subdomain. Keep this window open, you'll come back to it in Step 3.

Step 2: Generate your API key in Qomon

  1. Open a new tab and log in to your Qomon space.

  2. Click your profile in the bottom-left corner, then select Settings.

  3. From the settings menu at the top, click the Integrations & API tab.

  4. Under Generate API keys, click + Add.

  5. Give the key a recognizable name (for example, 'New/Mode integration') then click Generate.

  6. Your new API key will appear in the list. Click the copy icon next to it to copy the key to your clipboard.

⚠️ Important: Keep this key private. Anyone with access to it can connect to your Qomon data.

Step 3: Link your account in New/Mode

  1. Go back to the New/Mode tab from Step 1.

  2. Paste the API key you copied from Qomon into the API Key field.

  3. Choose the correct API Subdomain:

    • If your organization is based in the US, select incoming-us.

    • If not, leave the default option, incoming (default), selected.

  4. Click Link my account now. Linking can take a minute or two.

Once connected, New/Mode automatically fetches the fields available in your Qomon account so you can map your data. You only need to connect once.

Step 4: Confirm the connection and map your data

Once linked, you'll be taken to the Qomon integration page in New/Mode.

⚠️ Syncing is paused by default. No data will be sent to Qomon until you click 'Resume Syncing' at the top of the page. Set up your data mapping first (see below), then resume syncing.

From this page you can:

  • Check the Sync status to see which contacts are syncing, waiting to be synced, or have errors.

  • Set up the Data Mapping to choose which New/Mode fields go to which Qomon fields.

  • Click Update Properties to pull in any new fields you've created in Qomon.

  • Use Pause Syncing while making changes, then Resume Syncing when you're done.

  • Disconnect the integration if you need to remove it or set up a new one.

The integration is automatically connected to any new campaign you create in New/Mode. New submissions typically take 15–20 minutes to appear in Qomon.

Understanding the Data Mapping table

New/Mode pulls in the list of available fields from your Qomon account and lets you choose which New/Mode field should populate which Qomon property. The table has two columns:

  • New/Mode Data: the field coming from your New/Mode forms and contact records (for example, Honorific, First name, Last name, City, Street address).

  • Qomon Property: the Qomon field it will be mapped to (for example, salutation, first_name (standard), addresses.city (standard)).

Select any cell in the Qomon Property column to change its mapping using the dropdown, or click Add Row to map an additional field. The field list shows each field's data type (such as string or boolean) to help you match similar data. Use the trash icon to remove a mapping you don't need.

The Email address → email mapping is fixed and can't be edited, since email is used to match and de-duplicate contacts between the two systems.
​

💡 Tip: Field names marked "(standard)" are standard values that New/Mode translates to the matching Qomon field, so the name in the table may differ slightly from what you see in Qomon.

Mapping to a custom Qomon field

To send data to a field that doesn't exist yet in Qomon:

  1. In Qomon, create a custom field under Settings > Contacts / CRM.

  2. In New/Mode, click Update Properties on the Qomon integration page. New fields can take a few minutes to appear.

  3. Click Add Row and map your New/Mode field to the new Qomon field.

Remember to click 'Resume Syncing' once you're done making changes.

Default mapping behavior

When you first connect, New/Mode automatically maps the standard fields that exist in Qomon: honorific, first and last name, email, opt-in status, created and updated dates, full address (street, city, state/province, postal code, country, latitude and longitude), and phone number.

A few things to know:

  • Opt-in status: In the table, this appears as Opted in → subscribe_status (standard). It's sent to the black_list setting in Qomon, so supporters who haven't consented will have their consent appear as Refused on their contact card.

  • Tags: Tags you add to a New/Mode campaign (on the campaign's Edit page) can be mapped to Qomon tags. They appear in the Tags section of the contact card, and you can see how many contacts have each tag under Settings > Contacts / CRM > Tags.

  • Global mapping: The mapping applies to data from all of your New/Mode campaigns.
    ​

Note: Qomon also offers a more granular consent system that tracks opt-in and opt-out status per communication channel, rather than as a single flag. Support for this is planned in a future update to the integration.

Managing syncing per campaign

Each New/Mode campaign syncs to Qomon by default. To turn syncing on or off for a specific campaign, go to the campaign's Review & Launch page and use the switch in the Integrations block.

Troubleshooting and manual syncing

  • Check sync errors: The Qomon integration page in New/Mode shows the overall sync status and any error messages. For details on a specific contact, go to the Contacts tab in New/Mode's left-hand menu.

  • Re-sync contacts manually: In New/Mode's Contacts menu, select the contact(s) and click Sync contacts to CRM. Check Sync all campaign submissions to include their submission history.

  • Nothing is syncing? Make sure you've clicked 'Resume Syncing', and allow 15–20 minutes for new submissions to appear.

For advanced options like Key Value Pairings, source tracking, and mapping campaign IDs, see New/Mode's guide to syncing data to Qomon.

Once your mapping is set up and syncing is active, supporter data from your New/Mode campaigns will flow automatically into your Qomon database!

If you need any help, feel free to reach out at [email protected].

Related Articles
Did this answer your question?