Sign in

v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
GMB Verifications

Start a verification

Starts a verification for the location. This is a mutating action: depending on method, Google mails a postcard, places a call, or sends an SMS/email to the business. Submit the resulting code with POST /gmb-verifications/{verificationId}/complete. Use POST /gmb-verifications/options first to discover which methods are eligible.

post/v1/accounts/{accountId}/gmb-verifications

Path parameters

accountIdstring required

The Zernio account ID (from /v1/accounts)

Query parameters

locationIdstring

Override which location to target. If omitted, uses the account's selected location.

Request body

method'ADDRESS' | 'EMAIL' | 'PHONE_CALL' | 'SMS' | 'AUTO' | 'VETTED_PARTNER' required

The verification method. Selects which method-specific field below is required.

languageCodestring
phoneNumberstring

For PHONE_CALL / SMS.

emailAddressstring

For EMAIL.

mailerContactobject

For ADDRESS (postcard) verification.

contextobject

ServiceBusinessContext (e.g. service address). Required for service-area businesses.

Example request

{
  "languageCode": "en-US"
}

Response

Verification started

successboolean
accountIdstring
locationIdstring