ZIP HQ

learn how to connect engini to zip hq using the zip hq connection, you can create and update purchase orders and invoices, manage vendors and user data, and search through your financial records this allows you to easily automate procurement workflows, making your financial management faster and more accurate to get started, create an account at zip hq https //app ziphq com/login? gl=1 1ei64kc gcl au mtazotyxnta3my4xnzu5nju2nzgw add a connection to zip hq in engini enter your engini account at https //app engini io https //app engini io/ navigate to connections page by clicking on the connections on the left sidebar or by clicking here https //app engini io/connections click on the "new integration" option located at the top bar choose “zip hq” option from the available applications enter the following details in the “new integration” form and press save connection name – enter a unique name for this connection this name will help you identify and manage the connection in your engini account zip api key – enter the api key you generated in your zip hq account save settings – after you have filled in the fields, click on the save button to save the connection triggers request approved this trigger starts a workflow when a request is approved in zip hq url this is an automatic webhook url generated by engini this url cannot be edited or modified use the copy icon on the right to copy the url and paste it into your zip hq webhook configuration add conditions click add conditions to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add conditions request attribute updated this trigger starts a workflow when a specific attribute on a request is updated in zip hq url this is an automatic webhook url generated by engini this url cannot be edited or modified use the copy icon on the right to copy the url and paste it into your zip hq webhook configuration add conditions click add conditions to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add conditions request cancelled this trigger starts a workflow when a request is cancelled in zip hq url this is an automatic webhook url generated by engini this url cannot be edited or modified use the copy icon on the right to copy the url and paste it into your zip hq webhook configuration add conditions click add conditions to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add conditions request new comment this trigger starts a workflow when a new comment is added to a request in zip hq url this is an automatic webhook url generated by engini this url cannot be edited or modified use the copy icon on the right to copy the url and paste it into your zip hq webhook configuration add conditions click add conditions to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add conditions request rejected this trigger starts a workflow when a request is rejected in zip hq url this is an automatic webhook url generated by engini this url cannot be edited or modified use the copy icon on the right to copy the url and paste it into your zip hq webhook configuration add conditions click add conditions to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add conditions request submitted this trigger starts a workflow when a new request is submitted in zip hq url this is an automatic webhook url generated by engini this url cannot be edited or modified use the copy icon on the right to copy the url and paste it into your zip hq webhook configuration add conditions click add conditions to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add conditions actions create a department this action is used to add a new department into your zip workspace add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields create a gl account this action is used to create a gl account within your zip add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields create a lookup option this action is used to create a new lookup option within zip it adds a value or choice to a predefined list, helping to standardize data entry and ensure consistency across fields, forms, and reports add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields create a purchase order this action is used to create a new purchase order within zip, a formal document issued to a vendor that specifies goods or services to be purchased along with their quantities and prices currency enter the currency for the purchase order vendor id enter the unique identifier of the vendor for the purchase order add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields create a roles this action allows you to create a new user role in zip hq to define a specific set of permissions for a group of users instead of assigning permissions individually, you can create a role once (for example, “account executive” or “architect”) and apply it to multiple users, ensuring consistent access levels across your organization add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields create a subsidiary this action creates a new subsidiary company record within zip hq, allowing you to define a new legal entity for tracking financial data, budgets, and reporting add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields create a tax code this action is used to create a new tax code within zip, which defines the tax rate and rules to be applied to transactions like invoices and purchase orders for accurate financial tracking and reporting add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields create a user this action is used to create a new user profile in zip, which defines a person’s identity add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields create an expense category this action is used to create a new expense category in zip, which helps organize and classify expenses for budgeting, reporting, and financial tracking add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields create an invoice this action is used to create a new invoice in zip currency – enter the currency for the invoice invoiced amount – enter the total amount to be charged on the invoice subsidiary id – enter the unique id of the subsidiary to associate with this invoice vendor id – enter the unique id of the vendor to whom the invoice is issued add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields create an invoice from e invoice xml this action creates a new invoice by parsing the data directly from an e invoice in xml format data – enter the content of the e invoice’s xml file the system will use this data to automatically generate a new invoice create an item account this action creates a new item account within zip, which is a financial record used to track and manage specific items or services for purchasing, inventory, and reporting add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields create location this action is used to add a new physical or operational location within ziphq add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields create look up type his action creates a new type of lookup in zip a lookup type defines the main list that can later contain individual options or entries these options are used to standardize data across your organization and maintain consistency in forms, fields, and reports add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields create or update budget this action creates or updates a budget within zip a budget is the planned or allocated amount of spending or revenue for a specific period, allowing you to set financial goals and targets department id – enter the unique id of the department for this budget actual amount – enter the amount of the budget actual start date – enter the start date of the fiscal period for the budget add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields create or update budget actuals this action creates or updates budget actuals within zip budget actuals represent the actual spending or revenue that has occurred, allowing you to track and compare real world financial activity against your allocated budget department id – enter the unique id of the department for this budget actual amount – enter the amount of the budget actual date – enter the date of the budget actual add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields add invoice line items this action allows you to add one or more line items to an existing invoice in zip hq invoice id – enter the unique identifier of the invoice to which you want to add line items add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields deactivates user by id this action deactivates an existing user’s account in zip hq using their unique user id this will prevent the user from logging in or accessing the system, but their data will remain in the system user id – enter the unique identifier of the user you want to deactivate delete department by id this action permanently deletes an existing department from zip hq using its unique department id this action is irreversible and will remove all associated department data from the system department id enter the unique identifier of the department you want to delete delete expense category by id this action permanently deletes an existing expense category from zip hq using its unique expense category id this action is irreversible and will remove the category from all associated financial records expense category id – enter the unique identifier of the expense category you want to delete delete location by id this action permanently deletes an existing location from zip hq using its unique location id this action is irreversible and will remove the location and any associated data from the system location id – enter the unique identifier of the location you want to delete delete lookup by id this action permanently deletes an existing lookup from zip using its unique lookup id this is an irreversible action that will remove the entire list and may affect any forms or fields that were using it look up id – enter the unique identifier of the lookup you want to delete delete look up option by id this action permanently deletes an existing option from a lookup list in zip using its unique lookup option id this is an irreversible action that will remove the option from the list and any fields that were using it lookup option id – enter the unique identifier of the lookup option you want to delete delete role by id this action permanently deletes an existing user role from zip hq using its unique role id this is an irreversible action that will remove all permissions and access rights associated with the role role id – enter the unique identifier of the role you want to delete delete subsidiary by id this action permanently deletes an existing subsidiary from zip hq using its unique subsidiary id this is an irreversible action that will remove the subsidiary and all associated financial records and data from the system subsidiary id – enter the unique identifier of the subsidiary you want to delete delete tax code by id this action permanently deletes an existing tax code from zip hq using its unique tax code id this is an irreversible action and will remove the tax code from all financial records it was previously associated with tax code id – enter the unique identifier of the tax code you want to delete delete vendor by id this action permanently deletes an existing vendor from zip hq using its unique vendor id this is an irreversible action that will remove the vendor and all associated financial records and data from the system vendor id – enter the unique identifier of the vendor you want to delete get a purchase order by id this action retrieves the details of a specific purchase order in zip hq using its unique purchase order id you can then use this data in subsequent actions within your workflow purchase order id – enter the unique identifier of the purchase order you want to retrieve get a request questionnaire responses this action retrieves the responses submitted on a questionnaire that is associated with a specific request in zip hq this allows you to access and use the data provided in the questionnaire within your workflow request id – enter the unique identifier of the request whose questionnaire responses you want to retrieve get a single purchase request this action retrieves the details of a single purchase request in zip hq using its unique request id this allows you to access and use the data from a specific request within your workflow request id – enter the unique identifier of the purchase request you want to retrieve get a tax code this action retrieves the details of a single tax code in zip hq using its unique tax code id this allows you to access and use the tax code data within your workflow for calculations or reporting tax code id – enter the unique identifier of the tax code you want to retrieve get agreement by id this action retrieves the details of a single agreement in zip hq using its unique agreement id you can then use this data within your workflow, for example, to track contracts or manage legal documents agreement id – enter the unique identifier of the agreement you want to retrieve get agreements this action retrieves a list of agreements from zip hq you can use filters, sorting, and other options to refine your search and get the exact agreements you need top n you can specify how many agreements 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 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 https //help engini ai/workflow editor#add filters 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 https //help engini ai/workflow editor#add sorts get all available purchase categories this action retrieves all available purchase categories from zip get all supported currencies this action retrieves a complete list of all supported currencies in zip get department by id this action retrieves the details of a specific department in zip hq using its unique department id you can then use this data in subsequent actions within your workflow department id – enter the unique identifier of the department you want to retrieve get departments this action retrieves a list of departments from zip you can use filters, sorting, and other options to refine your search and get the exact departments you need top n – you can specify how many departments 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 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 https //help engini ai/workflow editor#add filters 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 https //help engini ai/workflow editor#add sorts get document by id this action retrieves the details of a specific document in zip hq using its unique document id you can then use this data in subsequent actions within your workflow, such as accessing its content or metadata document id – enter the unique identifier of the document you want to retrieve get expense category by id this action retrieves the details of a specific expense category in zip hq using its unique expense category id this allows you to access and use the category’s data within your workflow expense category id – enter the unique identifier of the expense category you want to retrieve get expense categories this action retrieves a list of expense categories from zip you can use filters and other options to refine your search and get the exact categories you need top n – you can specify how many expense categories 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 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 https //help engini ai/workflow editor#add filters get gl account by id this action retrieves the details of a specific general ledger (gl) account in zip hq using its unique gl code id you can then use this data in subsequent actions within your workflow, for example, to get account information for financial transactions gl code id – enter the unique identifier of the gl account you want to retrieve get gl accounts this action retrieves a list of general ledger (gl) accounts from zip you can use filters, sorting, and other options to refine your search and get the exact accounts you need top n – you can specify how many gl accounts 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 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 https //help engini ai/workflow editor#add filters 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 https //help engini ai/workflow editor#add sorts get locations this action retrieves a list of locations from zip you can use filters, sorting, and other options to refine your search and get the exact locations you need choose from the drop down the field you want to filter by top n – you can specify how many locations 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 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 https //help engini ai/workflow editor#add filters 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 https //help engini ai/workflow editor#add sorts get invoice by id this action retrieves the details of a specific invoice in zip hq using its unique invoice id invoice id – enter the unique identifier of the invoice you want to retrieve get invoices this action retrieves a list of invoices from zip you can use filters, sorting, and other options to refine your search and get the exact invoices you need top n – you can specify how many invoices 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 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 https //help engini ai/workflow editor#add filters 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 https //help engini ai/workflow editor#add sorts get item account by id this action retrieves the details of a specific item account in zip hq using its unique item account id item account id – enter the unique identifier of the item account you want to retrieve get item accounts this action retrieves a list of item accounts from zip you can use filters and other options to refine your search and get the exact item accounts you need 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 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 https //help engini ai/workflow editor#add filters get lookup by id this action retrieves the details of an entire lookup list in zip using its unique lookup id lookup id – enter the unique identifier of the lookup list you want to retrieve get lookup types this action retrieves a list of all lookup types from zip you can use filters, sorting, and other options to refine your search and get the exact lookup types you need top n – you can specify how many types 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 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 https //help engini ai/workflow editor#add filters 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 https //help engini ai/workflow editor#add sorts get lookup option by id this action retrieves the details of a single option from a lookup list in zip, using its unique look up option id this allows you to access and use the specific data from that option within your workflow look up option id – enter the unique identifier of the lookup option you want to retrieve get lookup options this action retrieves a list of lookup options from zip you can use filters, sorting, and other options to refine your search and get the exact options you need top n – you can specify how many options 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 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 https //help engini ai/workflow editor#add filters 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 https //help engini ai/workflow editor#add sorts get purchase orders this action retrieves a list of purchase orders from zip you can use filters, sorting, and other options to refine your search and get the exact purchase orders you need top n – you can specify how many orders 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 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 https //help engini ai/workflow editor#add filters 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 https //help engini ai/workflow editor#add sorts get requests this action retrieves a list of requests from zip you can use filters, sorting, and other options to refine your search and get the exact requests you need top n – you can specify how many requests 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 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 https //help engini ai/workflow editor#add filters 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 https //help engini ai/workflow editor#add sorts get payout by id this action retrieves the details of a specific payout record in zip hq using its unique payout id you can then use this data in subsequent actions within your workflow payout id – enter the unique identifier of the payout you want to retrieve get role by id this action retrieves the details of a specific user role in zip hq using its unique role id you can then use the role’s data in subsequent actions within your workflow role id – enter the unique identifier of the role you want to retrieve get subsidiary by id this action retrieves the details of a specific subsidiary in zip hq using its unique subsidiary id you can then use this data in subsequent actions within your workflow subsidiary id – enter the unique identifier of the subsidiary you want to retrieve get user by id this action retrieves the details of a specific user in zip hq using their unique user id you can then use this data in subsequent actions within your workflow, for example, their name, email, or role user id – enter the unique identifier of the user you want to retrieve get users this action retrieves a list of users from zip you can use filters, sorting, and other options to refine your search and get the exact users you need top n – you can specify how many users 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 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 https //help engini ai/workflow editor#add filters 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 https //help engini ai/workflow editor#add sorts get user group by id this action retrieves the details of a specific user group in zip hq using its unique user group id you can then use the group’s data in subsequent actions within your workflow user group id – enter the unique identifier of the user group you want to retrieve get user groups this action retrieves a list of user groups from zip you can use filters, sorting, and other options to refine your search and get the exact user groups you need top n – you can specify how many groups 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 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 https //help engini ai/workflow editor#add filters 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 https //help engini ai/workflow editor#add sorts get vendor by id this action retrieves the details of a specific vendor in zip hq using their unique vendor id you can then use this data in subsequent actions within your workflow vendor id – enter the unique identifier of the vendor you want to retrieve 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 https //help engini ai/workflow editor#add filters get vendors this action retrieves a list of vendors from zip you can use filters, sorting, and other options to refine your search and get the exact vendors you need top n – you can specify how many vendors 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 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 https //help engini ai/workflow editor#add filters 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 https //help engini ai/workflow editor#add sorts get vendor credit by id this action retrieves the details of a specific vendor credit in zip hq using its unique vendor credit id you can then use this data in subsequent actions within your workflow vendor credit id – enter the unique identifier of the vendor credit you want to retrieve get vendor credits this action retrieves a list of vendor credits from zip you can use filters, sorting, and other options to refine your search and get the exact vendor credits you need top n – you can specify how many credits 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 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 https //help engini ai/workflow editor#add filters 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 https //help engini ai/workflow editor#add sorts get vendor payment methods this action retrieves a list of all payment methods for a specific vendor in zip you can use the vendor id to specify the vendor and then add filters to narrow down the list of payment methods vendor id – enter the unique id of the vendor whose payment methods you want to retrieve 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 https //help engini ai/workflow editor#add filters get approvals this action retrieves a list of approvals from zip you can use filters, sorting, and other options to refine your search and get the exact approvals you need top n – you can specify how many approvals 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 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 https //help engini ai/workflow editor#add filters 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 https //help engini ai/workflow editor#add sorts get workflow attributes this action retrieves the key attributes of a specific workflow in zip by using its unique workflow id, providing a complete overview of a company process workflow id – enter the unique identifier of the workflow whose attributes you want to retrieve get workflows this action retrieves a complete list of all workflows supported by zip send a bill invoice for approval submit a bill invoice to your organization’s approval invoice id – enter the unique identifier of the invoice you want to send for approval send api request this activity allows you to send a custom api request directly to the zip api base url – this is the root url of the api you’re sending the request to 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 method – select the http method (e g , get, post, put, delete, patch) 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 body – contains any data that is being sent to the server 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 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 initialize object array this action initializes an array variable that holds objects of the selected type variable name – enter a name for the variable that will store the array of objects object element type – select the type of object that this variable will contain (e g , attributes, currencies, custom fields, data) this determines the structure and available fields for each item in the list add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields append to object array this action adds a new object to an existing object array variable that was initialized earlier in the workflow to define the new object, you must fill in a number of fields, some of which are mandatory while others are optional, these fields are determined by the selected variable 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 https //help engini ai/workflow editor#add fields update a single purchase request this action lets you modify the details of an existing purchase request in zip hq, using its unique request id request id enter the unique identifier of the purchase request you want to update add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update a location this action lets you modify the details of an existing location in zip hq, using its unique location id location id – enter the unique identifier of the location you want to update add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update a look up option this action lets you modify the details of an existing lookup option in zip hq, using its unique lookup option id look up option id – enter the unique identifier of the look up option you want to update add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update a tax code this action lets you modify the details of an existing tax code in zip hq, using its unique tax code id tax code id – enter the unique identifier of the tax code you want to update add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update an invoice’s paid status this action lets you modify the payment status of an existing invoice in zip hq, using its unique invoice id invoice id – enter the unique identifier of the invoice whose paid status you want to update add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update department by id this action lets you modify the details of an existing department in zip hq, using its unique department id department id – enter the unique identifier of the department you want to update add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update expense category by id this action lets you modify the details of an existing expense category in zip hq using its unique expense category id expense category id – enter the unique identifier of the expense category you want to update add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update gl account this action lets you modify the details of an existing general ledger (gl) account in zip hq gl code id – enter the unique identifier of the gl account you want to update add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update lookup by id this action lets you modify the details of an existing lookup in zip hq by using its unique lookup id lookup id – enter the unique identifier of the lookup you want to update add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update payment method by id this action lets you modify the details of an existing payment method in zip hq using its unique payment method id payment method id – enter the unique identifier of the payment method you want to update add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update role by id this action lets you modify the details of an existing user role in zip hq by using its unique role id role id – enter the unique identifier of the role you want to update add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update subsidiary by id this action lets you modify the details of an existing subsidiary in zip hq using its unique subsidiary id subsidiary id – enter the unique identifier of the subsidiary you want to update add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update user by id this action lets you modify the details of an existing user in zip hq using their unique user id user id – enter the unique identifier of the user you want to update add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update vendor this action lets you modify the details of an existing vendor in zip hq using its unique vendor id vendor id – enter the unique identifier of the vendor you want to update add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields upload a document this action allows you to upload a document to an existing purchase request in zip hq this is useful for adding files like invoices, contracts, or other supporting materials to a request request id – enter the unique identifier of the purchase request you want to attach the document to content – this section requires the content of the file you are uploading enter the content of the file as a base64 upsert currencies this action allows you to update the list of supported currencies in zip hq the term “upsert” is used here to indicate that you are adding new currencies to the existing list add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields