Create Form

Creates a new form under the specified project.


POST /v1/forms

Request


curl -X POST https://api.formtorch.com/v1/forms \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "p9q8r7s6t5",
    "name": "Contact Form"
  }'

Request body

Field	Type	Required	Description
`projectId`	string	Yes	ID of the project to create the form under
`name`	string	Yes	Display name for the form

Response

Returns the created form object with status 201 Created.


{
  "id": "a1b2c3d4e5",
  "name": "Contact Form",
  "projectId": "p9q8r7s6t5",
  "endpoint": "https://formtorch.com/f/a1b2c3d4e5",
  "submissionCount": 0,
  "createdAt": "2025-03-15T10:00:00.000Z",
  "updatedAt": "2025-03-15T10:00:00.000Z"
}

Response fields

Field	Type	Description
`id`	string	Form ID (10 characters)
`name`	string	Form display name
`projectId`	string	Parent project ID
`endpoint`	string	Full submission endpoint URL
`submissionCount`	integer	Always `0` for a new form
`createdAt`	string	ISO 8601 creation timestamp
`updatedAt`	string	ISO 8601 last updated timestamp