Create a new dimension
POST/v1/dimensions
Creates a new dimension in the accounting system for the authenticated user's organization
Request
Responses
- 201
- 400
- 401
- 402
- 403
- 409
- 429
- 500
- 502
- 503
- 504
Dimension created successfully
Response Headers
URI of the created dimension resource
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.
Bad request (e.g., missing required fields, invalid data format)
Unauthorized
Payment required - Multiple Dimensions billing module is not activated for this organization (ERR_MODULE_NOT_ACTIVATED)
Forbidden (e.g., user has no organizations, insufficient scope privileges)
Conflict - Resource already exists or managed:
- Dimension with the same name already exists (
ERR_DIMENSION_NAME_ALREADY_EXISTS) - Dimension with the same ERP ID already exists (
ERR_DIMENSION_ERP_ID_ALREADY_EXISTS) - 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.
Service temporarily unavailable. An upstream service returned a 503 error.
Gateway timeout. An upstream service did not respond in time.