Skip to main content
PUT
/
invoice
/
settings
cURL
curl --request PUT \
  --url https://api.slash.com/invoice/settings \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "companyName": "<string>",
  "email": "jsmith@example.com",
  "address": {
    "addressLine": "<string>",
    "addressCity": "<string>",
    "addressState": "<string>",
    "addressZip": "<string>",
    "addressLine2": "<string>",
    "addressCountry": "<string>"
  },
  "defaultMemo": "<string>",
  "invoiceTerms": "<string>",
  "defaultPaymentTermsDays": 1,
  "logoDocumentId": "<string>",
  "unitPriceDecimalPlaces": 4,
  "branding": {
    "backgroundColor": "<string>",
    "titleColor": "<string>"
  }
}
'
{
  "invoiceSettings": {
    "id": "<string>",
    "legalEntityId": "<string>",
    "settings": {
      "companyName": "<string>",
      "email": "jsmith@example.com",
      "address": {
        "addressLine": "<string>",
        "addressCity": "<string>",
        "addressState": "<string>",
        "addressZip": "<string>",
        "addressLine2": "<string>",
        "addressCountry": "<string>"
      },
      "defaultMemo": "<string>",
      "invoiceTerms": "<string>",
      "defaultPaymentTermsDays": 1,
      "logoDocumentId": "<string>",
      "unitPriceDecimalPlaces": 4,
      "branding": {
        "backgroundColor": "<string>",
        "titleColor": "<string>"
      }
    },
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.slash.com/llms.txt

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

Authorizations

​
X-API-Key
string
header
required

API key authentication for public API requests.

Keys come in two flavors:

  • Legal-entity-scoped keys are pinned to a single legal entity. Minted via the dashboard under a specific entity; every request acts on that entity.
  • User-scoped keys are pinned to a user and span every legal entity that user has access to. Every request made with a user-scoped key (except GET /legal-entity, which lists the legal entities the user can access) must include an x-legal-entity header naming the legal entity the request is operating on. Requests without the header are rejected with 400. The authenticated user must have an active permission role on the supplied legal entity, otherwise the request is rejected with 403.

Query Parameters

​
filter:legalEntityId
string

The legal entity ID. Required if authenticating with access to multiple legal entities.

Body

application/json

Invoice display settings for a legal entity.

​
companyName
string
required

The company name to display on invoices.

Minimum string length: 1
​
email
string<email>
required

The email address to display on invoices.

Minimum string length: 1
​
address
IAddressModel · object
required

The company address to display on invoices.

​
defaultMemo
string

Default memo text to pre-fill when creating new invoices.

Maximum string length: 500
​
invoiceTerms
string

Terms text to display on invoices. Only shown when INVOICE_TERMS_MAR_2026 feature flag is enabled.

Maximum string length: 2000
​
defaultPaymentTermsDays
integer

Default payment terms in days (Net N). Used to auto-calculate due date from issue date when creating invoices.

Required range: x >= 0
​
logoDocumentId
string

Document ID of the company logo to display on invoices.

​
unitPriceDecimalPlaces
integer

Number of decimal places allowed for unit prices (in dollars). Defaults to 2 if not set.

Required range: 2 <= x <= 6
​
branding
object

Custom branding settings for invoice styling. Extensible for future branding options.

Response

OK

​
invoiceSettings
InvoiceSettings · object
required

Full invoice settings entity for a legal entity, including metadata.