financial/categories/create

Creates a new category in the chart of accounts

POST
https://api.elvanto.com/v1/financial/categories/create.{json|xml|php}

Notes

  • A status of 0 indicates an archived account
  • A status of 1 indicates an active account

Parameters

Name Type Description
name Required text Name of the category.
status integer 1 to indicate an active account (default) - 0 to indicate archived accounts.
tax_deductible string y to indicate the account is tax deductible. n to indicate it is not (default).
Expected request JSON HTTP POST
{
    "name": "General Giving",
    "tax_deductible": "y"
}
Expected response JSON XML PHP
{
    "generated_in": "0.018",
    "status": "ok",
    "category": {
        "id": "647f531a-6093-4aec-a56f-4fa2962228e0",
        "status": 1,
        "name": "General Giving",
        "tax_deductible": 1
    }
}
Error responses

Please see our response status codes documentation for details of potential error responses for any API request.

  • 250: Invalid Tax Deductible Option tax_deductible must be set to "y" or "n".
  • 250: Invalid Status Option Status must be set to 0 (Active) or 1 (Archived).
  • 250: Category name must be provided and non-empty Category name must be provided and non-empty.