Create forms

curl --request POST \
  --url https://app.azalt.co/api/v1/forms \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "formNames": [
    "<string>"
  ],
  "siteIds": [
    "<string>"
  ],
  "years": [
    123
  ]
}
'

[
  {
    "id": "<string>",
    "name": "<string>"
  }
]

Form

Create forms

Create one or more new data collection forms with comprehensive configuration options. Requires site manager permissions.

Required Parameters:

name: Unique form name within the organization
description: Detailed description of the form’s purpose
elements: Array of form elements with their configurations
siteIds: List of sites where this form will be deployed

Form Element Types (11 supported types):

text: Single-line text input with validation
number: Numeric input with min/max constraints
date: Date picker with range validation
dropdown: Single-select from predefined options
checkbox: Multiple selection from options
radio: Single selection from mutually exclusive options
file: File upload with type and size restrictions
html: Rich text content and instructions
section: Organizational grouping of elements
calculated: Mathematical expressions using other element values
lookup: Dynamic options from dataset tables

Advanced Features:

Conditional logic for element visibility
Period-based data collection (monthly, quarterly, annual)
Custom validation rules and error messages
File attachment requirements
Public access configuration with optional password protection

POST

forms

Create forms

curl --request POST \
  --url https://app.azalt.co/api/v1/forms \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "formNames": [
    "<string>"
  ],
  "siteIds": [
    "<string>"
  ],
  "years": [
    123
  ]
}
'

[
  {
    "id": "<string>",
    "name": "<string>"
  }
]

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

formNames

string[]

required

Minimum array length: 1

siteIds

string[]

required

years

number[]

required

Response

Successful response

string

required

name

string

required

List forms Delete forms