---
title: "Connect Google Profile to Account"
method: POST
path: "/connected-accounts/connect-google"
tags: ["Connected Accounts"]
---

# Connect Google Profile to Account

`POST /connected-accounts/connect-google`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/connected-accounts/connect-google`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/connected-accounts/connect-google/post.ts> (a function with typed inputs; its response is checked against the schema)

This API initiates the process of connecting a new Google My Business (GMB) account to the system. The response provides a URL for the user to complete Google's OAuth authentication flow.

**Important Notes:**
- The response includes a URL that the user must visit to authenticate and connect their GMB account.
- The provided URL is valid for 24 hours.
- When the user accesses the URL, they are redirected to Google’s OAuth authentication flow.
- During OAuth, the user must:
    - Review and accept Google’s terms and conditions.
    - Grant necessary permissions for integration.
- After OAuth authentication:
    - If successful, the user is redirected to the successUrl provided in the request.
    - If permissions are declined or the process fails, the user is redirected to the errorUrl.

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- object
  - `input` object
    - `errorUrl` string, required: Redirect URL in case of Error
    - `successUrl` string, required: Redirect URL in case of Success

## Response `200`

Successfully generated connection URL

- object
  - `data` object
    - `bulkConnectLinkForGoogle` object
      - `errors` string[], nullable: Array of error messages if any
      - `success` boolean: True if the request was successful, otherwise False
      - `url` string: The URL which needs to be visited to initiate the connect process

## Other responses

- `400`: Bad request - invalid input

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)