This article discusses the CRM integrations. You need to be an Ideas Advanced customer to access these integrations. Please contact us if you would like a live demo or would like to try using it in your account.

Longtime Aha! Roadmaps and Aha! Ideas customers (accounts created before August 31, 2021) will continue to have access to Salesforce and Zendesk integrations, but will need to upgrade to Ideas Advanced to take advantage of organization imports and field mapping.

Aha! Roadmaps | Integrate with Salesforce (Advanced plan)

Ideas are the key to innovation. You need a continuous cycle of ideas, feedback, and requests to keep growing and improving. From live conversations with your customers to product suggestions, idea collection helps you understand exactly what people need, and in turn, how you can implement change that delights them and grows your business.

Some customers share directly in your ideas portal. But valuable feedback and customer insights can come from other channels, too. Sales and support teams are ideally situated to pass along the ideas your customers are passionate about — plus details about the customer relationship — from their own Customer Relationship Management (CRM) tool.

If you have enabled Ideas Advanced in your Aha! account, the Salesforce integration gives teams at your company the info they need from the tools where they are most comfortable. Team members who work mostly in Salesforce can create and view ideas without ever leaving Salesforce, and capture feedback that you otherwise might miss. Product teams in Aha! Roadmaps can see can see feedback alongside customer context — like industry, annual revenue, region, or employee count — without leaving Aha! Roadmaps.

As you prioritize and deliver on the best ideas, the Aha! idea status will be kept up-to-date in Salesforce. This allows you to communicate valuable updates back to customers. And, as sales and support teams update customer information in Salesforce accounts, that flows into Aha! organizations — so you always have the latest customer details in Aha! Roadmaps to inform your plans.

Note: If you are an Ideas Advanced customer, you also have access to dynamic ideas submission forms. Dynamic forms work with this integration, too! This means your sales and support teams can use dynamic forms to capture more detailed customer feedback.

In this article, we will walk through how to create and configure the Salesforce integration. You can also read more about using Salesforce to gather customer feedback and enable proxy voting in a private ideas portal so internal teams can vote on behalf of customers.

Note: Your Salesforce edition must have API access to use this integration.

Click any of the following links to skip ahead:


Integration type

  • Two-way*

Aha! Roadmaps level

  • Account level

Required user permissions:

Associated records

Aha! Roadmaps

  • Ideas

  • Organizations*


  • Accounts

  • Opportunities

  • Cases

*Accounts (Salesforce) Organizations (Aha!) is a one-way sync.



Integrating Aha! Roadmaps and Salesforce involves several steps in both tools, so it can be helpful to walk through the integration procedure at a high level.

To start the process, you need to install the most recent Aha! Roadmaps package in your Salesforce account. This package creates a custom object in your Salesforce account that you can use to create or link to ideas in Aha! Roadmaps.

Next, you need an ideas portal. Salesforce records (accounts, opportunities, or cases) will link to Aha! Roadmaps records (ideas) in this portal. The Aha! Roadmaps ideas portal needs to be a private portal and have single sign-on (SSO) configured. A private portal will keep your Salesforce users' ideas private, and an SSO configuration will give them access to the portal, and not to your Aha! Roadmaps account.

If you plan to import customer information from Salesforce into organizations in Aha! Roadmaps, you need to determine which fields from Salesforce that you want to import, and configure your organizations custom layout in Aha! to include corresponding fields.

So far you have created a way for Salesforce and Aha! Roadmaps records to link together. The next step is to link the two accounts to each other through an account-level integration in Aha! Roadmaps and map fields to import organization data from Salesforce.

With records and accounts linked, the last step is to give Salesforce users the appropriate user permissions to access and use the integration. That done, you will have successfully integrated Aha! Roadmaps and Salesforce — and can start capturing feedback through a new channel.


Install the Aha! Roadmaps package in Salesforce

  1. Log into your Salesforce instance, then click on this link to install the latest version of the integration. This link is always to the latest version. If you already have the integration installed, this will upgrade your package to the latest version while preserving your existing data. Note: If you are setting up this integration with a sandbox account, you may need to manually change the login URL to Salesforce.

  2. You will see a page describing the package. Choose to grant access to the users who should be able to manage ideas for the connected ideas portal, including creating, editing, and deleting ideas. Often people select users with administrator permissions in this step. Then, click Install. It may take a minute or two for the installation to complete.


Create an ideas portal in Aha! Roadmaps

To link ideas between Aha! Roadmaps and Salesforce, you will need a new Aha! Roadmaps private idea portal with single sign-on configured. You can have multiple idea portals that display the same ideas by selecting the same workspaces when configuring each portal. (Don't worry, you can manage all the ideas in one place).

To create a new ideas portal, navigate to Settings ⚙️ Account Ideas portals , or Ideas Overview . From either page, click Add ideas portal to open the portal builder.

The ideas portal builder is a three-step process:

  1. Select a Title for your portal. Click Next to continue.

  2. Click the color icon to select a theme color or enter your own custom color using a hex code. Your theme color affects links and buttons in your ideas portal. Click Edit to edit your choice or Next to continue.

  3. Select your portal's Access level. Portals can have Public or Private access, corresponding to the public and private types of portals. For this integration, select Private access. The portal should be a Private portal so that only Aha! Roadmaps and Salesforce users can see the ideas

Click Create portal to create your portal.


Adjust your portal settings

Once you have created your ideas portal, the portal settings will open in a new browser tab.

From the Overview General settings:

  • Choose a Portal URL.

  • Choose each of the Workspace(s) that you want your Salesforce users to be able to create ideas for.

From the Users SSO settings:

  • Use the Identity provider dropdown to select JSON Web Token. This will allow Salesforce users to access ideas in Aha! Roadmaps without any additional login process. In the Remote login URL enter “”.

  • Leave the Remote logout URL empty.

  • Click Enable SSO to save your selection.


Configure custom fields for organizations

To link your Salesforce accounts to your Aha! Roadmaps organizations, you may want to add new custom fields to your organizations in Aha! Roadmaps. This provides a place for customer information from Salesforce to populate when you import customer information from Salesforce. Once you have imported details about your customers, you can use that data to group customers into segments.

  1. Navigate to Settings ⚙️ Account Custom fields. You will need to be an administrator with customizations permissions to do this.

  2. Click the Organizations tab and then click Add custom field.

  3. Select the type of field you want to add, and then click Next.

  4. Enter the field details.

  5. Click Create to create your field.

You may want to add the integrations field to your organizations layout at this time. It will provide a link from the Aha! record to its corresponding record in Salesforce.


Add the Salesforce integration in Aha! Roadmaps

The next step is to link your Aha! Roadmaps account to Salesforce. This lets your Salesforce users create an Aha! Roadmaps idea (or link to an existing idea) without leaving Salesforce and allows you to import customer information into organizations.

In your Aha! Roadmaps account, go to the Settings ⚙️ Account and click the + icon next to Integrations. Click on the green + Salesforce button to add a Salesforce integration. Then follow the steps to finish setting up the integration.

Configuration notes:

  • You can have more than one Salesforce integration in Aha! Ideas.

  • Only one ideas portal can be used for each Salesforce integration. If you have more than one ideas portal you want to use to capture ideas through the same Salesforce account, set up an additional integration.

  • If you want to integrate with multiple Salesforce accounts, you can create multiple Salesforce integrations in one Aha! Ideas account as long as each integration is for a different ideas portal.

  • You cannot link multiple Salesforce accounts to a single portal.

  • You cannot link one Salesforce account to multiple Aha! Ideas domains.

  1. Start: Add a name to your integration and click Save and continue.

  2. Configure sandbox (optional): If you are using a Salesforce sandbox, enter the host here. If you are not using a sandbox, leave the field blank. Click Save and continue to continue.

    Note: Use the Salesforce Classic sandbox domain, which ends in

  3. Authorize: Click the Authenticate button. The Salesforce login screen will appear. Enter your user credentials to log in. The Salesforce user that authenticates here will be used for posting changes to the status of ideas visible in Salesforce. This user must have permission for all opportunity, case, and account records that will be linked to your Aha! Roadmaps account. Click Allow on the next screen to finish authenticating Salesforce. Then, click Save and continue.

  4. Capture ideas: Check the box next to Enable capturing ideas and select the ideas portal that you would like to connect to Salesforce. Salesforce ideas will be created in the Aha! Roadmaps portal you select. Then click Save and continue.

  5. Mappings: In this step, you will map the fields from your Organization (Aha!) record type to your Account (Salesforce) record type that you want to include in your integration. Click Field mapping to begin mapping fields.

    Note: You must install the most current Aha! Roadmaps package in Salesforce before mapping data for the integration to update properly.

    1. Start by mapping the Aha! organization 'email domain' field to an equivalent field in Salesforce. This will automatically associate your customer portal users to the correct organizations. This is not a standard field in Salesforce and may require that your Salesforce admin create this field and populate it with the appropriate email domain(s).

    2. Continue configuring your field mappings by selecting the Aha! field on the left with the desired Salesforce field on the right. Fields in Aha! that contain preset list values will require additional configuration. To ensure each part of these fields are mapped appropriately, open the configure modal for the field by clicking ⚙️ Configure. In the Configure modal, matching values are automatically mapped and you can manually rearrange values as needed. Values may map one-to-one or one-to-many.

    3. Click Save and continue to save your mappings.

      Note: Organizations data is a one-way sync from Salesforce to Aha! Ideas. Only data from mapped fields will sent to Aha! Ideas and any changes you make to organization fields in Aha! will not be reflected in Salesforce.

  6. Enable: On the final screen of your integration setup, you will see two options for importing data from Salesforce.
    Approve new records before importing: If your Salesforce integration is configured to approve new records before importing, account data will not be imported into Aha! until it is approved in the Settings ⚙️ → Integration updates window. Clear the workspace filter to review new organizations prior to import.
    Automatically import new records: This is the default option. If this setting is enabled, new organizations will be automatically imported when the account in Salesforce is created or updated.

    After selecting an import option, click Enable integration.


Give all Salesforce users permission to use the integration

In Salesforce Lightning:

  1. In Setup, under Administration, expand Users.

  2. Click on Permissions Sets.

  3. Click on the Aha! Permission Set.

  4. Click on the Manage Assignments button at the top of the screen.

  5. Select all users (or all users who should have access to the integration) and click Add Assignment.

In Salesforce Classic:

  1. Under Manage Users, select Permission Sets.

  2. Click on the Aha! Permission Set.

  3. Click on the Manage Assignments button at the top of the screen.

  4. Select all users (or all users who should have access to the integration) and click Add Assignment.


Add Aha! Roadmaps ideas to your Salesforce user interface

Aha! Roadmaps and Salesforce are now completely integrated. The last step is to make these new capabilities visible in the Salesforce user interface. You can do this for Salesforce opportunities, cases, or accounts.

Note: The Aha! Roadmaps idea visibility settings will affect an idea's visibility as a Salesforce record. So, for example, if you set an idea to hidden in your portal, or merge a visible idea with a hidden one, the linked Salesforce record will not be visible either.

Salesforce Lightning

  1. From the Object Manager, select Opportunity.

  2. Select Lightning Record Pages.

  3. If you need to create a New record page:

    1. Select Record page. Click Next.

    2. Give your new Lightning page a Label and an Object (in this case, we will use the Opportunity object). Click Next.

    3. Choose a template for your page. Click Finish.

    4. Create your record page to match your account's needs. Add Aha! Ideas from the Custom - Managed section.

    5. Click Save to save your changes.

    6. Click Activate to activate your new page.

  4. If you are editing an existing record page:

    1. Select your record page from the list.

    2. Click Edit to edit the page layout.

    3. Add Aha! Ideas from the Custom - Managed section.

    4. Click Save to save your changes.

    5. Click Activate to activate your new page.

The integration is now installed! You can repeat this process for accounts and cases, if you choose to.

Salesforce Classic

  1. Open an opportunity. On the opportunities screen, click on the Edit Layout link at the top of the page.

  2. You will see the controls for editing the layout. Under Visualforce Pages, there is a new page for Aha! Opportunity Ideas. You can drag this onto the page where you want it to appear. It can be helpful to add a section that you can place the page into. The default height and settings for the page do not need to be modified.

  3. Save the edited layout.

  4. Repeat these last three steps on the Cases page so that ideas can be linked to cases.

  5. Repeat the same three steps on the Accounts page to allow ideas to be linked directly to your account.

The integration is now installed! You can repeat this process for accounts and cases, if you choose to.


Upgrade from Classic to Lightning

If you integrated Aha! Roadmaps and Salesforce when you were on Salesforce Classic, and have since upgraded to Salesforce Lightning, you may need to take an extra step to ensure that you use the latest, Lightning-ready integration package.

  1. Log into your Salesforce instance, then click on this link to install the latest version of the integration.

  2. You will see a message similar to this one: "An earlier version is installed. It can be upgraded while preserving the existing data."

  3. Choose whether to install the integration for Salesforce Admins Only, for All Users, or for Specific Profiles.

  4. Check the box to acknowledge that you are installing a Non-Salesforce Application.

  5. Click Upgrade.

  6. The package will upgrade. This may take a couple minutes.

  7. Once you see the Upgrade Complete! message, click Done.

When you click Done, you will automatically navigate to the Installed Packages section of your Salesforce account, where you can see the Aha! Integration package.

  • By default the Aha! Ideas package for Salesforce Classic will still be among your Installed packages. You may wish to uninstall it.

  • All your originally linked ideas will still appear in your Salesforce records' layouts, and you will see Aha! Ideas in the Custom - Managed section of your Lightning Record Pages.


Upgrade your Salesforce integration

Some updates to the Salesforce integration will require you to reinstall the integration package before you can use those capabilities. For example, the most recent version of the integration supports data syncing between your Salesforce and Aha! Ideas account.

If you need to update your Salesforce integration to take advantage of a recent improvement, follow these steps:

  1. Install the latest Aha! Ideas package in Salesforce.
    Note: You must install the most current Aha! Ideas package in Salesforce before configuring your integration to upgrade successfully.

  2. Configure your organizations custom layout.

  3. Configure the organizations mappings for your integration.

  4. Save your changes to enable the updated integration.

Note: If you have already been capturing ideas on accounts in Salesforce, your organizations will already be linked to Salesforce accounts for you. When you import accounts from Salesforce, it will automatically link to existing organizations in Aha! Ideas that have the same name.


Automatic updates

As work is done in Aha! Roadmaps on an idea, status changes will be automatically updated in Salesforce. Whether it is a sales opportunity or support case, the team will know if the idea has been planned, is in progress, or has been shipped.

To get the most out of this integration, we recommend you create Salesforce triggers and reports. Triggers will proactively notify sales and support teams of any status changes. This is important if a customer is waiting for a certain feature to go live before signing up. Reports will provide insight into the impact of ideas on revenue increase or decrease.


If you get stuck, please reach out to our Product Success team. Our team is made up entirely of product experts and responds fast.

Aha! Ideas
Aha! Roadmaps
      Aha! Develop