#The GoogleFormsFieldMapping maps a Google Forms question to a Linkbreakers visitor field object

GoogleFormsFieldMapping maps a Google Forms question to a Linkbreakers visitor field

linkbreakersField

string

The Linkbreakers field to map to (e.g. "$email", "$firstName", "$lastName", "$phone", or a custom attribute name)

questionId

string

The Google Forms question ID

questionTitle

string

The question title (for display purposes)

GET/v1/google-forms-integrationsRequires auth

#Get Google Forms integration

Retrieve the Google Forms integration configuration for the workspace.

#Parameters

This endpoint does not accept any parameters.

#Response

200

Everything worked as expected.

integration

object

Represents a connected Google Forms integration that syncs form responses to enrich visitor data in Linkbreakers.

#Error response

400-599

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

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/google-forms-integrations" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "integration": {
    "createdAt": "2026-06-21T13:20:38.520Z",
    "createdBy": "string",
    "fieldMappings": [
      {
        "linkbreakersField": "string",
        "questionId": "string",
        "questionTitle": "string"
      }
    ],
    "formId": "1FAIpQLSe...",
    "formTitle": "Contact Form",
    "googleEmail": "user@gmail.com",
    "id": "d22f7bf1-83a9-4f3a-9b37-9a3a21b6ac11",
    "lastSyncedAt": "2026-06-21T13:20:38.520Z",
    "responsesSynced": "string",
    "status": "GOOGLE_FORMS_INTEGRATION_STATUS_UNSPECIFIED",
    "trackingQuestionId": "string",
    "updatedAt": "2026-06-21T13:20:38.520Z",
    "visitorsEnriched": "string",
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}

Base URL: https://api.linkbreakers.com

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

#List Google Forms

List Google Forms available in the connected Google account.

#Parameters

This endpoint does not accept any parameters.

#Response

200

Everything worked as expected.

forms

array<object>

Available Google Forms from the user's Google Drive

#Error response

400-599

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

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/google-forms-integrations/forms" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "forms": [
    {
      "formId": "string",
      "title": "string"
    }
  ]
}

Base URL: https://api.linkbreakers.com

GET/v1/google-forms-integrations/forms/{formId}/fieldsRequires auth

#Get form fields

Returns the questions and fields of a specific Google Form for field mapping configuration.

#Parameters

path parameters

formId

stringRequiredpath

The Google Form ID to get fields for

#Response

200

Everything worked as expected.

fields

array<object>

The questions/fields in the form

#Error response

400-599

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

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/google-forms-integrations/forms/{formId}/fields" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "fields": [
    {
      "questionId": "string",
      "title": "string",
      "type": "string"
    }
  ]
}

Base URL: https://api.linkbreakers.com

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

The full Google OAuth authorization URL to redirect the user to

#Error response

400-599

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

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/google-forms-integrations/oauth-url" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "oauthUrl": "https://example.com"
}

Base URL: https://api.linkbreakers.com

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

The authorization code received from Google

state

stringRequired

The state parameter for CSRF validation

#Response

200

Everything worked as expected.

integration

object

Represents a connected Google Forms integration that syncs form responses to enrich visitor data in Linkbreakers.

#Error response

400-599

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

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/google-forms-integrations/oauth/complete" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"code":"string","state":"string"}'

Sample payload (application/json)

{
  "code": "string",
  "state": "string"
}

Typical response

{
  "integration": {
    "createdAt": "2026-06-21T13:20:38.522Z",
    "createdBy": "string",
    "fieldMappings": [
      {
        "linkbreakersField": "string",
        "questionId": "string",
        "questionTitle": "string"
      }
    ],
    "formId": "1FAIpQLSe...",
    "formTitle": "Contact Form",
    "googleEmail": "user@gmail.com",
    "id": "d22f7bf1-83a9-4f3a-9b37-9a3a21b6ac11",
    "lastSyncedAt": "2026-06-21T13:20:38.522Z",
    "responsesSynced": "string",
    "status": "GOOGLE_FORMS_INTEGRATION_STATUS_UNSPECIFIED",
    "trackingQuestionId": "string",
    "updatedAt": "2026-06-21T13:20:38.522Z",
    "visitorsEnriched": "string",
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}

Base URL: https://api.linkbreakers.com

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

#Sync now

Trigger an immediate sync of new Google Forms responses.

#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)

Number of new responses synced in this run

visitorsEnriched

string (int64)

Number of visitors enriched in this run

#Error response

400-599

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

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/google-forms-integrations/sync" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{}'

Sample payload (application/json)

{}

Typical response

{
  "responsesSynced": "string",
  "visitorsEnriched": "string"
}

Base URL: https://api.linkbreakers.com

PATCH/v1/google-forms-integrationsRequires auth

#Update Google Forms integration

Update the Google Forms integration configuration (form, field mappings, tracking, status).

#Parameters

This endpoint does not accept any parameters.

#Request body

fieldMappings

array<object>

Field mappings from form questions to Linkbreakers visitor fields

formId

string

The selected Google Form ID

formTitle

string

The selected Google Form title

status

string (enum)

The status of a Google Forms integration

Allowed values

GOOGLE_FORMS_INTEGRATION_STATUS_UNSPECIFIED

Status not specified

GOOGLE_FORMS_INTEGRATION_STATUS_ACTIVE

Integration is active and syncing responses

GOOGLE_FORMS_INTEGRATION_STATUS_PAUSED

Integration is paused by user action

GOOGLE_FORMS_INTEGRATION_STATUS_DISCONNECTED

Integration is disconnected

trackingQuestionId

string

The question ID used for lbid tracking correlation (empty to disable)

#Response

200

Everything worked as expected.

integration

object

Represents a connected Google Forms integration that syncs form responses to enrich visitor data in Linkbreakers.

#Error response

400-599

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

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X PATCH "https://api.linkbreakers.com/v1/google-forms-integrations" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"fieldMappings":[{"linkbreakersField":"string","questionId":"string","questionTitle":"string"}],"formId":"string","formTitle":"string","status":"GOOGLE_FORMS_INTEGRATION_STATUS_UNSPECIFIED","trackingQuestionId":"string"}'

Sample payload (application/json)

{
  "fieldMappings": [
    {
      "linkbreakersField": "string",
      "questionId": "string",
      "questionTitle": "string"
    }
  ],
  "formId": "string",
  "formTitle": "string",
  "status": "GOOGLE_FORMS_INTEGRATION_STATUS_UNSPECIFIED",
  "trackingQuestionId": "string"
}

Typical response

{
  "integration": {
    "createdAt": "2026-06-21T13:20:38.521Z",
    "createdBy": "string",
    "fieldMappings": [
      {
        "linkbreakersField": "string",
        "questionId": "string",
        "questionTitle": "string"
      }
    ],
    "formId": "1FAIpQLSe...",
    "formTitle": "Contact Form",
    "googleEmail": "user@gmail.com",
    "id": "d22f7bf1-83a9-4f3a-9b37-9a3a21b6ac11",
    "lastSyncedAt": "2026-06-21T13:20:38.521Z",
    "responsesSynced": "string",
    "status": "GOOGLE_FORMS_INTEGRATION_STATUS_UNSPECIFIED",
    "trackingQuestionId": "string",
    "updatedAt": "2026-06-21T13:20:38.521Z",
    "visitorsEnriched": "string",
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}

Base URL: https://api.linkbreakers.com

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.

Google Forms Integrations

#The GoogleFormsFieldMapping maps a Google Forms question to a Linkbreakers visitor field object

#Get Google Forms integration

#Parameters

#Response

#Error response

#List Google Forms

#Parameters

#Response

#Error response

#Get form fields

#Parameters

path parameters

#Response

#Error response

#Get Google OAuth URL

#Parameters

#Response

#Error response

#Complete Google OAuth

#Parameters

#Request body

#Response

#Error response

#Sync now

#Parameters

#Request body

#Response

#Error response

#Update Google Forms integration

#Parameters

#Request body

Allowed values

#Response

#Error response

#Disconnect Google Forms integration

#Parameters

#Response

#Error response