Expensify
15 min
learn how to connect engini to expensify getting started with expensify prerequisites access to expensify admin account through expensify https //www expensify com/?exitto=%2ftools%2fintegrations%2f retrieve your partneruserid and partnerusersecret details to learn more about the authentication, click here authentication https //integrations expensify com/integration server/doc/#authentication add an expensify connection 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 expensify option from the available applications enter the following details in the “new integration” form and press save connection name enter a unique and descriptive name for this connection this name will help you identify and manage the connection in your engini account ‘expensify’ is the default name partner user id enter the parnteruserid you retrieved from your account in the ‘getting started with expensify’ section partner user secret enter the partnerusersecret you retrieved from your account in the ‘getting started with expensify’ section employee email you may choose to enter your employee email address, it’s optional save settings click on the save button located at the bottom of the form actions create expense creates a new expense for an employee in expensify employee email enter the employee’s relevant email address if left empty, we will use the default email that was defined in the connection the expenses will be created in this account merchant select the name of the merchant for the expense amount select the amount of the expense, in cents currency enter a three letter currency code value for the relevant currency type of the expense created date choose a relevant date for expense creation in the format yyyy mm dd 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 policy creates a new policy in expensify policy name choose a policy name 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 get policy retrieves an existing policy policy id click on the empty field on the right side to display the tooltip with all the options available for filling the field choose a policy from the tooltip fields\[] this field expects to receive an array of the fields you want to retrieve for the policy click on the empty field on the right side to display the tooltip and use the ‘createarray’ function https //help engini ai/transform and format click on the field on the right side to add the relevant fields to the array 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 get policies retrieves existing policies 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 update policy updates an existing policy policy id click on the empty field on the right side to display the tooltip with all the options available for filling the field choose a policy from the tooltip 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 policy expense rule creates a policy expense rule in expensify employee email enter the employee’s relevant email address if left empty, we will use the default email that was defined in the connection the policy expense will be created in this account policy id click on the empty field on the right side to display the tooltip with all the options available for filling the field choose a policy from the tooltip 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 report template creates a report template in expensify template format click on the empty field on the right side to display the tooltip with all the options available for filling the field choose a format from the tooltip name the default name of the template is ‘report template ’ you have the flexibility to rename it according to your specific use case add template fields 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 export report exports a report that was created within the workflow you can read more about this action here https //integrations expensify com/integration server/doc/#report exporter report template select a report template that was created in the workflow which you want to export 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 initialize objects array creates and sets up an array, a structured collection of objects, which can be used for various purposes throughout your workflow name by default, the array is named ‘objects array’, but you have the flexibility to rename it according to your specific use case object item type define the type of objects from the drop down that will be stored within the array for information about the object click here https //help engini ai/expensify#object element types map object type array we use this activity when there is an array of data that requires transformation into a different structure data list choose a data list that you’ve obtained from previous activities in your workflow this data list contains an array of objects that you want to process and transform object element type define the type of objects from the drop down that will be stored within the array according to the object element type you chose, the fields in step 3 will be defined for information about the object click here https //help engini ai/expensify#object element types 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 item to array you can add an item to an existing array, allowing you to expand, and manipulate an array variable select an existing array variable from the dropdown in which you want to populate an item 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 employee this activity allows you to update an existing employee employee email enter the employee’s relevant email address if left empty, we use the default email that was defined in the connection manager email enter the relevant email address of the employee’s manager employee id select the employee id policy id select the relevant policy id for the employee 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 object element types there are 4 object element types category – classification of the type of expenses for instance, office supplies you can read more about it here https //community expensify com/discussion/5732/deep dive all about policy categories report field – a data that can specify details in a report for instance, the data can be information about relocation you can read more about it here https //help expensify com/articles/expensify classic/workspace and domain settings/reports/report fields and titles tag – a component which allows you to assign the expense to department, location and project tag level – you can utilize one or more tags, each potentially containing sub tags within a parent tag read more about tags here https //help expensify com/articles/expensify classic/workspace and domain settings/tags