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"
}
}
}
Gibt eine Liste von Formularen zurück, die auf den Suchfiltern basieren. Standardmäßig werden die ersten 20 „hubspot“-Formulare zurückgegeben.
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"
}
}
}
forms
The access token received from the authorization server in the OAuth 2.0 flow.
Das Paginierungscursor-Token der zuletzt erfolgreich gelesenen Ressource wird als „paging.next.after“-JSON-Eigenschaft einer paginierten Antwort mit weiteren Ergebnissen zurückgegeben.
Die maximale Anzahl der Ergebnisse, die pro Seite angezeigt werden.
Ob nur Ergebnisse zurückgegeben werden sollen, die archiviert wurden.
Die Formularfelder, die in den Ergebnissen enthalten sein sollen.
Show child attributes
successful operation
The response is of type object
.