Create a new dimension item
POST/v1/dimensions/:dimensionId/items
Creates a new dimension item for the specified dimension within the authenticated user's organization
Request
Responses
- 201
- 400
- 401
- 402
- 403
- 404
- 409
- 429
- 500
- 502
- 504
Dimension item created successfully
Response Headers
URI of the created dimension item
/v1/dimensions/af5f2270-9a4d-467f-9ca7-69562369979c/items/8a684e99-d19b-4f83-8239-7ac89aa1109cMaximum number of requests allowed in the current rate limit window for the used scope.
Number of requests remaining in the current rate limit window.
Unix timestamp (seconds since epoch, UTC) when the rate limit window resets.
The OAuth scope bucket to which this rate limit applies: read or write.
Bad request (e.g., invalid data format, validation errors)
Unauthorized
Payment required - Multiple Dimensions billing module is not activated for this organization (ERR_MODULE_NOT_ACTIVATED).
Only applies when creating items for custom dimensions (not cost centers or cost carriers).
Forbidden (e.g., user has no organizations, insufficient scope privileges)
Dimension not found
Conflict - Resource conflict:
- Dimension item with the same value already exists (
ERR_DIMENSION_ITEM_VALUE_ALREADY_EXISTS) - Dimension is inactive (
ERR_DIMENSION_INACTIVE) - Resource is managed by an active accounting integration (
ERR_MANAGED_RESOURCE_IMMUTABLE)
Rate limit exceeded. Reduce request frequency and retry after the indicated number of seconds.
Response Headers
Maximum number of requests allowed in the current rate limit window for the used scope.
Number of requests remaining in the current rate limit window.
Unix timestamp (seconds since epoch, UTC) when the rate limit window resets.
The OAuth scope bucket to which this rate limit applies: read or write.
Number of seconds to wait before retrying. Only present on 429 Too Many Requests responses.
Internal server error
Bad gateway. An upstream service could not be reached.
Gateway timeout. An upstream service did not respond in time.