Bolt.new AI and Expensify integration: Step-by-Step Guide 2025

 

Setting Up the Package.json with Dependencies

 

• Create a new file named package.json in the root of your Bolt.new AI project.
• Copy and paste the following code snippet into package.json. This provides the necessary dependency (axios) for making HTTP requests to Expensify’s API:

{
  "name": "bolt-expensify-integration",
  "version": "1.0.0",
  "dependencies": {
    "axios": "^0.27.2"
  },
  "scripts": {
    "start": "tsc && node dist/index.js"
  }
}

• Since Bolt.new AI does not have a terminal, simply adding this file enables the platform’s dependency management.

 

Creating the Expensify Client Module

 

• Create a new file in your project named expensifyClient.ts. This module will handle all communications with Expensify’s API.
• Paste the following TypeScript code into expensifyClient.ts. This sample code includes a function to create an expense in Expensify by posting the required payload:

import axios from 'axios';

const EXPENSIFYAPIURL = 'https://integrations.expensify.com/Integration-Server/ExpensifyIntegrations';

interface Expense {
  merchant: string;
  total: number;
  currency: string;
  // Add other expense properties as needed
}

interface ExpensifyCredentials {
  partnerUserID: string;
  partnerUserSecret: string;
}

// Replace these with your actual credentials
const credentials: ExpensifyCredentials = {
  partnerUserID: 'yourpartneruser_id',
  partnerUserSecret: 'yourpartneruser_secret'
};

export async function createExpense(expense: Expense): Promise {
  try {
    // Prepare the payload as required by Expensify’s API.
    const payload = {
      requestJobDescription: {
        type: 'create',
        credentials: credentials,
        inputSettings: {
          type: 'expense',
          merchant: expense.merchant,
          total: expense.total,
          currency: expense.currency
          // Map additional fields if necessary
        }
      }
    };

    // Make a POST request to Expensify
    const response = await axios.post(EXPENSIFYAPIURL, payload, {
      headers: {
        'Content-Type': 'application/json'
      }
    });

    return response.data;
  } catch (error) {
    // Handle and rethrow errors for further processing in your app
    throw error;
  }
}

• This module imports axios and defines the interface for the expense object. It sends a POST request to Expensify’s API endpoint with the required credentials and expense data.

 

Integrating the Expensify Client into Your Main Application

 

• Locate your main TypeScript file (for example, index.ts or app.ts) within your Bolt.new AI project.
• At the top of the file, import the createExpense function from your newly created expensifyClient.ts module:

import { createExpense } from './expensifyClient';

• You can now call createExpense wherever needed in your code. For a simple test, add the following code snippet in your main file to invoke the Expensify integration:

async function testExpensifyIntegration() {
  const expense = {
    merchant: 'Sample Merchant',
    total: 100.50,
    currency: 'USD'
    // Include additional fields as required
  };

  try {
    const result = await createExpense(expense);
    console.log('Expense created successfully:', result);
  } catch (error) {
    console.error('Error creating expense:', error);
  }
}

// Call the test function (you can eventually trigger this on a button click or other event)
testExpensifyIntegration();

• This snippet defines an asynchronous function that creates a sample expense and logs the result or any error encountered during the API call.

 

Finalizing Your Integration

 

• Review all your changes to ensure that package.json, expensifyClient.ts, and your main application file have been saved.
• Since Bolt.new AI builds your project automatically, when you trigger your application (for example, via a button click or page load), the testExpensifyIntegration function will run and integrate with Expensify.
• Monitor the console logs to verify that the expense is created successfully or to debug any errors.

 

Notes and Customization

 

• Replace yourpartneruserid and yourpartnerusersecret in expensifyClient.ts with your actual Expensify API credentials.
• If your project grows, consider handling errors and API responses more gracefully (for example, retry logic or user notifications).
• Customize the Expense interface and payload mapping in the createExpense function according to your specific use-case and the Expensify API documentation.