Skip to main content

​
Forms API

Manage forms programmatically.

​
List Forms

​
GET
Returns all forms in the workspace associated with your API key.
curl https://www.zevform.com/api/v1/forms \
  -H "Authorization: Bearer zev_your_api_key"

​
Response

{
  "forms": [
    {
      "id": "form_abc123",
      "title": "Customer Feedback",
      "status": "published",
      "response_count": 42,
      "created_at": "2026-03-01T10:00:00Z",
      "updated_at": "2026-03-15T14:30:00Z"
    }
  ]
}

​
Create Form

curl -X POST https://www.zevform.com/api/v1/forms \
  -H "Authorization: Bearer zev_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My New Form",
    "questions": [
      {
        "type": "short_text",
        "title": "What is your name?"
      },
      {
        "type": "email",
        "title": "Email address",
        "required": true
      },
      {
        "type": "rating",
        "title": "How would you rate our service?"
      }
    ]
  }'

​
Response

{
  "id": "form_xyz789",
  "title": "My New Form",
  "status": "draft",
  "questions": [...],
  "created_at": "2026-03-27T10:00:00Z"
}

​
Get Form

curl https://www.zevform.com/api/v1/forms/form_abc123 \
  -H "Authorization: Bearer zev_your_api_key"

​
Update Form

curl -X PATCH https://www.zevform.com/api/v1/forms/form_abc123 \
  -H "Authorization: Bearer zev_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated Title",
    "status": "published"
  }'

​
Delete Form

curl -X DELETE https://www.zevform.com/api/v1/forms/form_abc123 \
  -H "Authorization: Bearer zev_your_api_key"