> ## Documentation Index > Fetch the complete documentation index at: https://developer.findity.com/llms.txt > Use this file to discover all available pages before exploring further. # Create custom dimension value > Creates a new value for the given custom dimension definition. Returns 403 when the organization does not exist or the authenticated user is not an administrator of it. Returns 404 when the custom dimension definition is not found or has been deleted. Returns 409 when a value with the same `id` already exists in the definition. ## OpenAPI ````yaml /openapi/findity-admin-api.json post /organizations/{organizationId}/customdimensions/{definitionId}/values openapi: 3.1.0 info: title: Findity Admin API description: Findity Admin API version: 1.0.0 servers: - url: https://stage-api.findity.com/api/v1/admin - url: https://api.findity.com/api/v1/admin security: - bearerAuth: [] paths: /organizations/{organizationId}/customdimensions/{definitionId}/values: post: tags: - Dimensions summary: Create custom dimension value description: > Creates a new value for the given custom dimension definition. Returns 403 when the organization does not exist or the authenticated user is not an administrator of it. Returns 404 when the custom dimension definition is not found or has been deleted. Returns 409 when a value with the same `id` already exists in the definition. operationId: adminCreateCustomDimensionValue parameters: - name: organizationId in: path required: true description: > String. The organization's internal ID (32-character hex string) or its `externalSourceId`. When the value matches the format of an internal ID, the internal ID takes precedence. schema: type: string example: 11adfe2a080040e3892ffb89c21ec44e - name: definitionId in: path required: true description: >- String. The ID of the custom dimension definition to add a value to, as returned in the `id` field of the GET definition response. schema: type: string example: abc123def456abc123def456abc123de requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AdminApiCustomDimensionValuePostRequest' example: id: CC-001 value: Marketing sortOrder: 0 responses: '201': description: Created — returns the newly created custom dimension value content: application/json: schema: $ref: '#/components/schemas/AdminApiCustomDimensionValue' example: id: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 value: Marketing sortOrder: 0 startDate: null endDate: null '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/400Error' examples: Invalid JSON body: value: result: error code: INVALID_JSON_BODY description: Failed to parse json body. No known properties: value: result: error code: NO_KNOWN_JSON_PROPERTIES description: Request body contains no known properties Invalid property value: value: result: error code: INVALID_JSON_PROPERTY_VALUE description: value is required '403': description: Forbidden — organization not found or access denied content: application/json: schema: $ref: '#/components/schemas/403Error' examples: Organization not found or access denied: value: result: error description: Organization not found or access denied '404': description: >- Not found — custom dimension definition does not exist or has been deleted content: application/json: schema: $ref: '#/components/schemas/404Error' examples: Custom dimension definition not found: value: result: error code: CUSTOM_DIMENSION_DEFINITION_NOT_FOUND description: Custom dimension definition not found '409': description: >- Conflict — a value with the same `id` already exists in this dimension definition content: application/json: schema: $ref: '#/components/schemas/409Error' examples: Dimension value already exists: value: result: error description: A dimension value with id 'CC-001' already exists components: schemas: AdminApiCustomDimensionValuePostRequest: type: object required: - id - value properties: id: type: string description: >- Caller-supplied identifier for this value. Must be unique within the dimension definition. maxLength: 255 value: type: string description: >- Display text of the dimension value. Must be non-empty and not whitespace-only. maxLength: 255 sortOrder: type: integer description: Sort position of the value within the list. nullable: true startDate: type: string format: date-time description: Date from which this value is active. ISO 8601 format. nullable: true endDate: type: string format: date-time description: Date until which this value is active. ISO 8601 format. nullable: true AdminApiCustomDimensionValue: type: object required: - id - value properties: id: type: string description: Unique identifier of the dimension value. value: type: string description: Display text of the dimension value. sortOrder: type: integer description: Sort position of the value within the list. Null when not set. nullable: true startDate: type: string format: date-time description: Date from which this value is active. Null when not set. nullable: true endDate: type: string format: date-time description: Date until which this value is active. Null when not set. nullable: true 400Error: type: object properties: result: type: string code: type: string description: type: string 403Error: type: object properties: result: type: string description: type: string example: result: error description: Not allowed 404Error: type: object properties: result: type: string code: type: string description: type: string example: result: error code: ORGANIZATION_NOT_FOUND description: 'Failed to get organization for id: {orgId}' 409Error: type: object properties: result: type: string description: type: string example: result: error description: A dimension value with id 'CC-001' already exists securitySchemes: bearerAuth: type: http scheme: bearer ````