← Back to API Reference overview

Google Forms Integrations

Connect your Google account to automatically sync form responses from links that redirect to Google Forms.

Shortcut: ⌘K

#The A Google Form auto-detected from a workspace link's redirect destination object

A Google Form auto-detected from a workspace link's redirect destination

accessible

boolean

Whether the form is accessible with the connected Google account

formId

string

The extracted Google Form ID (if resolvable)

formUrl

string

The Google Form URL (destination)

linkId

string

The link ID that redirects to this form

linkName

string

The link name

GET/v1/google-forms-integrationsRequires auth

#Get Google Forms integration

Retrieve the Google Forms integration for the workspace.

#Parameters

This endpoint does not accept any parameters.

#Response

200

Everything worked as expected.

integration

object

GoogleFormsIntegration represents a connected Google account. Forms are auto-detected from workflow steps — no manual configuration needed.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

GET/v1/google-forms-integrations/detected-formsRequires auth

#List detected Google Forms

Returns Google Forms auto-detected from workspace links that have a Google Form as their redirect destination.

#Parameters

This endpoint does not accept any parameters.

#Response

200

Everything worked as expected.

forms

array<object>

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

GET/v1/google-forms-integrations/oauth-urlRequires auth

#Get Google OAuth URL

Returns the Google OAuth authorization URL to initiate the connection flow.

#Parameters

This endpoint does not accept any parameters.

#Response

200

Everything worked as expected.

oauthUrl

string

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

POST/v1/google-forms-integrations/oauth/completeRequires auth

#Complete Google OAuth

Exchanges the Google authorization code for tokens and creates the workspace integration.

#Parameters

This endpoint does not accept any parameters.

#Request body

code

stringRequired

state

stringRequired

#Response

200

Everything worked as expected.

integration

object

GoogleFormsIntegration represents a connected Google account. Forms are auto-detected from workflow steps — no manual configuration needed.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

POST/v1/google-forms-integrations/syncRequires auth

#Sync now

Trigger an immediate sync of new Google Forms responses from all detected forms.

#Parameters

This endpoint does not accept any parameters.

#Request body

No structured schema available for this section.

#Response

200

Everything worked as expected.

responsesSynced

string (int64)

visitorsEnriched

string (int64)

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

PATCH/v1/google-forms-integrationsRequires auth

#Update Google Forms integration

Update the integration status (pause or resume syncing).

#Parameters

This endpoint does not accept any parameters.

#Request body

status

string (enum)
Allowed values
GOOGLE_FORMS_INTEGRATION_STATUS_UNSPECIFIED
GOOGLE_FORMS_INTEGRATION_STATUS_ACTIVE
GOOGLE_FORMS_INTEGRATION_STATUS_PAUSED
GOOGLE_FORMS_INTEGRATION_STATUS_DISCONNECTED

#Response

200

Everything worked as expected.

integration

object

GoogleFormsIntegration represents a connected Google account. Forms are auto-detected from workflow steps — no manual configuration needed.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

DELETE/v1/google-forms-integrationsRequires auth

#Disconnect Google Forms integration

Disconnect and remove the Google Forms integration from the workspace.

#Parameters

This endpoint does not accept any parameters.

#Response

200

Everything worked as expected.

No structured schema available for this section.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.