--- title: "GET /marketing/v3/forms" method: GET path: "/marketing/v3/forms" tags: ["Basic"] --- # GET /marketing/v3/forms `GET /marketing/v3/forms` ## Query parameters - `after` string - `archived` boolean - `formTypes` string[] - `limit` integer ## Response `200` successful operation - CollectionResponseFormDefinitionBaseForwardPaging - `paging` ForwardPaging - `next` NextPage — Specifies the paging information needed to retrieve the next set of results in a paginated API response - `after` string, required — The pagination cursor token used to fetch the next page of results. Pass this value in subsequent requests to continue pagination. - `link` string — The complete URL to retrieve the next page of results in paginated responses. - `results` HubSpotFormDefinition[], required - `archived` boolean, required - `archivedAt` string, date-time - `configuration` HubSpotFormConfiguration, required - `allowLinkToResetKnownValues` boolean, required — 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. - `archivable` boolean, required — Whether the form can be archived. - `cloneable` boolean, required — Whether the form can be cloned. - `createNewContactForNewEmail` boolean, required — 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. - `editable` boolean, required — Whether the form can be edited. - `embedType` 'V3' | 'V4' - `language` 'af' | 'ar-eg' | 'bg' | 'bn' | 'ca-es' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'en-gb' | 'es' | 'es-mx' | 'fi' | 'fr' | 'fr-ca' | 'he-il' | 'hr' | 'hu' | 'id' | 'it' | 'ja' | 'ko' | 'lt' | 'ms' | 'nl' | 'no-no' | 'pl' | 'pt' | 'pt-br' | 'ro' | 'ru' | 'sk' | 'sl' | 'sv' | 'th' | 'tl' | 'tr' | 'uk' | 'vi' | 'zh-cn' | 'zh-hk' | 'zh-tw', required — The language of the form. - `lifecycleStages` LifecycleStage[], required - `objectTypeId` string, required — The objectTypeId for both contact and company - `value` string, required — The internal name of the contact's lifecycle stage set when submitting a form - `notifyContactOwner` boolean, required — Whether to send a notification email to the contact owner when a submission is received. - `notifyRecipients` string[], required — The list of user IDs to receive a notification email when a submission is received. - `postSubmitAction` FormPostSubmitAction, required - `type` 'redirect_url' | 'thank_you', required — The action to take after submit. The default action is displaying a thank you message. - `value` string, required — The thank you text or the page to redirect to. - `prePopulateKnownValues` boolean, required — Whether contact fields should pre-populate with known information when a contact returns to your site. - `recaptchaEnabled` boolean, required — Whether CAPTCHA (spam prevention) is enabled. - `createdAt` string, date-time, required - `displayOptions` FormDisplayOptions, required - `cssClass` string — Custom CSS class name(s) to apply to the form element for additional styling. - `renderRawHtml` boolean, required — Whether the form will render as raw HTML as opposed to inside an iFrame. - `style` FormStyle, required - `backgroundWidth` string, required — The width of the form background. Accepts percentage (e.g., "100%") or pixel values (e.g., "600px"). - `fontFamily` string, required — Font family used throughout the form (e.g., "arial, helvetica, sans-serif"). - `helpTextColor` string, required — Hex color code for help text displayed below form fields. - `helpTextSize` string, required — Font size for help text. Accepts pixel values (e.g., "11px"). - `labelTextColor` string, required — Hex color code for field labels. - `labelTextSize` string, required — Font size for field labels. Accepts pixel values (e.g., "11px"). - `legalConsentTextColor` string, required — Hex color code for legal consent text. - `legalConsentTextSize` string, required — Font size for legal consent text. Accepts pixel values (e.g., "14px"). - `submitAlignment` 'center' | 'left' | 'right', required — Horizontal alignment of the submit button. Values: left, center, right. - `submitColor` string, required — Hex color code for the submit button background. - `submitFontColor` string, required — Hex color code for the submit button text. - `submitSize` string, required — Font size for submit button text. Accepts pixel values (e.g., "12px"). - `submitButtonText` string, required — The text displayed on the form submit button. - `theme` 'canvas' | 'default_style' | 'legacy' | 'linear' | 'round' | 'sharp', required — The theme used for styling the input fields. This will not apply if the form is added to a HubSpot CMS page. - `fieldGroups` FieldGroup[], required - `fields` union[], required — The form fields included in the group - union - EmailField - `defaultValue` string — The value filled in by default. This value will be submitted unless the customer modifies it. - `dependentFields` DependentField[], required — A list of other fields to make visible based on the value filled in for this field. - … - `description` string — Additional text helping the customer to complete the field. - `fieldType` 'email', required — Determines how the field will be displayed and validated. - `hidden` boolean, required — Whether a field should be hidden or not. Hidden fields won't appear on the form, but can be used to pass a value to a property without requiring the customer to fill it in. - `label` string, required — The main label for the form field. - `name` string, required — The identifier of the field. In combination with the object type ID, it must be unique. - `objectTypeId` string, required — A unique ID for this field's CRM object type. For example a CONTACT field will have the object type ID 0-1. - `placeholder` string — The prompt text showing when the field isn't filled in. - `required` boolean, required — Whether a value for this field is required when submitting the form. - `validation` EmailFieldValidation, required - … - PhoneField - `defaultValue` string — The value filled in by default. This value will be submitted unless the customer modifies it. - `dependentFields` DependentField[], required — A list of other fields to make visible based on the value filled in for this field. - … - `description` string — Additional text helping the customer to complete the field. - `fieldType` 'phone', required — Determines how the field will be displayed and validated. - `hidden` boolean, required — Whether a field should be hidden or not. Hidden fields won't appear on the form, but can be used to pass a value to a property without requiring the customer to fill it in. - `label` string, required — The main label for the form field. - `name` string, required — The identifier of the field. In combination with the object type ID, it must be unique. - `objectTypeId` string, required — A unique ID for this field's CRM object type. For example a CONTACT field will have the object type ID 0-1. - `placeholder` string — The prompt text showing when the field isn't filled in. - `required` boolean, required — Whether a value for this field is required when submitting the form. - `useCountryCodeSelect` boolean, required — Whether to display a country code drop down next to the phone field. - `validation` PhoneFieldValidation, required - … - MobilePhoneField - `defaultValue` string — The value filled in by default. This value will be submitted unless the customer modifies it. - `dependentFields` DependentField[], required — A list of other fields to make visible based on the value filled in for this field. - … - `description` string — Additional text helping the customer to complete the field. - `fieldType` 'mobile_phone', required — Determines how the field will be displayed and validated. - `hidden` boolean, required — Whether a field should be hidden or not. Hidden fields won't appear on the form, but can be used to pass a value to a property without requiring the customer to fill it in. - `label` string, required — The main label for the form field. - `name` string, required — The identifier of the field. In combination with the object type ID, it must be unique. - `objectTypeId` string, required — A unique ID for this field's CRM object type. For example a CONTACT field will have the object type ID 0-1. - `placeholder` string — The prompt text showing when the field isn't filled in. - `required` boolean, required — Whether a value for this field is required when submitting the form. - `validation` PhoneFieldValidation, required - … - SingleLineTextField - `defaultValue` string — The value filled in by default. This value will be submitted unless the customer modifies it. - `dependentFields` DependentField[], required — A list of other fields to make visible based on the value filled in for this field. - … - `description` string — Additional text helping the customer to complete the field. - `fieldType` 'single_line_text', required — Determines how the field will be displayed and validated. - `hidden` boolean, required — Whether a field should be hidden or not. Hidden fields won't appear on the form, but can be used to pass a value to a property without requiring the customer to fill it in. - `label` string, required — The main label for the form field. - `name` string, required — The identifier of the field. In combination with the object type ID, it must be unique. - `objectTypeId` string, required — A unique ID for this field's CRM object type. For example a CONTACT field will have the object type ID 0-1. - `placeholder` string — The prompt text showing when the field isn't filled in. - `required` boolean, required — Whether a value for this field is required when submitting the form. - MultiLineTextField - `defaultValue` string — The value filled in by default. This value will be submitted unless the customer modifies it. - `dependentFields` DependentField[], required — A list of other fields to make visible based on the value filled in for this field. - … - `description` string — Additional text helping the customer to complete the field. - `fieldType` 'multi_line_text', required — Determines how the field will be displayed and validated. - `hidden` boolean, required — Whether a field should be hidden or not. Hidden fields won't appear on the form, but can be used to pass a value to a property without requiring the customer to fill it in. - `label` string, required — The main label for the form field. - `name` string, required — The identifier of the field. In combination with the object type ID, it must be unique. - `objectTypeId` string, required — A unique ID for this field's CRM object type. For example a CONTACT field will have the object type ID 0-1. - `placeholder` string — The prompt text showing when the field isn't filled in. - `required` boolean, required — Whether a value for this field is required when submitting the form. - NumberField - `defaultValue` string — The value filled in by default. This value will be submitted unless the customer modifies it. - `dependentFields` DependentField[], required — A list of other fields to make visible based on the value filled in for this field. - … - `description` string — Additional text helping the customer to complete the field. - `fieldType` 'number', required — Determines how the field will be displayed and validated. - `hidden` boolean, required — Whether a field should be hidden or not. Hidden fields won't appear on the form, but can be used to pass a value to a property without requiring the customer to fill it in. - `label` string, required — The main label for the form field. - `name` string, required — The identifier of the field. In combination with the object type ID, it must be unique. - `objectTypeId` string, required — A unique ID for this field's CRM object type. For example a CONTACT field will have the object type ID 0-1. - `placeholder` string — The prompt text showing when the field isn't filled in. - `required` boolean, required — Whether a value for this field is required when submitting the form. - `validation` NumberFieldValidation - … - SingleCheckboxField - `defaultValue` string — The value filled in by default. This value will be submitted unless the customer modifies it. - `dependentFields` DependentField[], required — A list of other fields to make visible based on the value filled in for this field. - … - `description` string — Additional text helping the customer to complete the field. - `fieldType` 'single_checkbox', required — Determines how the field will be displayed and validated. - `hidden` boolean, required — Whether a field should be hidden or not. Hidden fields won't appear on the form, but can be used to pass a value to a property without requiring the customer to fill it in. - `label` string, required — The main label for the form field. - `name` string, required — The identifier of the field. In combination with the object type ID, it must be unique. - `objectTypeId` string, required — A unique ID for this field's CRM object type. For example a CONTACT field will have the object type ID 0-1. - `required` boolean, required — Whether a value for this field is required when submitting the form. - MultipleCheckboxesField - `defaultValues` string[], required — The values selected by default. Those values will be submitted unless the customer modifies them. - `dependentFields` DependentField[], required — A list of other fields to make visible based on the value filled in for this field. - … - `description` string — Additional text helping the customer to complete the field. - `fieldType` 'multiple_checkboxes', required — Determines how the field will be displayed and validated. - `hidden` boolean, required — Whether a field should be hidden or not. Hidden fields won't appear on the form, but can be used to pass a value to a property without requiring the customer to fill it in. - `label` string, required — The main label for the form field. - `name` string, required — The identifier of the field. In combination with the object type ID, it must be unique. - `objectTypeId` string, required — A unique ID for this field's CRM object type. For example a CONTACT field will have the object type ID 0-1. - `options` EnumeratedFieldOption[], required — The list of available choices for this field. - … - `required` boolean, required — Whether a value for this field is required when submitting the form. - DropdownField - `defaultValues` string[], required — The values selected by default. Those values will be submitted unless the customer modifies them. - `dependentFields` DependentField[], required — A list of other fields to make visible based on the value filled in for this field. - … - `description` string — Additional text helping the customer to complete the field. - `fieldType` 'dropdown', required — Determines how the field will be displayed and validated. - `hidden` boolean, required — Whether a field should be hidden or not. Hidden fields won't appear on the form, but can be used to pass a value to a property without requiring the customer to fill it in. - `label` string, required — The main label for the form field. - `name` string, required — The identifier of the field. In combination with the object type ID, it must be unique. - `objectTypeId` string, required — A unique ID for this field's CRM object type. For example a CONTACT field will have the object type ID 0-1. - `options` EnumeratedFieldOption[], required — The list of available choices for this field. - … - `placeholder` string — The prompt text showing when the field isn't filled in. - `required` boolean, required — Whether a value for this field is required when submitting the form. - RadioField - `defaultValues` string[], required — The values selected by default. Those values will be submitted unless the customer modifies them. - `dependentFields` DependentField[], required — A list of other fields to make visible based on the value filled in for this field. - … - `description` string — Additional text helping the customer to complete the field. - `fieldType` 'radio', required — Determines how the field will be displayed and validated. - `hidden` boolean, required — Whether a field should be hidden or not. Hidden fields won't appear on the form, but can be used to pass a value to a property without requiring the customer to fill it in. - `label` string, required — The main label for the form field. - `name` string, required — The identifier of the field. In combination with the object type ID, it must be unique. - `objectTypeId` string, required — A unique ID for this field's CRM object type. For example a CONTACT field will have the object type ID 0-1. - `options` EnumeratedFieldOption[], required — The list of available choices for this field. - … - `placeholder` string — The prompt text showing when the field isn't filled in. - `required` boolean, required — Whether a value for this field is required when submitting the form. - DatepickerField - `defaultValue` string — The value filled in by default. This value will be submitted unless the customer modifies it. - `dependentFields` DependentField[], required — A list of other fields to make visible based on the value filled in for this field. - … - `description` string — Additional text helping the customer to complete the field. - `fieldType` 'datepicker', required — Determines how the field will be displayed and validated. - `hidden` boolean, required — Whether a field should be hidden or not. Hidden fields won't appear on the form, but can be used to pass a value to a property without requiring the customer to fill it in. - `label` string, required — The main label for the form field. - `name` string, required — The identifier of the field. In combination with the object type ID, it must be unique. - `objectTypeId` string, required — A unique ID for this field's CRM object type. For example a CONTACT field will have the object type ID 0-1. - `placeholder` string — The prompt text showing when the field isn't filled in. - `required` boolean, required — Whether a value for this field is required when submitting the form. - FileField - `allowMultipleFiles` boolean, required — Whether to allow the upload of multiple files. - `defaultValue` string — The value filled in by default. This value will be submitted unless the customer modifies it. - `dependentFields` DependentField[], required — A list of other fields to make visible based on the value filled in for this field. - … - `description` string — Additional text helping the customer to complete the field. - `fieldType` 'file', required — Determines how the field will be displayed and validated. - `hidden` boolean, required — Whether a field should be hidden or not. Hidden fields won't appear on the form, but can be used to pass a value to a property without requiring the customer to fill it in. - `label` string, required — The main label for the form field. - `name` string, required — The identifier of the field. In combination with the object type ID, it must be unique. - `objectTypeId` string, required — A unique ID for this field's CRM object type. For example a CONTACT field will have the object type ID 0-1. - `placeholder` string — The prompt text showing when the field isn't filled in. - `required` boolean, required — Whether a value for this field is required when submitting the form. - PaymentLinkRadioField - `defaultValues` string[], required - `dependentFields` DependentField[], required - … - `description` string — Additional descriptive text about the field. - `fieldType` 'payment_link_radio', required — The field type identifier. - `hidden` boolean, required — Whether the field is a hidden field. - `label` string, required — The visible label displayed with the field to describe its purpose to form users. - `name` string, required — The internal API name used to identify this field in API requests and responses. - `objectTypeId` string, required — The CRM object type this field is associated with (e.g., contacts, deals). - `options` EnumeratedFieldOption[], required - … - `required` boolean, required — Whether users must select an option before submitting the form. - `groupType` 'default_group' | 'progressive' | 'queued', required — The type of field grouping. Values: default_group (standard fields), progressive, and queued. - `richText` string — A block of rich text or an image. Those can be used to add extra information for the customers filling in the form. If the field group includes fields, the rich text will be displayed before the fields. - `richTextType` 'image' | 'text', required — The type of rich text included. The default value is text. Values: text, image. - `formType` 'hubspot', required - `id` string, required - `legalConsentOptions` union, required - LegalConsentOptionsNone - `type` 'none', required — The legal consent type. Set to "none" to indicate no legal consent configuration is required for this form. - LegalConsentOptionsLegitimateInterest - `lawfulBasis` 'client' | 'lead' | 'other', required — The lawful basis for data processing under legitimate interest. Values: lead (processing for lead generation), client (processing for existing clients), other (other legitimate interests). Default: lead. - `privacyText` string, required — Text explaining the privacy policy and data handling practices. - `subscriptionTypeIds` integer[], required - `type` 'legitimate_interest', required — The legal consent type. - LegalConsentOptionsExplicitConsentToProcess - `communicationConsentText` string — Text explaining communication consent preferences. Informs users about how their contact information will be used for communications. - `communicationsCheckboxes` LegalConsentCheckbox[], required - `label` string, required — The main label for the form field. - `required` boolean, required — Whether this checkbox is required when submitting the form. - `subscriptionTypeId` integer, required — The ID of the subscription type associated with this consent checkbox. - `consentToProcessCheckboxLabel` string — Label text for the consent to process checkbox. - `consentToProcessFooterText` string — Footer text for the consent to process section. - `consentToProcessText` string — Text explaining the consent to process personal data. - `privacyText` string, required — Text explaining the privacy policy and data handling practices. Required field that informs users about their privacy rights and how their data is protected. - `type` 'explicit_consent_to_process', required — The legal consent type. - LegalConsentOptionsImplicitConsentToProcess - `communicationConsentText` string — Text explaining communication consent preferences. - `communicationsCheckboxes` LegalConsentCheckbox[], required - `label` string, required — The main label for the form field. - `required` boolean, required — Whether this checkbox is required when submitting the form. - `subscriptionTypeId` integer, required — The ID of the subscription type associated with this consent checkbox. - `consentToProcessText` string — Text explaining the consent to process personal data. - `privacyText` string, required — Text explaining the privacy policy and data handling practices. - `type` 'implicit_consent_to_process', required — The legal consent type. - `name` string, required - `updatedAt` string, date-time, required ## Other responses - `default` — An error occurred. --- [API](https://skmtc.net/hubspot/apis/marketing-forms.md) · [All operations](https://skmtc.net/hubspot/apis/marketing-forms/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/marketing-forms/versions/0a2f094f9ab4/schema)