Skip to main content
PATCH
/
forms
/
{id}
Update a form
curl --request PATCH \
  --url https://api.heffl.com/api/v2/forms/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "title": "<string>",
  "description": "<string>"
}
'
{
  "id": "<string>",
  "title": "<string>",
  "description": "<string>",
  "entity": "<string>",
  "submissionCount": 123,
  "createdById": "<string>",
  "createdByName": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
x-api-key
string
header
required

API key for authentication. Get yours at app.heffl.com/settings/developers

Path Parameters

​
id
string
required

Form ID (frm_ prefix)

Body

application/json
​
title
string

Form title

​
description
string | null

Form description shown to respondents

Response

OK

​
id
string
required

Form ID (frm_ prefix)

​
title
string
required

Form title

​
description
string | null
required

Form description shown to respondents

​
entity
string | null
required

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

​
submissionCount
number
required

Total number of submissions received

​
createdById
string | null
required

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

​
createdByName
string | null
required

Name of the user who created the form

​
createdAt
string<date-time>
required

When the form was created

​
updatedAt
string<date-time> | null
required

When the form was last updated