Google Forms Integrations

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

#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-integrations
Requires auth

#Get Google Forms integration

Retrieve the Google Forms integration for the workspace. Requires the `integrations:read` scope.

#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

object
Required

Wrapped error response.

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

#List detected Google Forms

Returns Google Forms auto-detected from workspace links that have a Google Form as their redirect destination. Requires the `integrations:read` scope.

#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

object
Required

Wrapped error response.

GET
/v1/google-forms-integrations/oauth-url
Requires auth

#Get Google OAuth URL

Returns the Google OAuth authorization URL to initiate the connection flow. Requires the `integrations:write` scope.

#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

object
Required

Wrapped error response.

POST
/v1/google-forms-integrations/oauth/complete
Requires auth

#Complete Google OAuth

Exchanges the Google authorization code for tokens and creates the workspace integration. Requires the `integrations:write` scope.

#Parameters

header parameters

Idempotency-Key

string
header

Makes retrying this request safe. See components.parameters.IdempotencyKey.

#Request body

code

string
Required

state

string
Required

#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

object
Required

Wrapped error response.

POST
/v1/google-forms-integrations/sync
Requires auth

#Sync now

Trigger an immediate sync of new Google Forms responses from all detected forms. Requires the `integrations:write` scope.

#Parameters

header parameters

Idempotency-Key

string
header

Makes retrying this request safe. See components.parameters.IdempotencyKey.

#Request body

No structured schema available for this section.

#Response

200

Everything worked as expected.

responsesSynced

integer (int64)

visitorsEnriched

integer (int64)

#Error response

400-599

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

error

object
Required

Wrapped error response.

PATCH
/v1/google-forms-integrations
Requires auth

#Update Google Forms integration

Update the integration status (pause or resume syncing). Requires the `integrations:write` scope.

#Parameters

header parameters

Idempotency-Key

string
header

Makes retrying this request safe. See components.parameters.IdempotencyKey.

#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

object
Required

Wrapped error response.

DELETE
/v1/google-forms-integrations
Requires auth

#Disconnect Google Forms integration

Disconnect and remove the Google Forms integration from the workspace. Requires the `integrations:write` scope.

#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

object
Required

Wrapped error response.