> ## 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

> Creates a new tax code for the given organization. Returns 403 when the organization does not exist or the authenticated user is not an administrator of it.




## OpenAPI

````yaml /openapi/findity-admin-api.json post /organizations/{organizationId}/taxcodes
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:
    post:
      tags:
        - Tax codes
      summary: Create tax code
      description: >
        Creates a new tax code for the given organization. Returns 403 when the
        organization does not exist or the authenticated user is not an
        administrator of it.
      operationId: adminCreateTaxCode
      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
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdminApiTaxCodePostRequest'
            example:
              description: Swedish VAT 25%
      responses:
        '201':
          description: Created — returns the newly created tax code
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdminApiTaxCode'
              example:
                id: 63b7a7802a644e8ca296c9796ffa7074
                description: Swedish VAT 25%
        '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: Description is required
                Description too long:
                  value:
                    result: error
                    code: FIELD_EXCEEDS_MAX_LENGTH
                    description: Description 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
components:
  schemas:
    AdminApiTaxCodePostRequest:
      type: object
      required:
        - description
      properties:
        description:
          type: string
          description: >-
            Display name of the tax code. Must be non-empty and not
            whitespace-only.
          maxLength: 255
    AdminApiTaxCode:
      type: object
      required:
        - id
        - description
      properties:
        id:
          type: string
          description: Unique identifier for the tax code.
        description:
          type: string
          description: Display name of the tax code.
    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
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````