Mark an accounting entry ready to sync

POST

accounting

entries

{entryId}

mark-ready

Mark an accounting entry ready to sync

curl --request POST \
  --url https://api.slash.com/v2/accounting/entries/{entryId}/mark-ready \
  --header 'X-API-Key: <api-key>' \
  --header 'x-legal-entity: <x-legal-entity>'

const options = {
  method: 'POST',
  headers: {'x-legal-entity': '<x-legal-entity>', 'X-API-Key': '<api-key>'}
};

fetch('https://api.slash.com/v2/accounting/entries/{entryId}/mark-ready', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.slash.com/v2/accounting/entries/{entryId}/mark-ready"

headers = {
    "x-legal-entity": "<x-legal-entity>",
    "X-API-Key": "<api-key>"
}

response = requests.post(url, headers=headers)

print(response.text)

package main

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

func main() {

	url := "https://api.slash.com/v2/accounting/entries/{entryId}/mark-ready"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("x-legal-entity", "<x-legal-entity>")
	req.Header.Add("X-API-Key", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "id": "accounting_entry_2rj4l7hmrrrcv",
  "connectionId": "accounting_connection_2rj4l7hmrrrcv",
  "type": "unknown",
  "status": "in_review",
  "statusUpdatedAt": "2026-09-19T14:05:22.000Z",
  "date": "2026-09-18",
  "amount": {
    "amount": 123,
    "currency": "<string>"
  },
  "source": {
    "type": "transaction",
    "id": "agg_tx_2rj4l7hmrrrcv"
  },
  "transactionIds": [
    "agg_tx_2rj4l7hmrrrcv"
  ],
  "lineItems": [
    {
      "id": "accounting_line_item_2rj4l7hmrrrcv",
      "type": "fixed",
      "amount": {
        "amount": 123,
        "currency": "<string>"
      },
      "splitIndex": 0,
      "dimensions": {
        "account": {
          "id": "accounting_account_2rj4l7hmrrrcv",
          "name": "6100 Software Subscriptions"
        },
        "class": {
          "id": "accounting_class_3sk5m8inssscw",
          "name": "Engineering"
        }
      },
      "customFields": {
        "cf_cost_center": "CC-100"
      },
      "description": "AWS hosting",
      "transactionId": "agg_tx_2rj4l7hmrrrcv"
    }
  ],
  "lineItemLevelDimensions": [
    "account",
    "class"
  ],
  "entryLevelDimensions": [
    "department"
  ],
  "unsupportedDimensions": [
    "customer"
  ],
  "customFields": {
    "cf_approved_by": "jane@acme.com"
  },
  "attachments": [
    {
      "id": "accounting_attachment_2rj4l7hmrrrcv",
      "documentId": "st_2rj4l7hmrrrcv",
      "filename": "receipt-4471.pdf",
      "status": "pending_sync",
      "contentType": "application/pdf"
    }
  ],
  "createdAt": "2026-09-18T20:11:02.000Z",
  "updatedAt": "2026-09-19T14:05:22.000Z",
  "memo": "AWS hosting, September",
  "externalId": "1234",
  "externalUrl": "https://app.qbo.intuit.com/app/expense?txnId=1234",
  "lastSyncError": {
    "code": "qbo_invalid_account_type",
    "message": "The selected account type cannot be used for this type of transaction.",
    "title": "Invalid account type",
    "suggestion": "Use an Expense, Cost of Goods Sold, or Other Current Asset type account instead."
  }
}

Authorizations

X-API-Key

string

header

required

User API key authentication. Create a key under Settings → API keys in the Slash dashboard (https://app.slash.com/global-settings/api-keys) and send the x-legal-entity header naming the legal entity to act on with every request. Keys scoped to a legal entity are rejected with 403 user_api_key_required.

Headers

x-legal-entity

string

required

The legal entity to act on. Required on every request; a user API key can act on any legal entity its user has access to.

Pattern: ^le_[a-zA-Z0-9]+$

Path Parameters

entryId

string

required

Entry id with the accounting_entry_ prefix.

Response

The entry, now ready_to_sync.

The accounting record for one settled transaction (or group of related transactions) or one bill. An entry is created automatically when its source settles, coded with dimensions on its line items, and then synced to the connected platform. status tracks that lifecycle.

string

required

Entry id with the accounting_entry_ prefix.

Example:

"accounting_entry_2rj4l7hmrrrcv"

connectionId

string

required

The accounting connection the entry belongs to.

Example:

"accounting_connection_2rj4l7hmrrrcv"

type

enum<string>

required

What the entry represents on the platform. expense_card and expense_card_refund come from card transactions; bank_transfer, bank_deposit, and expense from account transactions; journal_entry from transactions posted as journals; bill is the accounts-payable bill and bill_payment the transaction that settles one. unknown entries have not yet been classified.

Available options:

unknown,

expense,

bank_transfer,

bank_deposit,

journal_entry,

expense_card,

expense_card_refund,

bill_payment,

bill

status

enum<string>

required

in_review until a user or rule marks it ready; ready_to_sync when coding is complete; pending_sync and syncing while a sync is queued or in flight; synced once the platform holds it; failed when the platform rejected it (see lastSyncError); archived when excluded from the books.

Available options:

in_review,

ready_to_sync,

pending_sync,

syncing,

synced,

archived,

failed

statusUpdatedAt

string<date-time>

required

When status last changed.

Example:

"2026-09-19T14:05:22.000Z"

date

string<date>

required

Accounting date as YYYY-MM-DD: the settlement date of the source transaction or the invoice date of the bill.

Example:

"2026-09-18"

amount

Money · object

required

Net amount in minor units. Negative for money leaving the account (expenses, bill payments) and positive for money arriving. On a bill's entry it is the bill's total, which is positive.

Hide child attributes

amount.amount

integer

required

Amount in the currency's minor units.

amount.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

source

object

required

What the entry was created from.

Hide child attributes

source.type

enum<string>

required

transaction entries reference a transaction; bill entries reference a bill from GET /v2/bills/{billId}.

Available options:

transaction,

bill

source.id

string

required

The transaction (agg_tx_) or bill (bill_) id. For transaction entries it is one of transactionIds.

Example:

"agg_tx_2rj4l7hmrrrcv"

transactionIds

string[]

required

Every transaction the entry covers. Usually one; internal transfers and card repayments combine two.

Example:

["agg_tx_2rj4l7hmrrrcv"]

lineItems

AccountingLineItem · object[]

required

Ordered fixed lines first, then editable lines by splitIndex.

Hide child attributes

lineItems.id

string

required

Line item id with the accounting_line_item_ prefix.

Example:

"accounting_line_item_2rj4l7hmrrrcv"

lineItems.type

enum<string>

required

fixed lines are set by Slash from the connection's account mappings and cannot be recoded. editable lines carry the dimensions you code.

Available options:

fixed,

editable

lineItems.amount

Money · object

required

Signed amount in minor units. Debits are positive and credits negative, so the lines of an entry sum to zero.

Hide child attributes

lineItems.amount.amount

integer

required

Amount in the currency's minor units.

lineItems.amount.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

lineItems.splitIndex

integer

required

Position of the line among the entry's editable lines; 0 for unsplit entries.

Example:

0

lineItems.dimensions

object

required

The line's coding, keyed by dimension key (see GET /v2/accounting/dimensions). Only dimensions with a value are present.

Hide child attributes

lineItems.dimensions.{key}

object

Hide child attributes

lineItems.dimensions.{key}.id

string

required

The dimension value id.

Example:

"accounting_account_2rj4l7hmrrrcv"

lineItems.dimensions.{key}.name

string

The value's display name at read time.

Example:

"6100 Software Subscriptions"

Example:

{
  "account": {
    "id": "accounting_account_2rj4l7hmrrrcv",
    "name": "6100 Software Subscriptions"
  },
  "class": {
    "id": "accounting_class_3sk5m8inssscw",
    "name": "Engineering"
  }
}

lineItems.customFields

object

required

Raw values of line-item level custom fields, keyed by the field's fieldKey from GET /v2/accounting/dimensions. Value type follows the field's fieldType: strings, numbers, booleans, or arrays of option values for multiselect.

Example:

{ "cf_cost_center": "CC-100" }

lineItems.description

string

Line memo sent to the platform.

Example:

"AWS hosting"

lineItems.transactionId

string

For transaction entries, the transaction this line settles. Entries that combine several transactions carry one fixed line per transaction.

Example:

"agg_tx_2rj4l7hmrrrcv"

lineItemLevelDimensions

string[]

required

For bill entries, the dimension keys coded per line item. Dimensions not listed take the same value on every line. Empty for transaction entries.

Example:

["account", "class"]

entryLevelDimensions

string[]

required

Dimension keys the platform records once per entry rather than per line item. Every line item carries the same value for these, and a split cannot code them differently across its lines.

Example:

["department"]

unsupportedDimensions

string[]

required

Dimension keys the platform does not accept for this entry type. Any value set on them is dropped at sync time.

Example:

["customer"]

customFields

object

required

Raw values of entry level custom fields, keyed by the field's fieldKey from GET /v2/accounting/dimensions.

Example:

{ "cf_approved_by": "jane@acme.com" }

attachments

AccountingAttachment · object[]

required

Hide child attributes

attachments.id

string

required

Attachment id with the accounting_attachment_ prefix.

Example:

"accounting_attachment_2rj4l7hmrrrcv"

attachments.documentId

string

required

The underlying document.

Example:

"st_2rj4l7hmrrrcv"

attachments.filename

string

required

Example:

"receipt-4471.pdf"

attachments.status

enum<string>

required

pending_sync until the entry has synced and the file has been pushed; synced once the platform holds a copy; failed when the push was rejected.

Available options:

pending_sync,

synced,

failed

attachments.contentType

string

MIME type of the file.

Example:

"application/pdf"

createdAt

string<date-time>

required

Example:

"2026-09-18T20:11:02.000Z"

updatedAt

string<date-time>

required

Example:

"2026-09-19T14:05:22.000Z"

memo

string

Memo sent to the platform.

Example:

"AWS hosting, September"

externalId

string

The platform's id for the synced record. Present once status is synced.

Example:

"1234"

externalUrl

string<uri>

A link to the record in the platform, when the platform provides one.

Example:

"https://app.qbo.intuit.com/app/expense?txnId=1234"

lastSyncError

object

Why the most recent sync attempt failed. Present while status is failed.

Hide child attributes

lastSyncError.code

string

required

Snake_case code from Slash's accounting error catalog, or sync_error when the failure isn't one Slash recognizes.

Example:

"qbo_invalid_account_type"

lastSyncError.message

string

required

What went wrong, in words you can show a user. For unrecognized failures this is the platform's own explanation when it gives one.

Example:

"The selected account type cannot be used for this type of transaction."

lastSyncError.title

string

required

Short summary of the failure.

Example:

"Invalid account type"

lastSyncError.suggestion

string

required

How to fix it.

Example:

"Use an Expense, Cost of Goods Sold, or Other Current Asset type account instead."

⌘I

Mark an accounting entry ready to sync

curl --request POST \
  --url https://api.slash.com/v2/accounting/entries/{entryId}/mark-ready \
  --header 'X-API-Key: <api-key>' \
  --header 'x-legal-entity: <x-legal-entity>'

const options = {
  method: 'POST',
  headers: {'x-legal-entity': '<x-legal-entity>', 'X-API-Key': '<api-key>'}
};

fetch('https://api.slash.com/v2/accounting/entries/{entryId}/mark-ready', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.slash.com/v2/accounting/entries/{entryId}/mark-ready"

headers = {
    "x-legal-entity": "<x-legal-entity>",
    "X-API-Key": "<api-key>"
}

response = requests.post(url, headers=headers)

print(response.text)

package main

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

func main() {

	url := "https://api.slash.com/v2/accounting/entries/{entryId}/mark-ready"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("x-legal-entity", "<x-legal-entity>")
	req.Header.Add("X-API-Key", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "id": "accounting_entry_2rj4l7hmrrrcv",
  "connectionId": "accounting_connection_2rj4l7hmrrrcv",
  "type": "unknown",
  "status": "in_review",
  "statusUpdatedAt": "2026-09-19T14:05:22.000Z",
  "date": "2026-09-18",
  "amount": {
    "amount": 123,
    "currency": "<string>"
  },
  "source": {
    "type": "transaction",
    "id": "agg_tx_2rj4l7hmrrrcv"
  },
  "transactionIds": [
    "agg_tx_2rj4l7hmrrrcv"
  ],
  "lineItems": [
    {
      "id": "accounting_line_item_2rj4l7hmrrrcv",
      "type": "fixed",
      "amount": {
        "amount": 123,
        "currency": "<string>"
      },
      "splitIndex": 0,
      "dimensions": {
        "account": {
          "id": "accounting_account_2rj4l7hmrrrcv",
          "name": "6100 Software Subscriptions"
        },
        "class": {
          "id": "accounting_class_3sk5m8inssscw",
          "name": "Engineering"
        }
      },
      "customFields": {
        "cf_cost_center": "CC-100"
      },
      "description": "AWS hosting",
      "transactionId": "agg_tx_2rj4l7hmrrrcv"
    }
  ],
  "lineItemLevelDimensions": [
    "account",
    "class"
  ],
  "entryLevelDimensions": [
    "department"
  ],
  "unsupportedDimensions": [
    "customer"
  ],
  "customFields": {
    "cf_approved_by": "jane@acme.com"
  },
  "attachments": [
    {
      "id": "accounting_attachment_2rj4l7hmrrrcv",
      "documentId": "st_2rj4l7hmrrrcv",
      "filename": "receipt-4471.pdf",
      "status": "pending_sync",
      "contentType": "application/pdf"
    }
  ],
  "createdAt": "2026-09-18T20:11:02.000Z",
  "updatedAt": "2026-09-19T14:05:22.000Z",
  "memo": "AWS hosting, September",
  "externalId": "1234",
  "externalUrl": "https://app.qbo.intuit.com/app/expense?txnId=1234",
  "lastSyncError": {
    "code": "qbo_invalid_account_type",
    "message": "The selected account type cannot be used for this type of transaction.",
    "title": "Invalid account type",
    "suggestion": "Use an Expense, Cost of Goods Sold, or Other Current Asset type account instead."
  }
}

Accounts

Virtual accounts

Contacts

Transfers

Transactions

Documents

Bills

Accounting

Mark an accounting entry ready to sync

Authorizations

Headers

Path Parameters

Response