---
title: "Replaces the BillPayment resource."
method: PUT
path: "/bill_payments/{id}"
tags: ["BillPayment"]
---

# Replaces the BillPayment resource.

`PUT /bill_payments/{id}`

Replaces the BillPayment resource.

## Path parameters

- `id` string, required

## Request body

- BillPayment
  - `id` string
  - `integration` string — The key of the integration source e.g. "quickbooks", or "xero"
  - `srcId` string — the unique identifier of the source 3rd party integration e.g. "460000000053219"
  - `billId` string — The source ID of the bill being paid
  - `vendorPaymentId` string, nullable — The Boss Insights identifier for the Vendor Payment that this Bill Payment belongs to (if it belongs to one) Note that no particular pattern in this field is guaranteed, only that this field is unique
  - `vendorId` string, nullable — Unique identifier for the vendor of the bill e.g. "460000000026049"
  - `vendorName` string, nullable — Name of the vendor of the bill e.g. "Bowman and Co"
  - `paymentMode` string, nullable — Mode of payment e.g. "Stripe"
  - `txnDate` string, date-time, nullable — Date the payment is made e.g. "2013-10-07"
  - `referenceNumber` string, nullable — Reference number for the payment recorded e.g. REF#912300
  - `amount` integer — Total amount of the payment in cents e.g. 12500
  - `currency` string, nullable — Currency code e.g. "USD"
  - `created` string, date-time, nullable — Creation time of the payment e.g. 2016-12-16T00:18:42-0500
  - `modified` string, date-time, nullable — Last modified time of the payment e.g. 2016-12-16T00:18:42-0500

## Response `200`

BillPayment resource updated

- BillPayment
  - `id` string
  - `integration` string — The key of the integration source e.g. "quickbooks", or "xero"
  - `srcId` string — the unique identifier of the source 3rd party integration e.g. "460000000053219"
  - `billId` string — The source ID of the bill being paid
  - `vendorPaymentId` string, nullable — The Boss Insights identifier for the Vendor Payment that this Bill Payment belongs to (if it belongs to one) Note that no particular pattern in this field is guaranteed, only that this field is unique
  - `vendorId` string, nullable — Unique identifier for the vendor of the bill e.g. "460000000026049"
  - `vendorName` string, nullable — Name of the vendor of the bill e.g. "Bowman and Co"
  - `paymentMode` string, nullable — Mode of payment e.g. "Stripe"
  - `txnDate` string, date-time, nullable — Date the payment is made e.g. "2013-10-07"
  - `referenceNumber` string, nullable — Reference number for the payment recorded e.g. REF#912300
  - `amount` integer — Total amount of the payment in cents e.g. 12500
  - `currency` string, nullable — Currency code e.g. "USD"
  - `created` string, date-time, nullable — Creation time of the payment e.g. 2016-12-16T00:18:42-0500
  - `modified` string, date-time, nullable — Last modified time of the payment e.g. 2016-12-16T00:18:42-0500

## Other responses

- `400` — Invalid input
- `404` — Resource not found
- `422` — Unprocessable entity

---

[API](https://skmtc.net/bossinsights/apis/boss-insights.md) · [All operations](https://skmtc.net/bossinsights/apis/boss-insights/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bossinsights/boss-insights/revisions/d08a107895ad/schema)