> ## 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 tax code value > Creates a new value for the given tax code. Returns 403 when the organization does not exist or the authenticated user is not an administrator of it. Returns 404 when the tax code does not exist, has already been deleted, or has no value list configured yet. Returns 409 when a value with the same `id` already exists for this tax code. ## OpenAPI ````yaml /openapi/findity-admin-api.json post /organizations/{organizationId}/taxcodes/{taxCodeId}/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}/taxcodes/{taxCodeId}/values: post: tags: - Tax codes summary: Create tax code value description: > Creates a new value for the given tax code. Returns 403 when the organization does not exist or the authenticated user is not an administrator of it. Returns 404 when the tax code does not exist, has already been deleted, or has no value list configured yet. Returns 409 when a value with the same `id` already exists for this tax code. operationId: adminCreateTaxCodeValue 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: taxCodeId in: path required: true description: >- String. The ID of the tax code to add a value to (32-character hex string), as returned in the `id` field of the list or GET response. schema: type: string example: 63b7a7802a644e8ca296c9796ffa7074 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AdminApiTaxCodeValuePostRequest' example: id: VAT25 value: 25% sortOrder: 0 responses: '201': description: Created — returns the newly created tax code value content: application/json: schema: $ref: '#/components/schemas/AdminApiTaxCodeValue' example: id: VAT25 value: 25% 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: No known, or only read-only properties received Invalid property value: value: result: error code: INVALID_JSON_PROPERTY_VALUE description: value is required Field exceeds max length: value: result: error code: FIELD_EXCEEDS_MAX_LENGTH description: value exceeds maximum length of 255 characters. '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 — tax code does not exist, has been deleted, or has no value list configured yet content: application/json: schema: $ref: '#/components/schemas/404Error' examples: Tax code not found: value: result: error code: TAX_CODE_NOT_FOUND description: Tax code not found Tax code value list not found: value: result: error code: TAX_CODE_VALUE_NOT_FOUND description: Tax code value list not found '409': description: >- Conflict — a value with the same `id` already exists for this tax code content: application/json: schema: $ref: '#/components/schemas/409Error' examples: Tax code value already exists: value: result: error description: A tax code value with id 'VAT25' already exists components: schemas: AdminApiTaxCodeValuePostRequest: type: object required: - id - value properties: id: type: string description: >- Caller-supplied identifier for this value. Must be unique within the tax code. maxLength: 255 value: type: string description: >- Display text of the tax code 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 AdminApiTaxCodeValue: type: object required: - id - value properties: id: type: string description: Unique identifier of the tax code value. value: type: string description: Display text of the tax code 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 ````