Objects

Create form

Creates a new form. Optionally pass fields to add questions to the form's first page in one call. SINGLE_OPTION / MULTIPLE_OPTION fields must include a non-empty values list of allowed options.

post/forms

Request

  • Base URL: https://api.heffl.com/api/v2
  • URL: https://api.heffl.com/api/v2/forms
  • Auth: API key in header x-api-key

Request body

titlestring required

Form title

descriptionstring nullable

Form description shown to respondents

Response

OK

idstring required

Form ID (frm_ prefix)

titlestring required

Form title

descriptionstring nullable required

Form description shown to respondents

entitystring nullable required

CRM entity this form is associated with (e.g. leads, deals), if any

submissionCountnumber required

Total number of submissions received

createdByIdstring nullable required

ID of the user who created the form (usr_ prefix)

createdByNamestring nullable required

Name of the user who created the form

createdAtstring date-time required

When the form was created

updatedAtstring date-time nullable required

When the form was last updated

Changes

No recorded changes to this operation across all 1 revision of this API.