# MarketingForms - Catalog: `Forms` - Schema: `Basic` - Retrieve: True - Insert: True - Update: False - Delete: False ## Parameters of Table Function The following parameters can be used to control the behaviour of the table function `MarketingForms`. A value must be provided at all times for required parameters, but optional parameters in general do not need to have a value and the execution will default to a pre-defined behaviour. Values can be specified by position and by name. In both cases, all parameters not specified will be evaluated using their default values. Value specification by position is done by listing all values from the first to the last needed value. For example: a `select * from table(value1, value2, value3)` on a table with four parameters will use the default value for the fourth parameter and the specified values for the first three. Value specification by name is done by listing all values that require a value. For example with `select * from table(name1 => value1, name3 => value3)` on the same table will use the default values for the second and fourth parameters and the specified values for the first and third. | Name | Data Type | Required | Default Value | Documentation | |---|:---:|:---:|:---:|---| | `after` | `` | ☐ | | The paging cursor token of the last successfully read resource will be returned as the `paging.next.after` JSON property of a paged response containing more results. | | `archived` | `` | ☐ | | Whether to return only results that have been archived. | ## Columns of Table Function The columns of the table function `MarketingForms` are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert. | Name | Data Type | Label | Required | Documentation | |---|:---:|---|:---:|---| | `archived` | `char` | Archived | ☐ | | | `archivedAt` | `datetime` | Archived at | ☐ | | | `configuration_allowLinkToResetKnownValues` | `char` | | ☐ | Whether to add a reset link to the form. This removes any pre-populated content on the form and creates a new contact on submission. | | `configuration_archivable` | `char` | | ☐ | Whether the form can be archived. | | `configuration_cloneable` | `char` | | ☐ | Whether the form can be cloned. | | `configuration_createNewContactForNewEmail` | `char` | | ☐ | Whether to create a new contact when a form is submitted with an email address that doesn’t match any in your existing contacts records. | | `configuration_editable` | `char` | | ☐ | Whether the form can be edited. | | `configuration_embedType` | `varchar2` | | ☐ | | | `configuration_language` | `varchar2` | | ☐ | The language of the form. | | `configuration_notifyContactOwner` | `char` | | ☐ | Whether to send a notification email to the contact owner when a submission is received. | | `configuration_postSubmitAction_type` | `varchar2` | | ☐ | The action to take after submit. The default action is displaying a thank you message. | | `configuration_postSubmitAction_value` | `varchar2` | | ☐ | The thank you text or the page to redirect to. | | `configuration_prePopulateKnownValues` | `char` | | ☐ | Whether contact fields should pre-populate with known information when a contact returns to your site. | | `configuration_recaptchaEnabled` | `char` | | ☐ | Whether CAPTCHA (spam prevention) is enabled. | | `createdAt` | `datetime` | Created at | ☐ | | | `displayOptions_cssClass` | `varchar2` | | ☐ | Custom CSS class name(s) to apply to the form element for additional styling. | | `displayOptions_renderRawHtml` | `char` | | ☐ | Whether the form will render as raw HTML as opposed to inside an iFrame. | | `displayOptions_style_backgroundWidth` | `varchar2` | | ☐ | The width of the form background. Accepts percentage (e.g., "100%") or pixel values (e.g., "600px"). | | `displayOptions_style_fontFamily` | `varchar2` | | ☐ | Font family used throughout the form (e.g., "arial, helvetica, sans-serif"). | | `displayOptions_style_helpTextColor` | `varchar2` | | ☐ | Hex color code for help text displayed below form fields. | | `displayOptions_style_helpTextSize` | `varchar2` | | ☐ | Font size for help text. Accepts pixel values (e.g., "11px"). | | `displayOptions_style_labelTextColor` | `varchar2` | | ☐ | Hex color code for field labels. | | `displayOptions_style_labelTextSize` | `varchar2` | | ☐ | Font size for field labels. Accepts pixel values (e.g., "11px"). | | `displayOptions_style_legalConsentTextColor` | `varchar2` | | ☐ | Hex color code for legal consent text. | | `displayOptions_style_legalConsentTextSize` | `varchar2` | | ☐ | Font size for legal consent text. Accepts pixel values (e.g., "14px"). | | `displayOptions_style_submitAlignment` | `varchar2` | | ☐ | Horizontal alignment of the submit button. Values: left, center, right. | | `displayOptions_style_submitColor` | `varchar2` | | ☐ | Hex color code for the submit button background. | | `displayOptions_style_submitFontColor` | `varchar2` | | ☐ | Hex color code for the submit button text. | | `displayOptions_style_submitSize` | `varchar2` | | ☐ | Font size for submit button text. Accepts pixel values (e.g., "12px"). | | `displayOptions_submitButtonText` | `varchar2` | | ☐ | The text displayed on the form submit button. | | `displayOptions_theme` | `varchar2` | | ☐ | The theme used for styling the input fields. This will not apply if the form is added to a HubSpot CMS page. | | `formType` | `varchar2` | | ☐ | | | `id` | `varchar2` | ID | ☐ | | | `legalConsentOptions_type` | `varchar2` | | ☐ | The legal consent type. Set to "none" to indicate no legal consent configuration is required for this form. | | `name` | `varchar2` | Name | ☐ | | | `updatedAt` | `datetime` | Updated at | ☐ | |