> ## Documentation Index > Fetch the complete documentation index at: https://docs.claap.io/llms.txt > Use this file to discover all available pages before exploring further. # Create recording AI field > Create a recording AI field, evaluated by AI against each recording transcript. The field is owned by the workspace member identified by `creatorEmail`. The field is evaluated for new recordings going forward; no values are generated for existing recordings. Creates a recording AI field, evaluated by AI against each recording transcript. `creatorEmail` must belong to an active workspace member, who becomes the field author. The field is evaluated for new recordings going forward; no values are generated for existing recordings. ## OpenAPI ````yaml POST /v1/recordings/fields openapi: 3.1.0 info: title: Claap API description: Development documentation version: 0.0.0 servers: - url: https://api.claap.io/ security: - ApiKey: [] paths: /v1/recordings/fields: post: description: >- Create a recording AI field, evaluated by AI against each recording transcript. The field is owned by the workspace member identified by `creatorEmail`. The field is evaluated for new recordings going forward; no values are generated for existing recordings. operationId: postV1RecordingsAiFields parameters: [] requestBody: content: application/json: schema: type: object properties: title: type: string description: The field title. prompt: $ref: '#/components/schemas/AiFieldPromptInput' description: The prompt evaluated by the AI to fill the field. creatorEmail: type: string format: email description: >- Email address of the field creator. It must belong to an active workspace member, who becomes the field author. crmField: $ref: '#/components/schemas/AiFieldCrmFieldInput' description: >- The CRM property to map the field to. When omitted, the field is not mapped to the CRM. required: - title - prompt - creatorEmail example: title: Objections raised prompt: outputType: List prompt: List the objections raised by the prospect during the call. hasTimecodes: true creatorEmail: jsmith@example.com responses: '200': description: Recording AI field was successfully created content: application/json: schema: type: object properties: result: $ref: '#/components/schemas/AiField' required: - result example: result: fieldId: AiSummarySection#Qh7Kd2Rm9Tz4Vb1Ns6Xa0 title: Objections raised kind: Field outputType: List prompt: List the objections raised by the prospect during the call. hasTimecodes: true authorId: Xk2Rd7Mv4Bn9Ts1Lq6Wf3 createdAt: '2026-05-14T09:30:00Z' '400': description: >- `creatorEmail` does not belong to an active workspace member, the prompt is invalid (for instance `coloredSelectOptions` is missing for a `Select` or `MultiSelect` prompt), or the CRM mapping is invalid (the CRM property was not found, its type does not match the output type, or the select options do not match the CRM property options) '403': description: >- The workspace plan does not include AI fields, or the workspace only allows Admins to create AI fields and the creator is not an Admin components: schemas: AiFieldPromptInput: type: object properties: outputType: type: string enum: - ActionList - Checkbox - Date - List - MultiSelect - Numeric - Paragraph - Rating - RichText - Select description: The type of value produced by the AI. prompt: type: string description: Instructions describing what the AI should extract. coloredSelectOptions: type: array items: $ref: '#/components/schemas/AiFieldSelectOption' description: >- The options the AI can choose from. Required for the `Select` and `MultiSelect` output types, ignored otherwise. hasTimecodes: type: boolean description: >- Whether list items are linked to the moment of the recording they were extracted from. Only used by the `List` output type. ratingScale: type: integer minimum: 2 description: The maximum rating. Only used by the `Rating` output type. default: 5 required: - outputType - prompt description: The prompt evaluated by the AI to fill the field. AiFieldCrmFieldInput: type: object properties: entity: type: string enum: - Call - Company - Contact - Deal - Lead - Meeting description: The CRM entity the property belongs to. name: type: string description: The CRM property name. required: - entity - name description: >- The CRM property to map the AI field to. The property must exist in the connected CRM and its type must be compatible with the output type. AiField: type: object properties: fieldId: type: string description: >- AI field identifier. Matches the `fieldId` of `AiSection` view columns. title: type: string description: The field title. kind: type: string enum: - Field - Global - View description: >- The kind of AI section. Fields managed through the API are always of kind `Field`. outputType: type: string enum: - ActionList - Checkbox - Date - List - MultiSelect - Numeric - Paragraph - Rating - RichText - Select description: The type of value produced by the AI. prompt: type: string description: Instructions describing what the AI should extract. coloredSelectOptions: type: array items: $ref: '#/components/schemas/AiFieldSelectOption' description: >- The options the AI can choose from. Only set for the `Select` and `MultiSelect` output types. hasTimecodes: type: boolean description: >- Whether list items are linked to the moment of the recording they were extracted from. Only set for the `List` output type. ratingScale: type: integer description: The maximum rating. Only set for the `Rating` output type. crmField: $ref: '#/components/schemas/AiFieldCrmField' description: >- The CRM property the field is mapped to. Never set for company AI fields. authorId: type: string description: Identifier of the user who created the field. archivedAt: type: string format: date-time description: When the field was archived. Only set on archived fields. createdAt: type: string format: date-time description: When the field was created. required: - fieldId - title - kind - outputType - prompt - createdAt description: >- An AI field: a custom prompt with a typed output, evaluated by AI. Usable as an `AiSection` view column through its `fieldId`. AiFieldSelectOption: type: object properties: value: type: string description: The option label, as chosen by the AI and displayed in Claap. color: type: string enum: - blue - green - yellow - purple - red - bordeaux - turquoise description: The option color in the Claap interface. required: - value - color description: An option of a `Select` or `MultiSelect` AI field. AiFieldCrmField: type: object properties: entity: type: string enum: - Call - Company - Contact - Deal - Lead - Meeting description: The CRM entity the property belongs to. label: type: string description: The CRM property label. name: type: string description: The CRM property name. source: type: string enum: - Attio - Hubspot - Pipedrive - Salesforce description: The CRM the property comes from. type: type: string enum: - Checkbox - Date - MultiSelect - Numeric - RichText - Select - Text description: The CRM property type. required: - entity - label - name - source - type description: The CRM property the AI field is mapped to. securitySchemes: ApiKey: type: apiKey in: header name: X-Claap-Key ````