Ledger Accounts

Create Ledger Accounts in batch

Changed on

Create multiple ledger accounts in a single request. Each item is processed independently, so some may be created while others fail; the response returns 200 with one result per item, in the order the items were sent. The maximum number of items accepted per request depends on the connector.

post/accounting/ledger-accounts/batch

Request

  • Base URL: https://unify.apideck.com
  • URL: https://unify.apideck.com/accounting/ledger-accounts/batch
  • Auth: API key in header Authorization

Query parameters

rawboolean

Include raw response. Mostly used for debugging purposes

Headers

x-apideck-consumer-idstring required

ID of the consumer which you want to get or push data from

x-apideck-app-idstring required

The ID of your Unify application

x-apideck-service-idstring

Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API.

x-apideck-company-idstring

The ID of the company to scope requests to. For connectors that support multi-company, this overrides the default company configured in connection settings.

Request body

Example request

{
  "items": [
    {
      "_ref": "item-1",
      "data": {
        "display_id": "1-12345",
        "nominal_code": "N091",
        "code": "453",
        "classification": "asset",
        "type": "bank",
        "sub_type": "CHECKING_ACCOUNT",
        "name": "Bank account",
        "fully_qualified_name": "Asset.Bank.Checking_Account",
        "description": "Main checking account",
        "opening_balance": 75000,
        "current_balance": 20000,
        "currency": "USD",
        "tax_type": "NONE",
        "tax_rate": {
          "id": "123456",
          "code": "N-T",
          "name": "GST on Purchases",
          "rate": 10
        },
        "level": 1,
        "active": true,
        "status": "active",
        "header": true,
        "bank_account": {
          "bank_name": "Chase Bank",
          "account_number": "123465",
          "account_name": "Main Operating Account",
          "account_type": "credit_card",
          "iban": "GB33BUKB20201555555555",
          "bic": "CHASUS33",
          "routing_number": "021000021",
          "bsb_number": "062-001",
          "branch_identifier": "001",
          "bank_code": "BNH",
          "currency": "USD",
          "country": "US"
        },
        "parent_account": {
          "id": "12345",
          "name": "Bank Accounts",
          "display_id": "1-1100"
        },
        "last_reconciliation_date": "2020-09-30",
        "custom_fields": [
          {
            "id": "2389328923893298",
            "name": "employee_level",
            "ref_name": "Marketing",
            "description": "Employee Level",
            "value": "Uses Salesforce and Marketo"
          }
        ],
        "row_version": "1-12345",
        "pass_through": [
          {
            "extend_paths": [
              {
                "path": "$.nested.property",
                "value": {
                  "TaxClassificationRef": {
                    "value": "EUC-99990201-V1-00020000"
                  }
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

Response

Ledger Accounts batch processed

status_codeinteger required

HTTP Response Status Code

statusstring required

HTTP Response Status

servicestring required

Apideck ID of service provider

resourcestring required

Unified API resource name

operationstring required

Operation performed

_rawRaw nullable

Raw response from the integration when raw=true query param is provided

Example response

{
  "status_code": 200,
  "status": "OK",
  "service": "quickbooks",
  "resource": "ledger-accounts",
  "operation": "add",
  "data": [
    {
      "_ref": "item-1",
      "id": "12345",
      "downstream_id": "12345",
      "status": "created",
      "error": {
        "status_code": 502,
        "error": "Bad Gateway",
        "type_name": "PostWriteProcessingError",
        "message": "The record was written, but processing its response failed.",
        "ref": "https://developers.apideck.com/errors#postwriteprocessingerror"
      },
      "warnings": [
        {
          "type": "currency_not_configured",
          "operation": "invoicesAdd",
          "message": "Currency \"CAD\" is not configured for this organization -- the request was sent without currency_id.",
          "status_code": 200
        }
      ]
    }
  ]
}

Changes