curl --request GET \
--url https://api.hubapi.com/marketing/v3/forms/ \
--header 'Authorization: Bearer <token>'{
"results": [
{
"id": "b6336282-50ec-465e-894e-e368146fa25f",
"name": "Contact us",
"createdAt": "2020-09-22T05:15:12.311Z",
"updatedAt": "2020-09-22T05:15:35.361Z",
"archived": false,
"fieldGroups": [
{
"groupType": "default_group",
"richTextType": "text",
"fields": [
{
"objectTypeId": "0-1",
"name": "email",
"label": "Email",
"required": true,
"hidden": false,
"fieldType": "email",
"validation": {
"blockedEmailDomains": [],
"useDefaultBlockList": false
}
}
]
},
{
"groupType": "default",
"richTextType": "text",
"fields": [
{
"objectTypeId": "0-1",
"name": "firstname",
"label": "First name",
"required": false,
"hidden": false,
"fieldType": "single_line_text"
}
]
},
{
"groupType": "default",
"richTextType": "text",
"fields": [
{
"objectTypeId": "0-1",
"name": "lastname",
"label": "Last name",
"required": false,
"hidden": false,
"fieldType": "single_line_text"
}
]
},
{
"groupType": "default",
"richTextType": "text",
"fields": [
{
"objectTypeId": "0-1",
"name": "message",
"label": "Message",
"required": false,
"hidden": false,
"fieldType": "multi_line_text"
}
]
}
],
"configuration": {
"language": "en",
"cloneable": true,
"postSubmitAction": {
"type": "thank_you",
"value": "Thanks for submitting the form."
},
"editable": true,
"archivable": true,
"recaptchaEnabled": false,
"notifyContactOwner": false,
"notifyRecipients": [
"2886602"
],
"createNewContactForNewEmail": false,
"prePopulateKnownValues": true,
"allowLinkToResetKnownValues": false,
"lifecycleStages": [
{
"objectTypeId": "0-1",
"value": "subscriber"
},
{
"objectTypeId": "0-2",
"value": "subscriber"
}
]
},
"displayOptions": {
"renderRawHtml": false,
"theme": "default_style",
"submitButtonText": "Submit",
"style": {
"fontFamily": "arial, helvetica, sans-serif",
"backgroundWidth": "100%",
"labelTextColor": "#33475b",
"labelTextSize": "13px",
"helpTextColor": "#7C98B6",
"helpTextSize": "11px",
"legalConsentTextColor": "#33475b",
"legalConsentTextSize": "14px",
"submitColor": "#ff7a59",
"submitAlignment": "left",
"submitFontColor": "#ffffff",
"submitSize": "12px"
},
"cssClass": "hs-form stacked"
},
"legalConsentOptions": {
"type": "none"
},
"formType": "hubspot"
},
{
"id": "c7cd13be-3024-4bc8-8582-4a87678b5acc",
"name": "Pop-up form: Sign up now popup",
"formType": "flow",
"createdAt": "2020-09-22T05:19:42.276Z",
"updatedAt": "2020-09-22T05:20:29.356Z",
"archived": false
},
{
"id": "ad4497f3-b80a-4369-a7d0-cade0e4c202d",
"name": "Collected form: .visitorRegistration",
"formType": "captured",
"createdAt": "2020-09-22T05:18:40.533Z",
"updatedAt": "2020-09-22T05:18:40.533Z",
"archived": false
}
],
"paging": {
"next": {
"after": "Mw%3D%3D",
"link": "https://api.hubspot.com/marketing/v3/forms?portalId=103268800&limit=3&formTypes=ALL&hs_static_app=api-goggles&hs_static_app_version=1.4854&after=Mw%3D%3D"
}
}
}Returns a list of forms based on the search filters. By default, it returns the first 20 hubspot forms
curl --request GET \
--url https://api.hubapi.com/marketing/v3/forms/ \
--header 'Authorization: Bearer <token>'{
"results": [
{
"id": "b6336282-50ec-465e-894e-e368146fa25f",
"name": "Contact us",
"createdAt": "2020-09-22T05:15:12.311Z",
"updatedAt": "2020-09-22T05:15:35.361Z",
"archived": false,
"fieldGroups": [
{
"groupType": "default_group",
"richTextType": "text",
"fields": [
{
"objectTypeId": "0-1",
"name": "email",
"label": "Email",
"required": true,
"hidden": false,
"fieldType": "email",
"validation": {
"blockedEmailDomains": [],
"useDefaultBlockList": false
}
}
]
},
{
"groupType": "default",
"richTextType": "text",
"fields": [
{
"objectTypeId": "0-1",
"name": "firstname",
"label": "First name",
"required": false,
"hidden": false,
"fieldType": "single_line_text"
}
]
},
{
"groupType": "default",
"richTextType": "text",
"fields": [
{
"objectTypeId": "0-1",
"name": "lastname",
"label": "Last name",
"required": false,
"hidden": false,
"fieldType": "single_line_text"
}
]
},
{
"groupType": "default",
"richTextType": "text",
"fields": [
{
"objectTypeId": "0-1",
"name": "message",
"label": "Message",
"required": false,
"hidden": false,
"fieldType": "multi_line_text"
}
]
}
],
"configuration": {
"language": "en",
"cloneable": true,
"postSubmitAction": {
"type": "thank_you",
"value": "Thanks for submitting the form."
},
"editable": true,
"archivable": true,
"recaptchaEnabled": false,
"notifyContactOwner": false,
"notifyRecipients": [
"2886602"
],
"createNewContactForNewEmail": false,
"prePopulateKnownValues": true,
"allowLinkToResetKnownValues": false,
"lifecycleStages": [
{
"objectTypeId": "0-1",
"value": "subscriber"
},
{
"objectTypeId": "0-2",
"value": "subscriber"
}
]
},
"displayOptions": {
"renderRawHtml": false,
"theme": "default_style",
"submitButtonText": "Submit",
"style": {
"fontFamily": "arial, helvetica, sans-serif",
"backgroundWidth": "100%",
"labelTextColor": "#33475b",
"labelTextSize": "13px",
"helpTextColor": "#7C98B6",
"helpTextSize": "11px",
"legalConsentTextColor": "#33475b",
"legalConsentTextSize": "14px",
"submitColor": "#ff7a59",
"submitAlignment": "left",
"submitFontColor": "#ffffff",
"submitSize": "12px"
},
"cssClass": "hs-form stacked"
},
"legalConsentOptions": {
"type": "none"
},
"formType": "hubspot"
},
{
"id": "c7cd13be-3024-4bc8-8582-4a87678b5acc",
"name": "Pop-up form: Sign up now popup",
"formType": "flow",
"createdAt": "2020-09-22T05:19:42.276Z",
"updatedAt": "2020-09-22T05:20:29.356Z",
"archived": false
},
{
"id": "ad4497f3-b80a-4369-a7d0-cade0e4c202d",
"name": "Collected form: .visitorRegistration",
"formType": "captured",
"createdAt": "2020-09-22T05:18:40.533Z",
"updatedAt": "2020-09-22T05:18:40.533Z",
"archived": false
}
],
"paging": {
"next": {
"after": "Mw%3D%3D",
"link": "https://api.hubspot.com/marketing/v3/forms?portalId=103268800&limit=3&formTypes=ALL&hs_static_app=api-goggles&hs_static_app_version=1.4854&after=Mw%3D%3D"
}
}
}Supported products
Required Scopes
The access token received from the authorization server in the OAuth 2.0 flow.
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.
Whether to return only results that have been archived.
The form types to be included in the results.
hubspot, captured, flow, blog_comment, all The maximum number of results to display per page.
Was this page helpful?