---
title: "Integrations: Google Forms API Reference | Linkbreakers"
description: "Connect a Google account so responses to Google Forms your links lead to are attached to the visitors who sent them."
canonical: "https://linkbreakers.com/help/api/integrations-google-forms"
---

# Integrations: Google Forms

Connect a Google account so responses to Google Forms your links lead to are attached to the visitors who sent them.

7 entries on this page

## The google forms integration object

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

`createdAt` string (date-time) 

Read-only

`createdBy` string

`delivery` object

Where: the links whose forms are synced. What: which answers come in, ALL or SELECTED. Moments do not apply, since responses arrive on a schedule.

8 child attributes

`directoryIds` array of string

Where: directories it applies to, with every directory below them.

`linkIds` array of string

Where: links it applies to. All three lists empty means every link.

`moments` array of enum

When: the moments of a visit it sends at. Ignored when stepIds is set.

`stepIds` array of string

When: send only when a visit reaches one of these workflow steps.

`tagIds` array of string

Where: tags it applies to.

`targetsGone` boolean 

Read-only

Every link, directory and tag chosen has since been deleted, so this covers nothing. The lists above are then empty without meaning every link.

`visitorAttributeKeys` array of string

What: with SELECTED, the attribute keys sent, such as "$email" or "rating".

`visitorData` enum

How much of what is known about the visitor an integration sends.

Allowed values

* `INTEGRATION_VISITOR_DATA_NONE` Only the visit: the link, the step, the device and the place.
* `INTEGRATION_VISITOR_DATA_ALL` The visit, and every attribute known about the visitor.
* `INTEGRATION_VISITOR_DATA_SELECTED` The visit, and only the attributes named in visitorAttributeKeys.

`googleEmail` string

`id` string

`lastSyncedAt` string (date-time) 

Read-only

`responsesSynced` integer (int64) 

Read-only

`status` enum

Allowed values

* `GOOGLE_FORMS_INTEGRATION_STATUS_ACTIVE`
* `GOOGLE_FORMS_INTEGRATION_STATUS_PAUSED`
* `GOOGLE_FORMS_INTEGRATION_STATUS_DISCONNECTED`

`updatedAt` string (date-time) 

Read-only

`visitorsEnriched` integer (int64) 

Read-only

`workspaceId` string

Example google forms integration

```json
{
  "createdAt": "2026-01-15T09:30:00Z",
  "createdBy": "string",
  "delivery": {
    "directoryIds": [
      "string"
    ],
    "linkIds": [
      "string"
    ],
    "moments": [
      "KIND_ENTRY"
    ],
    "stepIds": [
      "string"
    ],
    "tagIds": [
      "string"
    ],
    "targetsGone": false,
    "visitorAttributeKeys": [
      "string"
    ],
    "visitorData": "INTEGRATION_VISITOR_DATA_NONE"
  },
  "googleEmail": "jane@example.com",
  "id": "d22f7bf1-83a9-4f3a-9b37-9a3a21b6ac11",
  "lastSyncedAt": "2026-01-15T09:30:00Z",
  "responsesSynced": 0,
  "status": "GOOGLE_FORMS_INTEGRATION_STATUS_ACTIVE",
  "updatedAt": "2026-01-15T09:30:00Z",
  "visitorsEnriched": 0,
  "workspaceId": "3f6c2a5e-8b1d-4c7e-9a2f-5d8e1b0c4a7f"
}
```

### Response

200

`integration` object

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

Fields: [The google forms integration object](#integrations-google-forms-object).

Errors answer 4xx or 5xx with the [error object](https://linkbreakers.com/help/api#errors), and `429` past the [rate limit](https://linkbreakers.com/help/api#rate-limits).

Request

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

Response 200

```json
{
  "integration": {
    "createdAt": "2026-01-15T09:30:00Z",
    "createdBy": "string",
    "delivery": {
      "directoryIds": [
        "string"
      ],
      "linkIds": [
        "string"
      ],
      "moments": [
        "KIND_ENTRY"
      ],
      "stepIds": [
        "string"
      ],
      "tagIds": [
        "string"
      ],
      "targetsGone": false,
      "visitorAttributeKeys": [
        "string"
      ],
      "visitorData": "INTEGRATION_VISITOR_DATA_NONE"
    },
    "googleEmail": "jane@example.com",
    "id": "d22f7bf1-83a9-4f3a-9b37-9a3a21b6ac11",
    "lastSyncedAt": "2026-01-15T09:30:00Z",
    "responsesSynced": 0,
    "status": "GOOGLE_FORMS_INTEGRATION_STATUS_ACTIVE",
    "updatedAt": "2026-01-15T09:30:00Z",
    "visitorsEnriched": 0,
    "workspaceId": "3f6c2a5e-8b1d-4c7e-9a2f-5d8e1b0c4a7f"
  }
}
```

### Response

200

`forms` array of object

7 child attributes

`accessible` boolean

Whether the form is accessible with the connected Google account

`chosen` boolean

This is the link chosen for the form.

`conflict` boolean

The same form is behind several links: its responses are not matched until the customer chooses which link they belong to (ChooseFormLink).

`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

Errors answer 4xx or 5xx with the [error object](https://linkbreakers.com/help/api#errors), and `429` past the [rate limit](https://linkbreakers.com/help/api#rate-limits).

Request

```bash
curl -X GET "https://api.linkbreakers.com/v1/google-forms-integrations/detected-forms" \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN"
```

Response 200

```json
{
  "forms": [
    {
      "accessible": false,
      "chosen": false,
      "conflict": false,
      "formId": "3f6c2a5e-8b1d-4c7e-9a2f-5d8e1b0c4a7f",
      "formUrl": "https://example.com",
      "linkId": "3f6c2a5e-8b1d-4c7e-9a2f-5d8e1b0c4a7f",
      "linkName": "string"
    }
  ]
}
```

### Parameters

`formId` string 

path

Required

The Google Form.

`Idempotency-Key` string 

header

A unique value per request, such as a UUID, that makes retrying it safe: a retry with the same key and body returns the first response instead of acting twice.

### Request body

`linkId` string

The link its responses belong to; it must open that form.

### Response

200

An empty JSON object.

Errors answer 4xx or 5xx with the [error object](https://linkbreakers.com/help/api#errors), and `429` past the [rate limit](https://linkbreakers.com/help/api#rate-limits).

Request

```bash
curl -X POST "https://api.linkbreakers.com/v1/google-forms-integrations/forms/{formId}/link" \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "linkId": "3f6c2a5e-8b1d-4c7e-9a2f-5d8e1b0c4a7f"
}'
```

### Parameters

`Idempotency-Key` string 

header

A unique value per request, such as a UUID, that makes retrying it safe: a retry with the same key and body returns the first response instead of acting twice.

### Request body

An empty JSON object.

### Response

200

`responsesSynced` integer (int64)

`visitorsEnriched` integer (int64)

Errors answer 4xx or 5xx with the [error object](https://linkbreakers.com/help/api#errors), and `429` past the [rate limit](https://linkbreakers.com/help/api#rate-limits).

Request

```bash
curl -X POST "https://api.linkbreakers.com/v1/google-forms-integrations/sync" \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN" \
  -H "Content-Type: application/json"
```

Response 200

```json
{
  "responsesSynced": 0,
  "visitorsEnriched": 0
}
```

### Parameters

`Idempotency-Key` string 

header

A unique value per request, such as a UUID, that makes retrying it safe: a retry with the same key and body returns the first response instead of acting twice.

### Request body

`delivery` object

Which links are synced and which answers come in. Leave it out to keep the current setting.

7 child attributes

`directoryIds` array of string

Where: directories it applies to, with every directory below them.

`linkIds` array of string

Where: links it applies to. All three lists empty means every link.

`moments` array of enum

When: the moments of a visit it sends at. Ignored when stepIds is set.

`stepIds` array of string

When: send only when a visit reaches one of these workflow steps.

`tagIds` array of string

Where: tags it applies to.

`visitorAttributeKeys` array of string

What: with SELECTED, the attribute keys sent, such as "$email" or "rating".

`visitorData` enum

How much of what is known about the visitor an integration sends.

Allowed values

* `INTEGRATION_VISITOR_DATA_NONE` Only the visit: the link, the step, the device and the place.
* `INTEGRATION_VISITOR_DATA_ALL` The visit, and every attribute known about the visitor.
* `INTEGRATION_VISITOR_DATA_SELECTED` The visit, and only the attributes named in visitorAttributeKeys.

`status` enum

Only status can be updated (ACTIVE or PAUSED)

Allowed values

* `GOOGLE_FORMS_INTEGRATION_STATUS_ACTIVE`
* `GOOGLE_FORMS_INTEGRATION_STATUS_PAUSED`
* `GOOGLE_FORMS_INTEGRATION_STATUS_DISCONNECTED`

### Response

200

`integration` object

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

Fields: [The google forms integration object](#integrations-google-forms-object).

Errors answer 4xx or 5xx with the [error object](https://linkbreakers.com/help/api#errors), and `429` past the [rate limit](https://linkbreakers.com/help/api#rate-limits).

Request

```bash
curl -X PATCH "https://api.linkbreakers.com/v1/google-forms-integrations" \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "delivery": {
    "directoryIds": [
      "string"
    ],
    "linkIds": [
      "string"
    ],
    "moments": [
      "KIND_ENTRY"
    ],
    "stepIds": [
      "string"
    ],
    "tagIds": [
      "string"
    ],
    "visitorAttributeKeys": [
      "string"
    ],
    "visitorData": "INTEGRATION_VISITOR_DATA_NONE"
  },
  "status": "GOOGLE_FORMS_INTEGRATION_STATUS_ACTIVE"
}'
```

Response 200

```json
{
  "integration": {
    "createdAt": "2026-01-15T09:30:00Z",
    "createdBy": "string",
    "delivery": {
      "directoryIds": [
        "string"
      ],
      "linkIds": [
        "string"
      ],
      "moments": [
        "KIND_ENTRY"
      ],
      "stepIds": [
        "string"
      ],
      "tagIds": [
        "string"
      ],
      "targetsGone": false,
      "visitorAttributeKeys": [
        "string"
      ],
      "visitorData": "INTEGRATION_VISITOR_DATA_NONE"
    },
    "googleEmail": "jane@example.com",
    "id": "d22f7bf1-83a9-4f3a-9b37-9a3a21b6ac11",
    "lastSyncedAt": "2026-01-15T09:30:00Z",
    "responsesSynced": 0,
    "status": "GOOGLE_FORMS_INTEGRATION_STATUS_ACTIVE",
    "updatedAt": "2026-01-15T09:30:00Z",
    "visitorsEnriched": 0,
    "workspaceId": "3f6c2a5e-8b1d-4c7e-9a2f-5d8e1b0c4a7f"
  }
}
```

### Response

200

An empty JSON object.

Errors answer 4xx or 5xx with the [error object](https://linkbreakers.com/help/api#errors), and `429` past the [rate limit](https://linkbreakers.com/help/api#rate-limits).

Request

```bash
curl -X DELETE "https://api.linkbreakers.com/v1/google-forms-integrations" \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN"
```

---

Source: https://linkbreakers.com/help/api/integrations-google-forms
