Creating an Integrations Application and Inviting a Developer to the Developer Portal

Learn how to create an integrations application and invite a developer to the developer portal.

Written By Grainne Reidy (Super Administrator)

Updated at May 27th, 2025

Introduction

Centralised Integration Management

AIQ now lets you create and manage your API Integrations at group level. This means that you can create and configure an App in minutes, which can read and write data in all the entities within your group. You can edit an App and modify the entities it has access to at any time with immediate effect, as well as revoke access to the application completely, all through the user interface, without technical assistance.

OAuth 2.0 Authentication

This new feature has been built using OAuth 2.0, the industry-standard protocol for authentication and authorization. Unlike our current Token-based authentication method, connecting to AIQ SOAP API using Integration Applications does not require a Partner Key and User Key to work. Most importantly, it is not tied to a normal system user and does not allow interactive login, hence, no more ad-hoc users are needed for that purpose.

Developer Portal

After an Integration Application is created, the developer linked to the App will receive an email invitation to sign up to our brand-new Developer Portal. There they can access the App credentials, all relevant information about how to connect with our new SOAP API endpoint, the list of entities assigned to the App, and links to our API Wiki and Docs.

Availability

Integrations Applications and the Developer Portal are only available to customers on the AIQ3 Product Plan. If you would like to discuss switching to the AIQ3 Product Plan, please contact sales@accountsIQ.com.

See:

Using the Developer Portal and New API Endpoint 

API-Oauth Developer Portal 

 
 

Current Integrations Available

We have three categories of integrations: new integration, AIQ Integrate, and AIQ Connectors. 

New Integration

Create a new integration application for your organisation or build a partner integration which we can make available to AIQ customers through our integration ecosystem.

AIQ Integrate

AIQ Integrate, our Managed Service, automates workflows by connecting to multiple third-party applications. By eliminating repetitive tasks, it frees up time for more valuable work! 

  • AIQ Custom Integration is a custom-built integration from any file or application not covered by the other tiles shown.
  • Bill.com is a cloud-based software leader that streamlines and automates back-office financial processes for small and mid-sized businesses across various industries.
  • SAP Concur is a top-tier expense management system trusted by large organisations worldwide for comprehensive expense management. It seamlessly integrates with Concur Invoice for Accounts Payable solutions.
  • Effortless expense management software, ExpenseIn consolidates expense creation, approval, and reporting into a user-friendly system.
  • Expensify is a powerful platform for managing company spend, covering everything from receipt scanning to expense management, bill payments, and travel bookings. It offers valuable insights into spending patterns.
  • GoCardless simplifies payment collection from customers without imposing expensive fees.
  • HotSoft PMS (Project Management System) is a leading cloud-based solution tailored for hotels and accommodation providers, delivering seamless project management.
  • HubSpot is an all-in-one CRM platform that provides tools for marketing, sales, customer service, and content management.
  • Joblogic is a cloud-based Field Service Management Software designed specifically for service and maintenance contractors, offering a comprehensive solution.
  • MarketMan is a cloud-based inventory management software designed for restaurant and hospitality operations of all sizes.
  • OPERA property management solutions empower hoteliers to streamline reservations, loyalty programs, sales, and catering, enhancing guest service and profitability.
  • ProcureWizard offers a comprehensive purchase-to-pay solution designed specifically for the restaurant, hotel, pub and catering industries, covering purchase orders and invoicing, menu, and recipe costing, as well as allergen and nutritional analysis requirements.
  • Salesforce helps businesses keep track of customer interactions and sales data. It can manage leads, contacts, opportunities, and cases. Salesforce also offers several features to help businesses automate their sales and marketing processes, such as email marketing, lead capture, and lead scoring.
  • Access PaySuite offers secure and cost-effective Direct Debit services to businesses of all sizes.
  • Soldo is the prepaid Mastercard company card that simplifies business expenses, enabling control, tracking, and reporting in one place.
  • Stripe is a secure payment processing platform that facilitates online and credit card payments, supporting various payment options.
  • Syrinx, listed in Inc. 5000's fastest-growing companies, provides award-winning hire and asset management solutions to thousands of businesses globally.
  • Zoho Expense is an online expense reporting software that automates expense recording, simplifies reporting, streamlines approvals, and enhances control over business expenditures.

AIQ Connectors

Choose an out of the box connector to connect automatically with AccountsIQ from a third-party product with no coding required.

  • Streamline your expenses and accounting solutions today. Reduce the time spent recording and managing business expenses by integrating AccountsIQ with ExpenseIn.
  • Streamline your workflow by seamlessly pulling customer account and transactional data directly from AIQ into Salesforce. Enhance your customer management and sales strategies with real time financial data. Activate this connector now to unlock a smoother, more efficient way to manage your customers.
 
 

Setting up the Integration Admin

The Integration Admin

The Integration Admin is someone at your company who is familiar with the scope of the integration and will set up and manage it. Only Practice Admins can set up Integration Admins. If the desired Integration Admin is a Practice Admin, they will have permission to manage integrations by default. Otherwise, follow the instructions below.

Setting the Integration Admin User Permission

  1. In the group layer, go to the Users tab.
  2. Find the user who will be the Integration Admin and select Edit from their Actions dropdown. If they don't exist yet, click New User and create them. See Setting Up System Users for more details.
  3. In the relevant screen, enable the permission Manage Integration Applications. 
  4. Click Process.
 
 

Create an Integration Application and Send Invite to the Developer Portal 

Once the Integration Admin has the correct permissions (see previous section), they will have Integration Applications available as a menu option in the group layer.

  1. In the group layer, go to Setup > Integration Application

  2. Click New Integration Application.
  3. Select an Integration Type, either:
    •  New Integration: Create a new integration or build a partner integration that can be made available to other AIQ customers. 
    • AIQ Integrate: These are charged integrations managed by our team.
    • AIQ Connectors: Select for an out-of-the-box no coding required option.
  4. Click Next.

Option One: New Integration

  1. To configure a New Integration, complete the following details:
    • Name: This is a mandatory field. It is used to identify the integration application in the list of apps and will be shown within the Developer Portal. You cannot change this later and it must be unique across all clients. 
    • Description: This is a mandatory field.  It is used to store a longer description of the integration app and its use. This will be shown within the Developer portal. Ensure it is meaningful.
    • Category: Select from our range of application types.
    • Developer Email: This is the email that will receive an Invite to access the Developer Portal to extract the credentials and information to create the integration itself (ClientId, ClientSecret, WSDL endpoint, etc).
    • API Permissions: Integrations can either Read or Read & Write information. You cannot change this later.
       
  2. Select the entities this app can have access to via the API. You can change these later, if necessary, with immediate impact on the Integrations running for this App.
  3. Click Create. 
  4. A confirmation message will appear with instructions for verification. Click Copy and follow the instructions to send the OTP (One-Time Password) to the developer by a different mechanism than email (i.e., SMS, WhatsApp message, Phone call).
     
  5. The developer will then verify this App in the Portal with the provided OTP. (See Using the Developer Portal and New API Endpoint for more details). The OTP is valid for only 3 days. (If it expires before the developer verifies the App, the Integration Admin can reset it and send a new one.)  

Option Two: AIQ Integrate

  1. Select the desired application type. This includes a Custom Integration option as well as preset types.
  2. Check the disclaimer acknowledging that this application type is chargeable.
  3. Click Continue.
  4. To configure AIQ Integration, complete the following details:
    •  Name: This is a mandatory field. It is used to identify the integration application in the list of apps and will be shown within the Developer Portal. You cannot change this later and it must be unique across all clients. 
    • Description: This is a mandatory field.  It is used to store a longer description of the integration app and its use. This will be shown within the Developer portal. Ensure it is meaningful, especially in the case of custom integrations.
    • Category: This is only available if you select AIQ Custom Integration.
  5. Select the entities this app can have access to via the API. You can change these later, if necessary, with immediate impact on the Integrations running for this App.
  6. Check the disclaimer acknowledging that you understand that our team will have access to your data.
  7. Click Create. Our team will then receive notification.

Option Three: AIQ Connectors

  1. Select Salesforce Connector or Expensein Connector.
  2. Click Continue.
  3. To configure AIQ Integration, complete the following details:
    •  Name: This is a mandatory field. It is used to identify the integration application in the list of apps and will be shown within the Developer Portal. You cannot change this later and it must be unique across all clients. 
    • Description: This is a mandatory field.  It is used to store a longer description of the integration app and its use. This will be shown within the Developer portal. Ensure it is meaningful, especially in the case of custom integrations.
    • Developer Email: This is the email that will receive an Invite to access the Developer Portal to extract the credentials and information to create the integration itself (ClientId, ClientSecret, WSDL endpoint, etc).
  4. Select the entities this app can have access to via the API. You can change these later, if necessary, with immediate impact on the Integrations running for this App.
  5. Check the disclaimer acknowledging that you understand that our team will have access to your data.
  6. Click Create. Our team will then receive notification.

 
 

Managing Integrations Applications

Once the Integration Admin has the correct permissions (see section 2), they will be able to manage Integration Applications via the group layer.

In the group layer, go to Setup > Integration Application.
 

Here you can:

  • View details about your applications.
  • Use the Status filter or any of the other column search fields to filter your applications.
  • Perform the actions outlined below.

Actions dropdown 

The Actions dropdown allows the following operations:

  • Edit
  • Manage Developer Portal Access
  • Download Activity Log
  • Revoke

Edit

In all cases, you can change with immediate effect:

  • The Description 
  • Which entities the App can have access to via the SOAP API.

For New Integrations and non-custom AIQ Integrations, you can also edit the Category. 

The fields that are greyed out are not available for editing.

Manage Developer Portal Access: No Linked Developer

If the App does not have a Developer linked (because the previous Developer was Revoked), you can register a new developer. An email invite or notification will be sent to the Developer, depending on whether they already have access to the Developer Portal. 

Manage Developer Portal Access: Linked Developer

If the App has a valid Developer registered, you can see the Developer information, and if they have verified the OTP and when it was assigned to this App.

The following actions are available:

  • Resend Invite: If the Developer hasn't signed up to the Portal after three days from when the first invite was sent, that invite will expire. They will therefore need a new invite.
  • Revoke Access: This will prevent the Developer from accessing this App’s details in the Developer Portal with immediate effect. An email notification is sent to the Developer.
  • Reset OTP: If the Developer didn’t verify the App in the Portal in time (the OTP is valid for 3 days only), you can use this option. A new OTP will be generated and displayed on the screen and an email notification will be sent to the Developer.
     

Download Activity Log 

A CSV file is available with all the information and events for a particular Application.

Revoke

Selecting Yes will stop all API integrations linked to this Application from running.