GET

Get Connect Url


Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Retrieves the Google authorization URL for the Wix user to open.

Surface the returned URL to the person connecting. After they authorize in their browser, Wix completes the OAuth exchange server-side. There is no code-exchange call to make. Poll Get Connection until the status is VALID.

Any Google account can be used and needs no prior Search Console setup. Site verification and property access are established afterwards through the GSC Site Readiness API.

Each call starts a new authorization attempt: the returned URL is single-use and expires after 2 hours, so request a fresh one for every attempt rather than caching or reusing one.

Any user with SEO permissions can start a connection, not only the site owner. The resulting connection is owned by the calling user; Get Connection reports whether the current caller is that owner.

An already-connected site may call this too. Authorizing again with the same Google account refreshes the stored credentials, and authorizing with a different one replaces the connection.

Requires the site to be published, have a connected domain, and allow search-engine indexing; otherwise fails with FAILED_PRECONDITION. These are a subset of what the SEO dashboard checks before it offers the flow. The dashboard also blocks on unpublished changes, on a site the caller lacks permission to publish or to connect a domain for, and on a non-indexable homepage.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage SEO Settings
Learn more about app permissions.
Endpoint
GET
https://www.wixapis.com/gsc/connection/v1/connect-url

Errors
403Permission Denied

There is 1 error with this status code.

428Failed Precondition

There are 5 errors with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

Did this help?