Update invoice settings

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>"
  }
}
'

const options = {
  method: 'PUT',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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>'}
  })
};

fetch('https://api.slash.com/invoice/settings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.slash.com/invoice/settings"

payload = {
    "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>"
    }
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.slash.com/invoice/settings"

	payload := strings.NewReader("{\n  \"companyName\": \"<string>\",\n  \"email\": \"jsmith@example.com\",\n  \"address\": {\n    \"addressLine\": \"<string>\",\n    \"addressCity\": \"<string>\",\n    \"addressState\": \"<string>\",\n    \"addressZip\": \"<string>\",\n    \"addressLine2\": \"<string>\",\n    \"addressCountry\": \"<string>\"\n  },\n  \"defaultMemo\": \"<string>\",\n  \"invoiceTerms\": \"<string>\",\n  \"defaultPaymentTermsDays\": 1,\n  \"logoDocumentId\": \"<string>\",\n  \"unitPriceDecimalPlaces\": 4,\n  \"branding\": {\n    \"backgroundColor\": \"<string>\",\n    \"titleColor\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "invoiceSettings": {
    "$entity": "invoice_settings",
    "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"
  }
}

{
  "message": "<string>",
  "name": "<string>",
  "identifier": "<string>",
  "rawStatus": 123,
  "meta": {}
}

{
  "message": "<string>",
  "name": "<string>",
  "identifier": "<string>",
  "rawStatus": 123,
  "meta": {}
}

{
  "message": "<string>",
  "name": "<string>",
  "identifier": "<string>",
  "rawStatus": 123,
  "meta": {}
}

{
  "message": "<string>",
  "name": "<string>",
  "identifier": "<string>",
  "rawStatus": 123,
  "meta": {}
}

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

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.

Hide child attributes

address.addressLine

string

required

address.addressCity

string

required

address.addressState

string

required

address.addressZip

string

required

address.addressLine2

string

address.addressCountry

string

ISO 3166-1 Alpha-2 Country Code (e.g., US, FR, UK, DE, ...).

Required string length: 2

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 an invoice_logo document owned by this legal entity or its Slash accounts or account groups. Other document types are rejected.

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.

Hide child attributes

branding.backgroundColor

string

Hex color code for header background and accent elements (e.g., pay button).

Pattern: ^#[0-9A-Fa-f]{6}$

branding.titleColor

string

Hex color code for title text, amounts, and section headings.

Pattern: ^#[0-9A-Fa-f]{6}$

Response

invoiceSettings

InvoiceSettings · object

required

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

Hide child attributes

invoiceSettings.$entity

enum<string>

required

Available options:

invoice_settings

invoiceSettings.id

string

required

invoiceSettings.legalEntityId

string

required

invoiceSettings.settings

InvoiceSettingsData · object

required

Invoice display settings for a legal entity.

Hide child attributes

invoiceSettings.settings.companyName

string

required

The company name to display on invoices.

Minimum string length: 1

invoiceSettings.settings.email

string<email>

required

The email address to display on invoices.

Minimum string length: 1

invoiceSettings.settings.address

IAddressModel · object

required

The company address to display on invoices.

Hide child attributes

invoiceSettings.settings.address.addressLine

string

required

invoiceSettings.settings.address.addressCity

string

required

invoiceSettings.settings.address.addressState

string

required

invoiceSettings.settings.address.addressZip

string

required

invoiceSettings.settings.address.addressLine2

string

invoiceSettings.settings.address.addressCountry

string

ISO 3166-1 Alpha-2 Country Code (e.g., US, FR, UK, DE, ...).

Required string length: 2

invoiceSettings.settings.defaultMemo

string

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

Maximum string length: 500

invoiceSettings.settings.invoiceTerms

string

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

Maximum string length: 2000

invoiceSettings.settings.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

invoiceSettings.settings.logoDocumentId

string

Document ID of an invoice_logo document owned by this legal entity or its Slash accounts or account groups. Other document types are rejected.

invoiceSettings.settings.unitPriceDecimalPlaces

integer

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

Required range: 2 <= x <= 6

invoiceSettings.settings.branding

object

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

Hide child attributes

invoiceSettings.settings.branding.backgroundColor

string

Hex color code for header background and accent elements (e.g., pay button).

Pattern: ^#[0-9A-Fa-f]{6}$

invoiceSettings.settings.branding.titleColor

string

Hex color code for title text, amounts, and section headings.

Pattern: ^#[0-9A-Fa-f]{6}$

invoiceSettings.timestamp

string<date-time>

required

⌘I

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>"
  }
}
'

const options = {
  method: 'PUT',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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>'}
  })
};

fetch('https://api.slash.com/invoice/settings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.slash.com/invoice/settings"

payload = {
    "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>"
    }
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.slash.com/invoice/settings"

	payload := strings.NewReader("{\n  \"companyName\": \"<string>\",\n  \"email\": \"jsmith@example.com\",\n  \"address\": {\n    \"addressLine\": \"<string>\",\n    \"addressCity\": \"<string>\",\n    \"addressState\": \"<string>\",\n    \"addressZip\": \"<string>\",\n    \"addressLine2\": \"<string>\",\n    \"addressCountry\": \"<string>\"\n  },\n  \"defaultMemo\": \"<string>\",\n  \"invoiceTerms\": \"<string>\",\n  \"defaultPaymentTermsDays\": 1,\n  \"logoDocumentId\": \"<string>\",\n  \"unitPriceDecimalPlaces\": 4,\n  \"branding\": {\n    \"backgroundColor\": \"<string>\",\n    \"titleColor\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "invoiceSettings": {
    "$entity": "invoice_settings",
    "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"
  }
}

{
  "message": "<string>",
  "name": "<string>",
  "identifier": "<string>",
  "rawStatus": 123,
  "meta": {}
}

{
  "message": "<string>",
  "name": "<string>",
  "identifier": "<string>",
  "rawStatus": 123,
  "meta": {}
}

{
  "message": "<string>",
  "name": "<string>",
  "identifier": "<string>",
  "rawStatus": 123,
  "meta": {}
}

{
  "message": "<string>",
  "name": "<string>",
  "identifier": "<string>",
  "rawStatus": 123,
  "meta": {}
}

Overview

Entities

Legal Entity

Account

Account Authorization Webhooks

Virtual Account

Transaction

Transfer Money

Card

Card Group

Invoice

Invoice Series

Expense Report

Customer

Contact

Merchant

Webhooks

Agent Requests

Tokens

Update invoice settings

Authorizations

Query Parameters

Body

Response