> ## Documentation Index
> Fetch the complete documentation index at: https://docs.engini.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Quickbooks
Learn how to connect QuickBooks to Engini, enabling efficient integration of your accounting and financial management processes. With the QuickBooks connector, you can access real-time financial data, automate tasks like invoice processing, customer record management, and financial reporting, and enhance operational efficiency.
## Connecting Engini to Quickbooks
1. Enter your Engini account at [https://app.engini.io](https://app.engini.io/).
2. Navigate to Connections page by clicking on the Connections on the left side bar or by clicking [here](https://app.engini.io/connections).
3. Click on the "New Integration" option located at the top bar.
4. Choose “Quickbooks” option from available applications.
5. Enter the following details in the “New Integration” form and press Save:
1. *Connection Name -* A unique identifier for the connection within Engini.
2. *Authentication Method* – Select the authentication method used to connect to your QuickBooks account. In most cases, OAuth2 is used, allowing you to securely authorize Engini without entering your QuickBooks credentials directly.
3. *Url -* After logging into your account, your URL will appear automatically on the screen in Engini.
4. *Environment -* Select the appropriate environment from the dropdown list:
* *Sandbox* – for testing
* *Production* – for live data
5. *Signin -* When you click on ‘Signin’, the following window appears.
Fill in your login details.
6. *Save Settings -* After signing in, click **Save** to finalize and store the connection.
## Activities
### Create Record
This activity creates a new record in QuickBooks based on the selected object type.
* *Object Type –* Select the type of QuickBooks object you want to create (e.g., Customer, Invoice, Item). The available options depend on the integration capabilities and the specific data model supported by QuickBooks.
After selecting the object type (e.g., **Accounts**), provide the necessary detail.
1. *Name* – Enter the name of the account you want to create.
2. *AccountType* – Select the type of account (e.g., Bank, Credit Card, Expense). This defines how the account will behave in the system.
3. *Add Field* - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](/help/workflows/workflow-editor#add-fields).
### Delete record
This activity deletes an existing record from QuickBooks based on the specified object type and record ID.
1. *Object Type –* You can choose from the following objects to delete a record: Bill, Payment, or Invoice.
2. *Id –* Enter the unique identifier of the record you want to delete. This value must match an existing record in QuickBooks.
After selecting the object type (e.g., **Bill**), provide the necessary detail.
1. *Vendor’s Id –* Enter the unique identifier of the vendor associated with the bill you want to delete.
2. *Add Field* - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](/help/workflows/workflow-editor#add-fields).
### Get Record
This activity retrieves a specific record from QuickBooks using its object type and record ID. Use this when you need to access detailed information about a particular record for use later in your workflow.
1. *Object type –* Select the type of QuickBooks object you want to retrieve (e.g., Customer, Invoice, Item).
2. *Record Id –* Enter the unique identifier of the record you want to fetch. The retrieved data can be used in subsequent steps.
### Get Records
This activity retrieves multiple records of a specific object type from QuickBooks.
1. *Object Type –* Select the type of object you want to retrieve records from.
2. *Top N –* You can specify how many records with the same value you want to get. Click on ‘Top N’ and enter the maximum number of values you want to retrieve.
If you set `Top N = 1`, a single record will be returned instead of an array. If no record is found, the action will fail, allowing you to implement an IF condition within the workflow. This can be useful for processes where the existence of a record determines the next steps in the workflow.
3. *Add Filter -* Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](/help/workflows/workflow-editor#add-filters).
4. *Add Sort -* Click Add Sort to organize the data list by a selected field in ascending or descending order. To learn more about sorting data, [click here](/help/workflows/workflow-editor#add-sorts).
### Initialize Objects Variable
This activity initializes a new variable designed to hold an array of objects of a specific QuickBooks type.
1. *Variable name –* Enter a name for the variable that will store the array of objects.
2. *Object Element Type –* Select the type of object that this variable will contain (e.g., Invoice, Payment, Bill). This determines the structure and available fields for each item in the list.
3. *Add Field* - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](/help/workflows/workflow-editor#add-fields).
### Append Object To Array
This action adds a new object to an existing object array variable that was initialized earlier in the workflow.
* *Variable –* Select the array you initialized in the previous steps.
* *Add Field* - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](/help/workflows/workflow-editor#add-fields).
### Map Array
This activity transforms a list of data into an array of QuickBooks-compatible objects.
1. *Data List –* Select the list of items you want to transform. This can be a variable or output from a previous step.
2. *Object Element Type –* Select the type of object that each item in the list represents. This defines the structure and available fields for each item during the mapping process.
After selecting a specific object, you will have the option to populate it’s fields by using “Add Field”.
* *Add Field* - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](/help/workflows/workflow-editor#add-fields).
### Update Record
This activity updates an existing record in QuickBooks based on its object type and ID.
Use this to make changes to specific fields of a record, such as updating customer information, modifying an invoice, or editing item details.
1. *Object Type –* Select the type of QuickBooks object you want to update (e.g., Customer, Invoice, Item).
2. *ID –* Enter the unique identifier of the record you want to update.
After selecting the action type (e.g., Send Email), provide the necessary details for the action.
1. *Name –* The field refers to the new name you want to assign to the selected Account record.
2. *Add Field* - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](/help/workflows/workflow-editor#add-fields).
### Update Category
This activity updates an existing category record in QuickBooks.
Use this to modify the details of a category, such as its name, description, or other fields, based on your workflow requirements.
* *Add Field* - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](/help/workflows/workflow-editor#add-fields).
### Send API Request
This activity allows you to send a custom API request directly to the QuickBooks API.
1. *Base Url –* This is the root URL of the API you’re sending the request to.
2. *Relative url –* You can specify additional path segments or parameters that need to be added to the end of the automatically generated URL. This allows you to customize the specific request you want to perform.
3. *Method –* Select the HTTP method (e.g., Get, Post, Put, Delete, Patch).
4. *Body Type –* Defines the format of the data in the body of your request. Commonly used values include application/json (as shown), which means the body will contain a JSON-formatted payload.
5. *Body –* Contains any data that is being sent to the server.
6. *Add Headers –* Additional metadata about the request, such as the type of data the Engini can accept, the length of the request body, and authentication information.
7. *Add Queries –* The query refers to the parameters or data that are included in the URL of an HTTP request to provide additional information or instructions to the server.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.