> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scute.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Create user meta field

> Create a new user meta field for the application



## OpenAPI

````yaml /swagger.json post /v1/apps/{app_id}/user_meta_fields
openapi: 3.0.1
info:
  title: Scute API
  version: v1
  description: API for managing users in Scute applications
servers:
  - url: https://{defaultHost}
    variables:
      defaultHost:
        default: api.scute.io
  - url: http://localhost:3333
    description: Development server
security:
  - apiSecret: []
    userAccess: []
paths:
  /v1/apps/{app_id}/user_meta_fields:
    parameters:
      - name: app_id
        in: path
        required: true
        description: App ID
        schema:
          type: string
    post:
      tags:
        - User Meta Fields
      summary: Create user meta field
      description: Create a new user meta field for the application
      operationId: createUserMetaField
      parameters: []
      responses:
        '200':
          description: successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserMetaField'
        '401':
          description: unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '403':
          description: forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '404':
          description: not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
      security:
        - apiSecret: []
          userAccess: []
components:
  schemas:
    UserMetaField:
      type: object
      properties:
        id:
          type: string
          description: Meta field ID
          example: field_123
        app_id:
          type: string
          description: Application ID
        name:
          type: string
          description: Meta field name (used as key in user_meta)
          example: first_name
        field_type:
          type: string
          enum:
            - string
            - boolean
            - integer
            - date
            - phone
            - email
            - text
            - url
          description: Data type of the field
        required:
          type: boolean
          description: Whether this field is required during user creation
          example: false
        visible_profile:
          type: boolean
          description: Whether field is visible on profile component
          example: true
        visible_registration:
          type: boolean
          description: Whether field is visible during registration/login
          example: false
        position:
          type: integer
          description: Display order position
          example: 1
        as_verification_identifier:
          type: boolean
          description: >-
            Can be used as verification identifier (only for email and phone
            fields)
          example: false
        created_at:
          type: string
          format: date-time
          description: Creation timestamp
        updated_at:
          type: string
          format: date-time
          description: Last update timestamp
      required:
        - id
        - app_id
        - name
        - field_type
        - required
        - visible_profile
        - visible_registration
        - position
  securitySchemes:
    apiSecret:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: API Secret token
    userAccess:
      type: apiKey
      name: X-Authorization
      in: header
      description: User Access token

````