Connect Google Profile to Account

POST

https://api.synup.com/api/v4/connected-accounts/connect-google

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.

Request

Header Params

Body Params application/json

Example

{
    "input": {
        "errorUrl": "http://www.errorurl.com",
        "successUrl": "http://www.successurl.com"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.synup.com/api/v4/connected-accounts/connect-google' \
--header 'Authorization: API T9V35W3xxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "input": {
        "errorUrl": "http://www.errorurl.com",
        "successUrl": "http://www.successurl.com"
    }
}'

Responses

🟢200OK

application/json

Successfully generated connection URL

Body

Example

{
    "data": {
        "bulkConnectLinkForGoogle": {
            "clientMutationId": null,
            "errors": null,
            "success": true,
            "url": "https://claim.verifymybiz.com/locations/redirect_oauth_bulk/google_oauth2?onboarding=false&platform=local&token=47cc832a-31ce-4de5-8768-c541a8331800"
        }
    }
}

🟠400Bad Request

Modified at 2025-07-16 11:19:52

Connected Accounts

Connect Facebook Page to Account