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

 

Prerequisites

 

• A Bolt.new AI project created using TypeScript.
• An active UPS API account with credentials (Access Key, Username, Password, and Account Number).
• Basic understanding of TypeScript and REST API calls.

 

Creating the UPS Configuration File

 

• Create a new file named upsConfig.ts in your project’s root directory.
• This file holds your UPS API credentials. Since Bolt.new AI doesn’t allow a terminal session for installing dependencies, you simply add the credentials in code. (For production usage, you should store secrets securely.)
• Paste the following code into upsConfig.ts:

export const upsConfig = {
  accessKey: "YOURUPSACCESS_KEY",
  userId: "YOURUPSUSER_ID",
  password: "YOURUPSPASSWORD",
  accountNumber: "YOURUPSACCOUNT_NUMBER",
  // Set API endpoint; use testing endpoint if applicable
  endpoint: "https://onlinetools.ups.com/rest/Rate"
};

 

Creating the UPS API Service File

 

• Create another new file called upsService.ts in your project’s root directory.
• This file will contain functions that perform API calls to UPS. We use the built-in fetch method in TypeScript to avoid additional dependencies.
• Paste the following code into upsService.ts:

import { upsConfig } from "./upsConfig";

interface RateRequestData {
  shipper: any;
  shipTo: any;
  service: any;
  package: any;
  // Add additional types as needed
}

export async function getShippingRates(data: RateRequestData): Promise<any> {
  // Construct the request payload with credentials and shipment details
  const requestBody = {
    UPSSecurity: {
      UsernameToken: {
        Username: upsConfig.userId,
        Password: upsConfig.password
      },
      ServiceAccessToken: {
        AccessLicenseNumber: upsConfig.accessKey
      }
    },
    RateRequest: {
      Request: {
        RequestOption: "Rate"
      },
      Shipment: {
        Shipper: data.shipper,
        ShipTo: data.shipTo,
        Service: data.service,
        Package: data.package
      }
    }
  };

  try {
    const response = await fetch(upsConfig.endpoint, {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(requestBody)
    });

    if (!response.ok) {
      throw new Error(UPS API error: ${response.status} ${response.statusText});
    }

    return await response.json();
  } catch (error) {
    console.error("Error calling UPS API:", error);
    throw error;
  }
}

 

Integrating UPS API Calls in Your Bolt.new AI Project

 

• In your main application file (for example, index.ts), import the function you just created from upsService.ts.
• Call the getShippingRates function when needed (for instance, in response to a user event or a scheduled task).
• Paste the following sample integration code into your main file where you want to trigger the UPS API call:

import { getShippingRates } from "./upsService";

// Example shipment data; adjust according to your requirements
const shipmentData = {
  shipper: {
    Name: "Sender Name",
    ShipperNumber: "YOURUPSACCOUNT_NUMBER",
    Address: {
      AddressLine: "123 Origin St.",
      City: "OriginCity",
      StateProvinceCode: "OC",
      PostalCode: "12345",
      CountryCode: "US"
    }
  },
  shipTo: {
    Name: "Receiver Name",
    Address: {
      AddressLine: "789 Destination Ave.",
      City: "DestCity",
      StateProvinceCode: "DC",
      PostalCode: "67890",
      CountryCode: "US"
    }
  },
  service: {
    Code: "03", // UPS Ground service code or another code
    Description: "UPS Ground"
  },
  package: {
    PackagingType: {
      Code: "02",
      Description: "Package"
    },
    Dimensions: {
      UnitOfMeasurement: {
        Code: "IN"
      },
      Length: "10",
      Width: "7",
      Height: "5"
    },
    PackageWeight: {
      UnitOfMeasurement: {
        Code: "LBS"
      },
      Weight: "5"
    }
  }
};

// Function to trigger UPS rate calculation
async function fetchShippingRates() {
  try {
    const rateResponse = await getShippingRates(shipmentData);
    console.log("UPS Shipping Rates:", rateResponse);
    // Further processing of rateResponse as needed
  } catch (error) {
    console.error("Error fetching UPS shipping rates:", error);
  }
}

// Call the function on application start or as part of your workflow
fetchShippingRates();

 

Handling API Responses and Errors

 

• The sample code logs responses to the console. In your Bolt.new AI project, you may want to display this information in your UI or process it further.
• Ensure that you add proper error handling in your code. The catch blocks in the code snippets above log errors to the console, which helps with debugging.

 

Deployment and Testing

 

• After inserting the provided code snippets in the appropriate files (upsConfig.ts, upsService.ts, and your main file), save all changes.
• Click the Run button in Bolt.new AI to deploy your project. Since terminal access is unavailable, all dependencies are handled within the code using built-in features like fetch.
• Monitor the console logs in the Bolt.new AI interface to see the results of your UPS API call. Make adjustments as necessary based on the returned data.