> ## Documentation Index > Fetch the complete documentation index at: https://docs.azalt.co/llms.txt > Use this file to discover all available pages before exploring further. # Create forms from CSV > Bulk create multiple forms from a structured CSV template, ideal for large-scale deployments. Requires site manager permissions. **CSV Format Requirements**: - **Form Definition Columns**: name, description, instructions - **Element Columns**: element_type, element_label, element_key, element_required, element_options - **Deployment Columns**: site_ids, year, period_type - **Configuration Columns**: public_access, password_protected, metadata **Supported Element Types**: All 11 form element types supported by the platform **Batch Processing Features**: - Multiple forms created in a single operation - Automatic element key generation for consistency - Site deployment across multiple locations - Validation and error reporting for each row **Use Cases**: - Deploying standardized forms across multiple sites - Migrating forms from external systems - Creating template-based form libraries - Rapid deployment for compliance requirements - Scaling data collection to hundreds of locations **Error Handling**: - Row-by-row validation with detailed error messages - Partial success handling (some forms created, others failed) - Preview mode to validate before actual creation - Rollback options for failed batch operations ## OpenAPI ````yaml https://app.azalt.co/api/v1/openapi.json post /forms/import-csv openapi: 3.0.3 info: title: Erguvan Public API version: 1.0.0 servers: - url: https://app.azalt.co/api/v1 security: [] paths: /forms/import-csv: post: tags: - Form summary: Create forms from CSV description: >- Bulk create multiple forms from a structured CSV template, ideal for large-scale deployments. Requires site manager permissions. **CSV Format Requirements**: - **Form Definition Columns**: name, description, instructions - **Element Columns**: element_type, element_label, element_key, element_required, element_options - **Deployment Columns**: site_ids, year, period_type - **Configuration Columns**: public_access, password_protected, metadata **Supported Element Types**: All 11 form element types supported by the platform **Batch Processing Features**: - Multiple forms created in a single operation - Automatic element key generation for consistency - Site deployment across multiple locations - Validation and error reporting for each row **Use Cases**: - Deploying standardized forms across multiple sites - Migrating forms from external systems - Creating template-based form libraries - Rapid deployment for compliance requirements - Scaling data collection to hundreds of locations **Error Handling**: - Row-by-row validation with detailed error messages - Partial success handling (some forms created, others failed) - Preview mode to validate before actual creation - Rollback options for failed batch operations operationId: createFormsFromCSV requestBody: required: true content: application/json: schema: type: object properties: forms: type: array items: type: object properties: name: type: string tags: type: array items: type: string siteIds: type: array items: type: string years: type: array items: type: number elements: type: array items: type: object properties: key: type: string label: type: string type: type: string enum: - NUMBER - SHORT_TEXT - LONG_TEXT - SINGLE_CHOICE - MULTIPLE_CHOICE optionValues: type: array items: type: string optionLabels: type: array items: type: string datasetItems: type: array items: type: string description: type: string placeholder: type: string unit: type: string unitId: type: string required: type: boolean period: type: string enum: - YEARLY - MONTHLY - QUARTERLY metadata: type: object additionalProperties: {} required: - key - label - type required: - name - siteIds - years - elements required: - forms responses: '200': description: Successful response content: application/json: schema: type: array items: type: object properties: id: type: string name: type: string required: - id - name '400': description: Invalid input data content: application/json: schema: $ref: '#/components/schemas/error.BAD_REQUEST' '401': description: Authorization not provided content: application/json: schema: $ref: '#/components/schemas/error.UNAUTHORIZED' '403': description: Insufficient access content: application/json: schema: $ref: '#/components/schemas/error.FORBIDDEN' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/error.INTERNAL_SERVER_ERROR' security: - Authorization: [] components: schemas: error.BAD_REQUEST: type: object properties: message: type: string description: The error message example: Invalid input data code: type: string description: The error code example: BAD_REQUEST issues: type: array items: type: object properties: message: type: string required: - message description: An array of issues that were responsible for the error example: [] required: - message - code title: Invalid input data error (400) description: The error information example: code: BAD_REQUEST message: Invalid input data issues: [] error.UNAUTHORIZED: type: object properties: message: type: string description: The error message example: Authorization not provided code: type: string description: The error code example: UNAUTHORIZED issues: type: array items: type: object properties: message: type: string required: - message description: An array of issues that were responsible for the error example: [] required: - message - code title: Authorization not provided error (401) description: The error information example: code: UNAUTHORIZED message: Authorization not provided issues: [] error.FORBIDDEN: type: object properties: message: type: string description: The error message example: Insufficient access code: type: string description: The error code example: FORBIDDEN issues: type: array items: type: object properties: message: type: string required: - message description: An array of issues that were responsible for the error example: [] required: - message - code title: Insufficient access error (403) description: The error information example: code: FORBIDDEN message: Insufficient access issues: [] error.INTERNAL_SERVER_ERROR: type: object properties: message: type: string description: The error message example: Internal server error code: type: string description: The error code example: INTERNAL_SERVER_ERROR issues: type: array items: type: object properties: message: type: string required: - message description: An array of issues that were responsible for the error example: [] required: - message - code title: Internal server error error (500) description: The error information example: code: INTERNAL_SERVER_ERROR message: Internal server error issues: [] securitySchemes: Authorization: type: http scheme: bearer ````