USuseboom
Lead Capture

Get an embedded form

Changed on

Get one embedded form: its editable draft, the embed tags, whether the draft has unpublished changes, and anything stopping it from being published.

get/api/v1/lead-capture/embedded-forms/{formId}

Request

  • Base URL
    https://www.useboom.ai
  • Auth
    HTTP bearer

Path parameters

formIdstring required

Form id.

Response

Success

idstring required
namestring required
status'PAUSED' | 'ACTIVE' required
allowedOriginsstring[] required
installKeystring required

Public; identifies the form in the embed.

publishedVersionnumber nullable required

The version visitors get; null until first published.

unpublishedChangesboolean required

The draft differs from the published version.

updatedAtstring required
embedTagstring required

Paste where the form should appear, together with installTag.

installTagstring required
draftobject required

The editable config: steps, fields (typed questions with key, options[].value, score, sensitive), endings (with score ranges), consent, hidden, constants, partials (enabled, notice: keep what a visitor answered when they leave without submitting) and design. Edit it and send it back as draft to lead_capture_embedded_forms_update; lists are replaced whole. Visitors see nothing until lead_capture_embedded_forms_publish.

publishIssuesstring[] required

Why the draft cannot be published yet; empty when it can.

Changes