Create a single new dimension | Ottimate Developer Documentation

Creates a new dimension with the provided details. The reference_id and erp_dimension_id are required for a successful creation.

AuthorizationBearer

OAuth2 authentication flows. Auth server URLs will vary by environment

X-Api-KeystringRequired

API key for authentication

X-API-VersionenumOptional

API version to use (optional, defaults to latest)

Allowed values:

ottimate_company_idintegerRequired

The Ottimate company ID this dimension belongs to

erp_typestringRequired

The dimension category label as displayed in the client’s ERP system (e.g., ‘Account’, ‘GLACCOUNT’, ‘Department’). This is client-specific.

ottimate_typeenumRequired

Ottimate's standardized dimension type code for consistent categorization.

namestringRequired

Display name of the dimension

codestringRequired

The GL code or short identifier for this dimension in the client's ERP system

reference_idstringRequired

A unique reference identifier that tracks this dimension across all client systems (ERP, inventory management, Ottimate)

erp_dimension_idstringRequired

The identifier assigned to this dimension by the client's ERP software

Successfully created

versionstring

idstring

namestring

erp_typestring

The dimension category label in client's ERP system

codestring

reference_idstring

ottimate_typeenum

Ottimate's standardized dimension type code

erp_dimension_idstring

ottimate_company_idinteger

400

Bad Request Error

1	curl -X POST https://api.ottimate.com/v1/dimensions \
2	-H "X-Api-Key: your-api-key-here" \
3	-H "X-API-Version: 1.0.0" \
4	-H "Authorization: Bearer <token>" \
5	-H "Content-Type: application/json" \
6	-d '{
7	"ottimate_company_id": 15196,
8	"erp_type": "Department",
9	"ottimate_type": "department",
10	"name": "Marketing Department",
11	"code": "MKT",
12	"reference_id": "dept-mkt-001",
13	"erp_dimension_id": "DEPT-MKT-001"
14	}'