---
title: "Creates a Payment resource."
method: POST
path: "/payments"
tags: ["Payment"]
---

# Creates a Payment resource.

`POST /payments`

Creates a Payment resource.

## Request body

- Payment
  - `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
  - `paymentDate` string, date-time — Date of the payment
  - `totalAmount` string, nullable — Total amount listed in the payment in cents
  - `status` string, nullable — Status of the payment e.g. PAID e.g: AUTHORISED e.g: DELETED
  - `modified` string, date-time, nullable — Date entry was last modified
  - `accountId` string, nullable — Account Id the payment was made from
  - `customerId` string, nullable — Customer Id
  - `customerName` string, nullable — Customer name
  - `linkedTxnId` string, nullable — Transaction Id
  - `linkedTxnType` string, nullable — Transaction type e.g. Deposit, Invoice
  - `created` string, date-time, nullable — Date entry was created
  - `invoiceId` string, nullable — Invoice Id
  - `currencyCode` string, nullable — Currency code
  - `paymentType` string, nullable — Payment type e.g. CreditCard

## Response `201`

Payment resource created

- Payment
  - `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
  - `paymentDate` string, date-time — Date of the payment
  - `totalAmount` string, nullable — Total amount listed in the payment in cents
  - `status` string, nullable — Status of the payment e.g. PAID e.g: AUTHORISED e.g: DELETED
  - `modified` string, date-time, nullable — Date entry was last modified
  - `accountId` string, nullable — Account Id the payment was made from
  - `customerId` string, nullable — Customer Id
  - `customerName` string, nullable — Customer name
  - `linkedTxnId` string, nullable — Transaction Id
  - `linkedTxnType` string, nullable — Transaction type e.g. Deposit, Invoice
  - `created` string, date-time, nullable — Date entry was created
  - `invoiceId` string, nullable — Invoice Id
  - `currencyCode` string, nullable — Currency code
  - `paymentType` string, nullable — Payment type e.g. CreditCard

## Other responses

- `400` — Invalid input
- `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)