BlueTally
API integration

list_all_blue_tally_accessories

List all accessories in bluetally. Returns: id, name, model_number, order_number, purchase_date, purchase_cost, currency, minimum_quantity, quantity, available, category_id, manufacturer_id, supplier_id, location_id, department_id, qr_code, logo, notes, custom_fields, checked_out_to_employees, checked_out_to_locations, created_at, updated_at, unit_cost. Supports exact-match filters (name,…

get_single_blue_tally_accessory_by_id

Get a single accessory in bluetally by id. Returns the full accessory object including id, name, model_number, quantity, available, custom_fields, and checked_out_to_employees. Required: id.

create_a_blue_tally_accessory

Create a new accessory in bluetally. Returns an empty 201 response on success. Requires name, quantity, and category_id.

update_a_blue_tally_accessory_by_id

Update an accessory in bluetally by id. Returns an empty 200 response on success. Required: id.

delete_a_blue_tally_accessory_by_id

Delete an accessory in bluetally by id. This action is permanent and cannot be undone. Returns an empty 204 response on success. Required: id.

blue_tally_accessories_check_in

Check in an accessory in bluetally, returning it to available stock. Returns an empty 201 response on success. Required: accessory_id, checkin_date (YYYY-MM-DD).

blue_tally_accessories_check_out

Check out a quantity of an accessory in bluetally to an employee or location on a given date. Returns an empty 201 response on success. Required: accessory_id, quantity, checkout_date (YYYY-MM-DD).

list_all_blue_tally_activity

List all activity log entries in bluetally. Returns each entry's timestamp, user_id, user_name, type, event, item_id, item_name, checked_out_to_from_name, and notes. Filter by date_from/date_to, type, event, user_email, employee_email, or item id.

list_all_blue_tally_assets

List all assets in bluetally. Returns asset records with id, asset_id, asset_serial, purchase_cost, product_name, and custom_fields; supports sorting and exact-match filters.

get_single_blue_tally_asset_by_id

Get a single asset in bluetally by id. Returns the full asset object including id, asset_id, asset_serial, product_name, purchase_cost, custom_fields, and deployed_to. Required: id.

create_a_blue_tally_asset

Create an asset in bluetally. Returns the created asset object including id, asset_id, asset_name, product_name, and custom_fields. Required: asset_id, product_id, status_id.

update_a_blue_tally_asset_by_id

Update an asset in bluetally by id. Returns the updated asset object including id, asset_id, asset_serial, product_name, and custom_fields. Required: id.

delete_a_blue_tally_asset_by_id

Delete an asset in bluetally by id. Returns an empty 204 response on success. Required: id. Deletion is permanent and cannot be undone.

blue_tally_assets_check_in

Check-in an asset in bluetally, optionally recording its condition, notes, and the location or department it should belong to. Returns an empty 201 response on success. Required: asset_id, checkin_date, status_id.

blue_tally_assets_check_out

Check-out an asset in bluetally to an employee or location, optionally recording its condition, notes, and the expected check-in date. Returns an empty 201 response on success. Required: asset_id, checkout_date.

list_all_blue_tally_audits

List all bluetally audits. Returns audit records including id, audit_date, audit_status, scheduled, completed, asset_id, user_id, and created_at; sorted by audit_date ascending by default.

get_single_blue_tally_audit_by_id

Get a single bluetally audit by id. Returns the full audit record including id, audit_date, audit_status, scheduled, completed, asset_id, user_id, notes, and created_at. Required: id.

create_a_blue_tally_audit

Create an audit in bluetally. Returns the created audit including id, audit_date, audit_status, scheduled, completed, asset_id, and user_id. Required: audit_date, scheduled, completed, asset_id, user_id. Completed audits need audit_status passed or failed; user_id is a BlueTally user ID (see activity log).

update_a_blue_tally_audit_by_id

Update a bluetally audit by id. Returns the updated audit including id, audit_date, audit_status, scheduled, completed, asset_id, and user_id. Required: id.

delete_a_blue_tally_audit_by_id

Delete a bluetally audit by id. Deletion is permanent and cannot be undone. Returns an empty 204 response on success. Required: id.

list_all_blue_tally_categories

List all categories in bluetally, filterable by exact name and category type. Returns: id, name, type, eula, skip_checkout_emails, logo, number_of_assets, number_of_accessories, number_of_components, number_of_consumables, number_of_licenses, number_of_products, assets, accessories, consumables, licenses, products, minimum_quantity, number_of_deployable_assets, created_at, updated_at, …

get_single_blue_tally_category_by_id

Get a single bluetally category by id. Returns: id, name, type, eula, skip_checkout_emails, logo, number_of_assets, number_of_accessories, number_of_components, number_of_consumables, number_of_licenses, number_of_products, assets, accessories, consumables, licenses, products, minimum_quantity, number_of_deployable_assets, created_at, updated_at, …

create_a_blue_tally_category

Create a category in bluetally. Returns an empty 204 response on success. Required: name and type.

update_a_blue_tally_category_by_id

Update a category in bluetally by id. Returns the updated category including id, name, type, eula, skip_checkout_emails, logo, asset counts, and created_at/updated_at timestamps. Required: id.

delete_a_blue_tally_category_by_id

Delete a category in bluetally by id. Returns an empty 204 response on success. Deletion is permanent and cannot be undone. Required: id.

list_all_blue_tally_components

List all components in BlueTally. Returns component records with id, name, model_number, quantity, available, purchase_cost, and category_id. Supports exact-match filters (name, model_number, purchase_date, unit_cost, category_id, location_id, and more) plus sort and order.

get_single_blue_tally_component_by_id

Get a specific component in BlueTally by id. Returns the full component record including id, name, model_number, quantity, available, purchase_cost, custom_fields, and checked_out_to. Required: id.

create_a_blue_tally_component

Create a component in BlueTally. Returns the created component record including id, name, quantity, available, purchase_cost, and category_id. Requires name, quantity, and category_id.

update_a_blue_tally_component_by_id

Update a component in BlueTally by id. Returns the updated component record including id, name, quantity, available, purchase_cost, and category_id. Required: id.

delete_a_blue_tally_component_by_id

Permanently delete a component in BlueTally by id. This action is irreversible and cannot be undone. Returns an empty 204 response on success. Required: id.

blue_tally_components_check_in

Check in a component in bluetally, returning it to stock from the asset it was checked out to. Returns an empty 201 response on success. Required: component_id, asset_id, checkin_date (YYYY-MM-DD).

blue_tally_components_check_out

Check out a component in bluetally to an asset in a given quantity. Returns an empty 201 response on success. Required: component_id, asset_id, quantity, checkout_date (YYYY-MM-DD).

list_all_blue_tally_consumables

List all consumables in bluetally. Returns each consumable with id, name, model_number, purchase_cost, currency, minimum_quantity, available, custom_fields, checked_out_to_employees, created_at, and updated_at. Supports exact-match filters and sorting.

get_single_blue_tally_consumable_by_id

Get a single consumable in bluetally by id. Returns: id, name, model_number, order_number, purchase_date, purchase_cost, currency, minimum_quantity, available, category_id, manufacturer_id, supplier_id, location_id, department_id, logo, notes, custom_fields, checked_out_to_employees, checked_out_to_locations, created_at, updated_at, unit_cost, …

create_a_blue_tally_consumable

Create a consumable in bluetally. Returns an empty 201 response on success. Required: name, quantity, category_id.

update_a_blue_tally_consumable_by_id

Update a consumable in bluetally by id. Returns an empty 200 response on success. Required: id.

delete_a_blue_tally_consumable_by_id

Permanently delete a consumable in bluetally by id. This action is irreversible and cannot be undone. Returns an empty 204 response on success. Required: id.

blue_tally_consumables_check_out

Check out a consumable in bluetally, recording the quantity checked out and the date of the checkout. Returns an empty 201 response on success. Required: consumable_id, quantity, checkout_date.

list_all_blue_tally_departments

List all departments in bluetally. Returns department records including id, name, email, phone, asset/accessory/component/consumable/license/employee counts, related ID lists, and created_at/updated_at timestamps. Supports exact-search filters on name, email, or phone and sorting by created_at, updated_at, or name.

get_single_blue_tally_department_by_id

Get a single department in bluetally by id. Returns the full department object including id, name, email, phone, related asset/accessory/license/employee ID lists, and created_at/updated_at timestamps. Required: id.

create_a_blue_tally_department

Create a department in bluetally. Returns an empty 201 response on success. Requires name, email, and phone.

update_a_blue_tally_department_by_id

Update a department in bluetally by id. Returns an empty 200 response on success. Required: id.

delete_a_blue_tally_department_by_id

Delete a department in bluetally by id. This action is permanent and cannot be undone. Returns an empty 200 response on success. Required: id.

list_all_blue_tally_depreciations

List all depreciations in bluetally. Returns depreciation records with id, name, months, minimum_value, asset/license/product id lists, and created_at/updated_at. Supports sorting and exact-match filtering by name, months, or minimum_value.

get_single_blue_tally_depreciation_by_id

Get a single depreciation in bluetally by id. Returns: id, name, months, minimum_value, number_of_assets, number_of_licenses, number_of_products, assets, licenses, products, created_at, updated_at. Required: id.

create_a_blue_tally_depreciation

Create a depreciation in bluetally. Returns the created depreciation including id, name, months, minimum_value, and created_at. Required: name and months.

update_a_blue_tally_depreciation_by_id

Update a depreciation in bluetally by id. Returns the updated depreciation including id, name, months, minimum_value, and updated_at. Required: id.

delete_a_blue_tally_depreciation_by_id

Delete a depreciation in bluetally by id. Deleting is permanent and cannot be undone. Returns an empty 204 response on success. Required: id.

list_all_blue_tally_employees

List all employees in bluetally. Returns: id, name, email, title, location_id, department_id, notes, archived, number_of_assets, number_of_accessories, number_of_consumables, number_of_licenses, assets, accessories, consumables, licenses, created_at, updated_at, custom_fields, manager_id. Supports exact-match filters:…

get_single_blue_tally_employee_by_id

Get a single bluetally employee by id. Returns the full employee object including: id, name, email, title, location_id, department_id, notes, archived, number_of_assets, custom_fields, created_at. Required: id.

create_a_blue_tally_employee

Create an employee in bluetally with the given profile details. Returns the created employee including: id, name, email, title, and custom_fields. Required: name, email.

update_a_blue_tally_employee_by_id

Update an employee in bluetally by id. Returns the updated employee including: id, name, email, title, and custom_fields. Required: id.

delete_a_blue_tally_employee_by_id

Delete an employee in bluetally by id. This action is permanent and cannot be undone. Returns an empty 200 response on success. Required: id.

list_all_blue_tally_licenses

List all licenses in bluetally. Returns each license's id, name, licensed_to_name, licensed_to_email, order_number, number_of_seats, seats, and license_type, sorted by name ascending by default. Supports exact-match filters on fields like licensed_to_email, order_number, and expiration_date, plus a billing_interval filter (monthly, quarterly, annually, one-time).

get_single_blue_tally_license_by_id

Get a single license in bluetally by id. Returns the full license object including id, name, licensed_to_email, seats with checkout details, billing_interval, and auto_renew. Required: id.

create_a_blue_tally_license

Create a license in bluetally. Returns the created license object including id, name, licensed_to_email, purchase_cost, number_of_seats, and billing_interval. Required: name, category_id.

update_a_blue_tally_license_by_id

Update a license in bluetally by id. Returns the updated license object including id, name, license_type, billing_interval, auto_renew, renewal_date, and seats. Required: id.

delete_a_blue_tally_license_by_id

Delete a license in bluetally by id. The deletion is permanent and cannot be undone. Returns an empty 204 response on success. Required: id.

blue_tally_licenses_check_in

Check in a bluetally license seat, returning it to the available pool. Returns an empty 201 response on success. Required: license_id, checkin_date. product_key is required for Product Key licenses.

blue_tally_licenses_check_out

Check out a bluetally license to an employee or asset. Returns an empty 201 response on success. Required: license_id, checkout_date. quantity is required for Dynamic licenses and product_key for Product Key licenses.

list_all_blue_tally_locations

List all bluetally locations. Returns locations with id, name, address_line_1, city, country, email, phone, currency, asset counts, related ID lists, created_at, updated_at, and custom_fields. Supports exact-match filters plus sort and order options.

get_single_blue_tally_location_by_id

Get a bluetally location by id. Returns the location's id, name, address_line_1, address_line_2, city, zip, state, country, email, phone, currency, logo, asset counts with related ID lists, created_at, updated_at, and custom_fields. Required: id.

create_a_blue_tally_location

Create a bluetally location. Returns the created location including id, name, address_line_1, city, currency, and created_at. Required: name.

update_a_blue_tally_location_by_id

Update a bluetally location by id. Returns the updated location including id, name, address_line_1, city, currency, and updated_at. Required: id.

delete_a_blue_tally_location_by_id

Permanently delete a bluetally location by id. Returns an empty 200 response on success. Required: id. Deletion is irreversible and cannot be undone.

list_all_blue_tally_maintenances

List all maintenances in bluetally. Returns maintenances with id, type, name, start_date, end_date, cost, asset_id, supplier_id, notes, created_at, and updated_at. Supports filtering by type, name, dates, cost, asset_id, and supplier_id.

get_single_blue_tally_maintenance_by_id

Get a single maintenance in bluetally by id. Returns the maintenance record including id, type, name, start_date, end_date, cost, asset_id, supplier_id, notes, created_at, and updated_at. Required: id.

create_a_blue_tally_maintenance

Create a maintenance in bluetally. Returns the created maintenance record including id, type, name, start_date, cost, asset_id, and created_at. Required: type, name, start_date, asset_id.

update_a_blue_tally_maintenance_by_id

Update a maintenance in bluetally by id. Returns the updated maintenance record including id, type, name, start_date, cost, asset_id, and updated_at. Required: id.

delete_a_blue_tally_maintenance_by_id

Delete a maintenance in bluetally by id. This action is permanent and cannot be undone. Returns an empty 204 response on success. Required: id.

list_all_blue_tally_manufacturers

List all manufacturers in bluetally. Returns each manufacturer's id, name, url, support_url, support_email, assets, products, and created_at/updated_at. Narrow results with exact-match filters such as name or url.

get_single_blue_tally_manufacturer_by_id

Get a single bluetally manufacturer by id. Returns the full manufacturer object including id, name, url, support_url, support_email, assets, products, and created_at/updated_at. Required: id.

create_a_blue_tally_manufacturer

Create a manufacturer in bluetally. Returns an empty 201 response on success. Required: name.

update_a_blue_tally_manufacturer_by_id

Update a manufacturer in bluetally by id. Returns an empty 200 response on success. Required: id.

delete_a_blue_tally_manufacturer_by_id

Delete a bluetally manufacturer by id. This action is permanent and cannot be undone. Returns an empty 204 response on success. Required: id.

list_all_blue_tally_products

List all products in bluetally. Supports exact-match filters (name, model_number, category_id, manufacturer_id, depreciation_id, archived, and more) plus sort/order. Returns: id, name, model_number, end_of_life_date, default_purchase_cost, category_id, manufacturer_id, depreciation_id, logo, notes, archived, custom_fields, number_of_assets, assets, end_of_life_type, end_of_life_months, …

get_single_blue_tally_product_by_id

Get a single bluetally product by id. Returns the full product object including id, name, model_number, default_purchase_cost, category_id, manufacturer_id, custom_fields, assets, and created_at. Required: id.

create_a_blue_tally_product

Create a product in bluetally. Returns the created product including id, name, model_number, end_of_life_type, category_id, and archived. Required: name, category_id.

update_a_blue_tally_product_by_id

Update a bluetally product by id. Returns the updated product including id, name, model_number, end_of_life_type, archived, and custom_fields. Required: id. Supply end_of_life_date when end_of_life_type is Fixed Date, or end_of_life_months for the months-based end-of-life types.

delete_a_blue_tally_product_by_id

Permanently delete a product in bluetally by id; the action cannot be undone. Returns an empty 204 response on success. Required: id.

list_all_blue_tally_statuses

List all statuses in bluetally, sortable and filterable by name, type, navigation visibility, and notes. Returns: id, name, type, show_in_nav, notes, number_of_assets, assets, created_at, updated_at.

get_single_blue_tally_status_by_id

Get a single status in bluetally by id. Returns: id, name, type, show_in_nav, notes, number_of_assets, assets, created_at, updated_at. Required: id.

create_a_blue_tally_status

Create a status in bluetally. Returns the created status object including id, name, type, show_in_nav, and created_at. Required: name and type.

update_a_blue_tally_status_by_id

Update a status in bluetally by id. Returns the updated status object including id, name, type, show_in_nav, and updated_at. Required: id.

delete_a_blue_tally_status_by_id

Delete a status in bluetally by id. This action is permanent and cannot be undone. Returns an empty 204 response on success. Required: id.

list_all_blue_tally_suppliers

List all suppliers in bluetally. Returns supplier records including id, name, contact_name, email, number_of_assets, and created_at. Supports exact-match filters and sorting (defaults to name, asc).

get_single_blue_tally_supplier_by_id

Get a single bluetally supplier by id. Returns the full supplier record including id, name, contact_name, email, url, and linked asset IDs. Required: id.

create_a_blue_tally_supplier

Create a supplier in bluetally. Returns the created supplier record including id, name, address, contact_name, and linked asset counts. Required: name.

update_a_blue_tally_supplier_by_id

Update a bluetally supplier by id. Returns the updated supplier record including id, name, contact_name, address_line_1, and number_of_assets. Required: id.

delete_a_blue_tally_supplier_by_id

Delete a bluetally supplier by id. This action is permanent and cannot be undone. Returns an empty 204 response on success. Required: id.

list_all_blue_tally_tenants

List the tenants this BlueTally API key can access (multi-tenancy accounts only). Returns: tenant_id, tenant_name. Use a tenant_id as the account's Tenant ID so other tools target that tenant.