GMB Verifications

Start a verification

Changed on

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

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/accounts/{accountId}/gmb-verifications
  • Auth: HTTP bearer

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

Changes

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

  • d556591af3f6Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status