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

# Creates a Payment resource.

`POST /payments`

## Request

- Base URL: `https://example.myintranetapps.com/api`
- URL: `https://example.myintranetapps.com/api/payments`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/bossinsights/apis/boss-insights/docs/payments/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/bossinsights/apis/boss-insights.md) - [All operations](https://skmtc.dev/bossinsights/apis/boss-insights/llms.txt) - [OpenAPI document](https://skmtc.dev/bossinsights/apis/boss-insights/revisions/d08a107895ad?raw)