Skip to main content
PUT
/
clients
/
{clientId}
/
finance-settings
Update Client Finance Settings
curl --request PUT \
  --url https://api.sandbox.flowpayroll.ai/v1/billing/clients/{clientId}/finance-settings \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-Token: <api-key>' \
  --data '
{
  "defaultRevenueAccount": "<string>",
  "defaultTaxRate": "<string>",
  "payElementMappings": [
    {
      "payElementId": "<string>",
      "accountCode": "<string>",
      "taxType": "<string>"
    }
  ],
  "defaultDueDateDays": 123,
  "defaultCurrencyCode": "<string>",
  "defaultLineAmountTypes": "<string>",
  "invoiceTemplateOverride": {
    "showSubsectionHeader": true,
    "showSubtotalInSubsection": true,
    "showSubtotalVatInSubsection": true,
    "showQuantitySumInSubsection": true,
    "showBottomSubtotals": true,
    "showVatInBottomSubtotals": true,
    "showQuantitySumInBottomSubtotals": true,
    "lineDescriptionFormula": "<string>",
    "lineDescriptionTagGroupId": "<string>",
    "includeAttachmentsWithOnlineInvoice": true
  },
  "creditNoteTemplateOverride": {
    "showSubsectionHeader": true,
    "showSubtotalInSubsection": true,
    "showSubtotalVatInSubsection": true,
    "showQuantitySumInSubsection": true,
    "showBottomSubtotals": true,
    "showVatInBottomSubtotals": true,
    "showQuantitySumInBottomSubtotals": true,
    "lineDescriptionFormula": "<string>",
    "lineDescriptionTagGroupId": "<string>",
    "includeAttachmentsWithOnlineInvoice": true
  },
  "invoiceReferenceFormula": "<string>",
  "invoiceReferenceDateFormat": "<string>"
}
'
{
  "content": {
    "data": {
      "defaultRevenueAccount": "<string>",
      "defaultTaxRate": "<string>",
      "payElementMappings": [
        {
          "payElementId": "<string>",
          "accountCode": "<string>",
          "taxType": "<string>"
        }
      ],
      "defaultDueDateDays": 123,
      "defaultCurrencyCode": "<string>",
      "defaultLineAmountTypes": "<string>",
      "invoiceTemplateOverride": {
        "showSubsectionHeader": true,
        "showSubtotalInSubsection": true,
        "showSubtotalVatInSubsection": true,
        "showQuantitySumInSubsection": true,
        "showBottomSubtotals": true,
        "showVatInBottomSubtotals": true,
        "showQuantitySumInBottomSubtotals": true,
        "lineDescriptionFormula": "<string>",
        "lineDescriptionTagGroupId": "<string>",
        "includeAttachmentsWithOnlineInvoice": true
      },
      "creditNoteTemplateOverride": {
        "showSubsectionHeader": true,
        "showSubtotalInSubsection": true,
        "showSubtotalVatInSubsection": true,
        "showQuantitySumInSubsection": true,
        "showBottomSubtotals": true,
        "showVatInBottomSubtotals": true,
        "showQuantitySumInBottomSubtotals": true,
        "lineDescriptionFormula": "<string>",
        "lineDescriptionTagGroupId": "<string>",
        "includeAttachmentsWithOnlineInvoice": true
      },
      "invoiceReferenceFormula": "<string>",
      "invoiceReferenceDateFormat": "<string>"
    },
    "metadata": {
      "dateFormat": "<string>",
      "dateTimeFormat": "<string>"
    }
  },
  "metadata": {
    "dateFormat": "<string>",
    "dateTimeFormat": "<string>"
  },
  "errors": [
    {
      "field": "<string>",
      "reasonText": "<string>",
      "reasonId": "<string>",
      "reasonParameters": [
        {
          "key": "<string>",
          "value": "<string>"
        }
      ]
    }
  ],
  "message": {
    "text": "<string>",
    "textId": "<string>",
    "textParameters": [
      {
        "key": "<string>",
        "value": "<string>"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.flowpayroll.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

X-Auth-Token
string
header
required

Authentication token for API access

Path Parameters

clientId
string
required

Body

application/json
defaultRevenueAccount
string | null
defaultTaxRate
string | null
payElementMappings
object[]
defaultDueDateDays
integer<int32> | null
defaultDueDateType
enum<string> | null
Available options:
DaysAfterInvoiceDate,
DaysAfterInvoiceMonth,
OfCurrentMonth,
OfFollowingMonth
defaultCurrencyCode
string | null
defaultLineAmountTypes
string | null
invoiceTemplateOverride
object
creditNoteTemplateOverride
object
invoiceReferenceFormula
string | null
invoiceReferenceDateFormat
string | null

Response

OK

content
object
metadata
object
errors
object[] | null
message
object