Tracking Categories

Create Tracking Categories in batch

Changed on

Create multiple tracking categories 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/tracking-categories/batch

Request

  • Base URL: https://unify.apideck.com
  • URL: https://unify.apideck.com/accounting/tracking-categories/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": {
        "parent_id": "12345",
        "parent_name": "Area",
        "name": "Department",
        "code": "100",
        "status": "active",
        "row_version": "1-12345",
        "pass_through": [
          {
            "extend_paths": [
              {
                "path": "$.nested.property",
                "value": {
                  "TaxClassificationRef": {
                    "value": "EUC-99990201-V1-00020000"
                  }
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

Response

Tracking Categories 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": "tracking-categories",
  "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