Skip to content
Docs

Focus · Google Business Profile

Typed Focus mode operations for Google Business Profile accounts, generated from the Google Business Profile focus module (same behaviour as the generic /accounts/{accountId}/focus routes).

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits89 endpointsMCP toolset focus_google_business

Locations

Google Business Profile: List Locations

GET/accounts/{accountId}/google-business/locations

List locations across accounts. Every location this Google login owns or manages (multi-location accounts and location groups). Select the default location, assign one to another profile, or transfer it. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations/list Generic route: /v1/accounts/{accountId}/focus/locations.

Access: readZernio: GET /v1/accounts/{accountId}/gmb-locationsGET /v1/connect/googlebusiness/locations

Try it with MCPAsk your agent to call google-business-locations-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

searchstring

Business-name substring

filterstring

Raw Google filter, e.g. storeCode="12" (takes precedence)

googleAccountIdstring
limitintegerdefault: 100

1–500

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 20 item attributes
idstringread-only
locationIdstringread-only
externalIdstringread-only
titlestring
accountIdstringread-only
accountNamestringread-only
accountTypestringread-only

PERSONALLOCATION_GROUPUSER_GROUPORGANIZATION

addressstringread-only
categorystringread-only
storeCodestring
phonestringread-only
websiteUristring (uri)read-only
openStatusstringread-only

OPENCLOSED_TEMPORARILYCLOSED_PERMANENTLY

isVerifiedbooleanread-only
hasPendingEditsbooleanread-only
hasGoogleUpdatedbooleanread-only
placeIdstringread-only
mapsUristring (uri)read-only
reviewUrlstring (uri)read-only
selectedbooleanread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/locations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/locations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Create a Locations item

POST/accounts/{accountId}/google-business/locations

Create a location (300/day; needs verification afterwards). Every location this Google login owns or manages (multi-location accounts and location groups). Select the default location, assign one to another profile, or transfer it. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations/list Generic route: /v1/accounts/{accountId}/focus/locations.

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/gmb-locations/assign

Try it with MCPAsk your agent to call google-business-locations-create (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

googleAccountIdstring
requestIdstring
validateOnlyboolean
locationobjectrequired
Show 12 child attributes
titlestring

Business name as on the storefront

≤ 100 characters

storeCodestring

≤ 64 characters

languageCodestring
categoriesobject
Show 2 child attributes
primaryCategoryobject
Show 1 child attributes
namestring

categories/gcid:…

additionalCategoriesarray of object

≤ 9 items

Show 1 item attributes
namestring

categories/gcid:…

phoneNumbersobject
Show 2 child attributes
primaryPhonestring
additionalPhonesarray of string

≤ 2 items

websiteUristring (uri)
storefrontAddressobject

Changing the address can trigger re-verification

Show 9 child attributes
regionCodestring

ISO 3166-1 alpha-2 country

≤ 2 characters

languageCodestring
postalCodestring
administrativeAreastring

State / province

localitystring

City / town

sublocalitystring
addressLinesarray of string

≤ 5 items

recipientsarray of string
organizationstring
latlngobject
Show 2 child attributes
latitudenumber
longitudenumber
openInfoobject
Show 2 child attributes
statusstring

OPENCLOSED_TEMPORARILYCLOSED_PERMANENTLY

openingDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

profileobject
Show 1 child attributes
descriptionstring

≤ 750 characters

labelsarray of string

≤ 10 items

adWordsLocationExtensionsobject
Show 1 child attributes
adPhonestring

Returns object

idstringread-only
locationIdstringread-only
externalIdstringread-only
titlestring
accountIdstringread-only
accountNamestringread-only
accountTypestringread-only

PERSONALLOCATION_GROUPUSER_GROUPORGANIZATION

addressstringread-only
categorystringread-only
storeCodestring
phonestringread-only
websiteUristring (uri)read-only
openStatusstringread-only

OPENCLOSED_TEMPORARILYCLOSED_PERMANENTLY

isVerifiedbooleanread-only
hasPendingEditsbooleanread-only
hasGoogleUpdatedbooleanread-only
placeIdstringread-only
mapsUristring (uri)read-only
reviewUrlstring (uri)read-only
selectedbooleanread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/locations
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/locations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "googleAccountId": "string",
    "requestId": "string",
    "validateOnly": true,
    "location": {
      "title": "string",
      "storeCode": "string"
    }
  }'
Response · 201

Google Business Profile: Get a Locations item

GET/accounts/{accountId}/google-business/locations/{itemId}

Location details. Every location this Google login owns or manages (multi-location accounts and location groups). Select the default location, assign one to another profile, or transfer it. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations/list Generic route: /v1/accounts/{accountId}/focus/locations.

Access: read

Try it with MCPAsk your agent to call google-business-locations-get (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
locationIdstringread-only
externalIdstringread-only
titlestring
accountIdstringread-only
accountNamestringread-only
accountTypestringread-only

PERSONALLOCATION_GROUPUSER_GROUPORGANIZATION

addressstringread-only
categorystringread-only
storeCodestring
phonestringread-only
websiteUristring (uri)read-only
openStatusstringread-only

OPENCLOSED_TEMPORARILYCLOSED_PERMANENTLY

isVerifiedbooleanread-only
hasPendingEditsbooleanread-only
hasGoogleUpdatedbooleanread-only
placeIdstringread-only
mapsUristring (uri)read-only
reviewUrlstring (uri)read-only
selectedbooleanread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/locations/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/locations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Delete a Locations item

DELETE/accounts/{accountId}/google-business/locations/{itemId}

Delete a location from Business Profile. Every location this Google login owns or manages (multi-location accounts and location groups). Select the default location, assign one to another profile, or transfer it. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations/list Generic route: /v1/accounts/{accountId}/focus/locations.

Access: write

Try it with MCPAsk your agent to call google-business-locations-delete (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/google-business/locations/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/locations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Make default location (Locations)

POST/accounts/{accountId}/google-business/locations/{itemId}/select

Switch this connection to another location (Zernio PUT gmb-locations). Returns the account patch to persist. Every location this Google login owns or manages (multi-location accounts and location groups). Select the default location, assign one to another profile, or transfer it. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations/list Generic route: /v1/accounts/{accountId}/focus/locations.

Access: writeIdempotency-KeyZernio: PUT /v1/accounts/{accountId}/gmb-locations

Try it with MCPAsk your agent to call google-business-locations-select (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

googleAccountIdstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/locations/{itemId}/select
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/locations/ITEM_ID/select" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "googleAccountId": "string"
  }'
Response · 200

Google Business Profile: Assign to another profile (Locations)

POST/accounts/{accountId}/google-business/locations/{itemId}/assign

Clone the grant into a new account on another Socialit profile (Zernio POST gmb-locations/assign). Every location this Google login owns or manages (multi-location accounts and location groups). Select the default location, assign one to another profile, or transfer it. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations/list Generic route: /v1/accounts/{accountId}/focus/locations.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call google-business-locations-assign (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

profileIdstringrequired
googleAccountIdstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/locations/{itemId}/assign
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/locations/ITEM_ID/assign" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "string",
    "googleAccountId": "string"
  }'
Response · 200

Google Business Profile: Transfer to another account (Locations)

POST/accounts/{accountId}/google-business/locations/{itemId}/transfer

Move the location to another Business Profile account you manage. Notify the client within 48 h. Every location this Google login owns or manages (multi-location accounts and location groups). Select the default location, assign one to another profile, or transfer it. Destructive. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations/list Generic route: /v1/accounts/{accountId}/focus/locations.

Access: write

Try it with MCPAsk your agent to call google-business-locations-transfer (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

destinationAccountstringrequired

accounts/{id}

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/locations/{itemId}/transfer
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/locations/ITEM_ID/transfer" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "destinationAccount": "string"
  }'
Response · 200

Business info

Google Business Profile: Get Business information

GET/accounts/{accountId}/google-business/business-info

Name, categories, phone, website, address, opening date/status, description, labels. Edits are moderated by Google; changing the name, address or primary category may trigger re-verification. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations Generic route: /v1/accounts/{accountId}/focus/business-info.

Access: readZernio: GET /v1/accounts/{accountId}/gmb-location-details

Try it with MCPAsk your agent to call google-business-business-info-get (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring

Another location this connection manages ("locations/{id}" or "accounts/{a}/locations/{l}")

Returns object

idstringread-only
namestringread-only
titlestring

Business name as on the storefront

≤ 100 characters

storeCodestring

≤ 64 characters

languageCodestring
categoriesobject
Show 2 child attributes
primaryCategoryobject
Show 2 child attributes
namestring

categories/gcid:…

displayNamestringread-only
additionalCategoriesarray of object

≤ 9 items

Show 2 item attributes
namestring

categories/gcid:…

displayNamestringread-only
phoneNumbersobject
Show 2 child attributes
primaryPhonestring
additionalPhonesarray of string

≤ 2 items

websiteUristring (uri)
storefrontAddressobject

Changing the address can trigger re-verification

Show 9 child attributes
regionCodestring

ISO 3166-1 alpha-2 country

≤ 2 characters

languageCodestring
postalCodestring
administrativeAreastring

State / province

localitystring

City / town

sublocalitystring
addressLinesarray of string

≤ 5 items

recipientsarray of string
organizationstring
latlngobject
Show 2 child attributes
latitudenumber
longitudenumber
openInfoobject
Show 3 child attributes
statusstring

OPENCLOSED_TEMPORARILYCLOSED_PERMANENTLY

canReopenbooleanread-only
openingDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

profileobject
Show 1 child attributes
descriptionstring

≤ 750 characters

labelsarray of string

≤ 10 items

adWordsLocationExtensionsobject
Show 1 child attributes
adPhonestring
metadataobjectread-only
Show 12 child attributes
placeIdstring
mapsUristring (uri)
newReviewUristring (uri)
hasVoiceOfMerchantboolean
hasPendingEditsboolean
hasGoogleUpdatedboolean
canHaveFoodMenusboolean
canOperateLodgingDataboolean
canOperateLocalPostboolean
canModifyServiceListboolean
canDeleteboolean
duplicateLocationstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/business-info
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/business-info" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Update Business information

PATCH/accounts/{accountId}/google-business/business-info

PATCH with updateMask (inferred from the fields sent). validateOnly checks without saving. Name, categories, phone, website, address, opening date/status, description, labels. Edits are moderated by Google; changing the name, address or primary category may trigger re-verification. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations Generic route: /v1/accounts/{accountId}/focus/business-info.

Access: writeZernio: PUT /v1/accounts/{accountId}/gmb-location-details

Try it with MCPAsk your agent to call google-business-business-info-update (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

titlestring

Business name as on the storefront

≤ 100 characters

storeCodestring

≤ 64 characters

languageCodestring
categoriesobject
Show 2 child attributes
primaryCategoryobject
Show 1 child attributes
namestring

categories/gcid:…

additionalCategoriesarray of object

≤ 9 items

Show 1 item attributes
namestring

categories/gcid:…

phoneNumbersobject
Show 2 child attributes
primaryPhonestring
additionalPhonesarray of string

≤ 2 items

websiteUristring (uri)
storefrontAddressobject

Changing the address can trigger re-verification

Show 9 child attributes
regionCodestring

ISO 3166-1 alpha-2 country

≤ 2 characters

languageCodestring
postalCodestring
administrativeAreastring

State / province

localitystring

City / town

sublocalitystring
addressLinesarray of string

≤ 5 items

recipientsarray of string
organizationstring
latlngobject
Show 2 child attributes
latitudenumber
longitudenumber
openInfoobject
Show 2 child attributes
statusstring

OPENCLOSED_TEMPORARILYCLOSED_PERMANENTLY

openingDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

profileobject
Show 1 child attributes
descriptionstring

≤ 750 characters

labelsarray of string

≤ 10 items

adWordsLocationExtensionsobject
Show 1 child attributes
adPhonestring
updateMaskstring

Comma-separated, e.g. profile.description,websiteUri

validateOnlyboolean
locationIdstring

Returns object

idstringread-only
namestringread-only
titlestring

Business name as on the storefront

≤ 100 characters

storeCodestring

≤ 64 characters

languageCodestring
categoriesobject
Show 2 child attributes
primaryCategoryobject
Show 2 child attributes
namestring

categories/gcid:…

displayNamestringread-only
additionalCategoriesarray of object

≤ 9 items

Show 2 item attributes
namestring

categories/gcid:…

displayNamestringread-only
phoneNumbersobject
Show 2 child attributes
primaryPhonestring
additionalPhonesarray of string

≤ 2 items

websiteUristring (uri)
storefrontAddressobject

Changing the address can trigger re-verification

Show 9 child attributes
regionCodestring

ISO 3166-1 alpha-2 country

≤ 2 characters

languageCodestring
postalCodestring
administrativeAreastring

State / province

localitystring

City / town

sublocalitystring
addressLinesarray of string

≤ 5 items

recipientsarray of string
organizationstring
latlngobject
Show 2 child attributes
latitudenumber
longitudenumber
openInfoobject
Show 3 child attributes
statusstring

OPENCLOSED_TEMPORARILYCLOSED_PERMANENTLY

canReopenbooleanread-only
openingDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

profileobject
Show 1 child attributes
descriptionstring

≤ 750 characters

labelsarray of string

≤ 10 items

adWordsLocationExtensionsobject
Show 1 child attributes
adPhonestring
metadataobjectread-only
Show 12 child attributes
placeIdstring
mapsUristring (uri)
newReviewUristring (uri)
hasVoiceOfMerchantboolean
hasPendingEditsboolean
hasGoogleUpdatedboolean
canHaveFoodMenusboolean
canOperateLodgingDataboolean
canOperateLocalPostboolean
canModifyServiceListboolean
canDeleteboolean
duplicateLocationstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/google-business/business-info
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/business-info" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "storeCode": "string",
    "languageCode": "string",
    "categories": {
      "primaryCategory": {
        "name": "string"
      },
      "additionalCategories": [
        {
          "name": "string"
        }
      ]
    },
    "phoneNumbers": {
      "primaryPhone": "string",
      "additionalPhones": [
        "string"
      ]
    }
  }'
Response · 200

Google Business Profile: Search categories (Business information)

POST/accounts/{accountId}/google-business/business-info/search-categories

Category lookup for the primary/additional category pickers. Name, categories, phone, website, address, opening date/status, description, labels. Edits are moderated by Google; changing the name, address or primary category may trigger re-verification. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations Generic route: /v1/accounts/{accountId}/focus/business-info.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call google-business-business-info-search-categories (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

searchstringrequired
regionCodestringdefault: "US"
languageCodestringdefault: "en"

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/business-info/search-categories
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/business-info/search-categories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "search": "string",
    "regionCode": "US",
    "languageCode": "en"
  }'
Response · 200

Hours

Google Business Profile: Get Hours

GET/accounts/{accountId}/google-business/hours

Regular hours, special (holiday) hours and more hours (delivery, drive-through, …) offered by the primary category. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations Generic route: /v1/accounts/{accountId}/focus/hours.

Access: readZernio: GET /v1/accounts/{accountId}/gmb-location-details

Try it with MCPAsk your agent to call google-business-hours-get (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring

Another location this connection manages ("locations/{id}" or "accounts/{a}/locations/{l}")

Returns object

idstringread-only
regularHoursobject

Regular opening hours

Show 1 child attributes
periodsarray of object
Show 4 item attributes
openDaystring

MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY

openTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

closeDaystring

MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY

closeTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

specialHoursobject

Holiday / exceptional hours

Show 1 child attributes
specialHourPeriodsarray of object
Show 5 item attributes
startDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

endDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

openTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

closeTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

closedboolean
moreHoursarray of object
Show 2 item attributes
hoursTypeIdstring

From the primary category moreHoursTypes, e.g. DELIVERY, DRIVE_THROUGH

periodsarray of object
Show 4 item attributes
openDaystring

MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY

openTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

closeDaystring

MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY

closeTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

availableMoreHoursTypesarray of objectread-only
Show 3 item attributes
hoursTypeIdstring
displayNamestring
localizedDisplayNamestring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/hours
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/hours" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Update Hours

PATCH/accounts/{accountId}/google-business/hours

Regular hours, special (holiday) hours and more hours (delivery, drive-through, …) offered by the primary category. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations Generic route: /v1/accounts/{accountId}/focus/hours.

Access: writeZernio: PUT /v1/accounts/{accountId}/gmb-location-details

Try it with MCPAsk your agent to call google-business-hours-update (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

regularHoursobject

Regular opening hours

Show 1 child attributes
periodsarray of object
Show 4 item attributes
openDaystring

MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY

openTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

closeDaystring

MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY

closeTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

specialHoursobject

Holiday / exceptional hours

Show 1 child attributes
specialHourPeriodsarray of object
Show 5 item attributes
startDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

endDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

openTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

closeTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

closedboolean
moreHoursarray of object
Show 2 item attributes
hoursTypeIdstring

From the primary category moreHoursTypes, e.g. DELIVERY, DRIVE_THROUGH

periodsarray of object
Show 4 item attributes
openDaystring

MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY

openTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

closeDaystring

MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY

closeTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

locationIdstring

Returns object

idstringread-only
regularHoursobject

Regular opening hours

Show 1 child attributes
periodsarray of object
Show 4 item attributes
openDaystring

MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY

openTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

closeDaystring

MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY

closeTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

specialHoursobject

Holiday / exceptional hours

Show 1 child attributes
specialHourPeriodsarray of object
Show 5 item attributes
startDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

endDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

openTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

closeTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

closedboolean
moreHoursarray of object
Show 2 item attributes
hoursTypeIdstring

From the primary category moreHoursTypes, e.g. DELIVERY, DRIVE_THROUGH

periodsarray of object
Show 4 item attributes
openDaystring

MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY

openTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

closeDaystring

MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY

closeTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

availableMoreHoursTypesarray of objectread-only
Show 3 item attributes
hoursTypeIdstring
displayNamestring
localizedDisplayNamestring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/google-business/hours
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/hours" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "regularHours": {
      "periods": [
        {
          "openDay": "MONDAY",
          "openTime": {
            "hours": 0,
            "minutes": 0
          }
        }
      ]
    },
    "specialHours": {
      "specialHourPeriods": [
        {
          "startDate": {
            "year": 1,
            "month": 1
          },
          "endDate": {
            "year": 1,
            "month": 1
          }
        }
      ]
    },
    "moreHours": [
      {
        "hoursTypeId": "string",
        "periods": [
          {
            "openDay": "MONDAY",
            "openTime": {
              "hours": null,
              "minutes": null
            }
          }
        ]
      }
    ],
    "locationId": "string"
  }'
Response · 200

Service area

Google Business Profile: Get Service area

GET/accounts/{accountId}/google-business/service-area

For service-area businesses: the regions/places you serve and whether customers can visit. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations Generic route: /v1/accounts/{accountId}/focus/service-area.

Access: read

Try it with MCPAsk your agent to call google-business-service-area-get (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring

Another location this connection manages ("locations/{id}" or "accounts/{a}/locations/{l}")

Returns object

idstringread-only
serviceAreaobject
Show 3 child attributes
businessTypestring

CUSTOMER_LOCATION_ONLYCUSTOMER_AND_BUSINESS_LOCATION

regionCodestring
placesobject
Show 1 child attributes
placeInfosarray of object

≤ 20 items

Show 2 item attributes
placeNamestring
placeIdstring
storefrontAddressobject

Changing the address can trigger re-verification

Show 9 child attributes
regionCodestring

ISO 3166-1 alpha-2 country

≤ 2 characters

languageCodestring
postalCodestring
administrativeAreastring

State / province

localitystring

City / town

sublocalitystring
addressLinesarray of string

≤ 5 items

recipientsarray of string
organizationstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/service-area
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/service-area" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Update Service area

PATCH/accounts/{accountId}/google-business/service-area

For service-area businesses: the regions/places you serve and whether customers can visit. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations Generic route: /v1/accounts/{accountId}/focus/service-area.

Access: write

Try it with MCPAsk your agent to call google-business-service-area-update (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

serviceAreaobjectrequired
Show 3 child attributes
businessTypestring

CUSTOMER_LOCATION_ONLYCUSTOMER_AND_BUSINESS_LOCATION

regionCodestring
placesobject
Show 1 child attributes
placeInfosarray of object

≤ 20 items

Show 2 item attributes
placeNamestring
placeIdstring
locationIdstring

Returns object

idstringread-only
serviceAreaobject
Show 3 child attributes
businessTypestring

CUSTOMER_LOCATION_ONLYCUSTOMER_AND_BUSINESS_LOCATION

regionCodestring
placesobject
Show 1 child attributes
placeInfosarray of object

≤ 20 items

Show 2 item attributes
placeNamestring
placeIdstring
storefrontAddressobject

Changing the address can trigger re-verification

Show 9 child attributes
regionCodestring

ISO 3166-1 alpha-2 country

≤ 2 characters

languageCodestring
postalCodestring
administrativeAreastring

State / province

localitystring

City / town

sublocalitystring
addressLinesarray of string

≤ 5 items

recipientsarray of string
organizationstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/google-business/service-area
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/service-area" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "serviceArea": {
      "businessType": "CUSTOMER_LOCATION_ONLY",
      "regionCode": "string"
    },
    "locationId": "string"
  }'
Response · 200

Attributes

Google Business Profile: List Attributes

GET/accounts/{accountId}/google-business/attributes

Amenities and highlights (Wi-Fi, outdoor seating, accessibility, payments, women-led, online appointments, menu/reservation URLs) available for the primary category. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations/updateAttributes Generic route: /v1/accounts/{accountId}/focus/attributes.

Access: readZernio: GET /v1/accounts/{accountId}/gmb-attributesGET /v1/accounts/{accountId}/gmb-attribute-metadata

Try it with MCPAsk your agent to call google-business-attributes-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring
includeUnsetbooleandefault: true

Also list attributes available but not set

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstringread-only
namestring

attributes/{attribute_id}

displayNamestringread-only
groupDisplayNamestringread-only
valueTypestringread-only

BOOLENUMURLREPEATED_ENUM

valuesarray of any
repeatedEnumValueobject
Show 2 child attributes
setValuesarray of string
unsetValuesarray of string
uriValuesarray of object
Show 1 item attributes
uristring (uri)
valueMetadataarray of objectread-only
Show 2 item attributes
valueany
displayNamestring
repeatablebooleanread-only
deprecatedbooleanread-only
setbooleanread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/attributes
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/attributes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Update a Attributes item

PATCH/accounts/{accountId}/google-business/attributes/{itemId}

Set one attribute. Amenities and highlights (Wi-Fi, outdoor seating, accessibility, payments, women-led, online appointments, menu/reservation URLs) available for the primary category. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations/updateAttributes Generic route: /v1/accounts/{accountId}/focus/attributes.

Access: writeZernio: PUT /v1/accounts/{accountId}/gmb-attributes

Try it with MCPAsk your agent to call google-business-attributes-update (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

valuesarray of any
repeatedEnumValueobject
Show 2 child attributes
setValuesarray of string
unsetValuesarray of string
uriValuesarray of string
locationIdstring

Returns object

idstringread-only
namestring

attributes/{attribute_id}

displayNamestringread-only
groupDisplayNamestringread-only
valueTypestringread-only

BOOLENUMURLREPEATED_ENUM

valuesarray of any
repeatedEnumValueobject
Show 2 child attributes
setValuesarray of string
unsetValuesarray of string
uriValuesarray of object
Show 1 item attributes
uristring (uri)
valueMetadataarray of objectread-only
Show 2 item attributes
valueany
displayNamestring
repeatablebooleanread-only
deprecatedbooleanread-only
setbooleanread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/google-business/attributes/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/attributes/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "values": [
      null
    ],
    "repeatedEnumValue": {
      "setValues": [
        "string"
      ],
      "unsetValues": [
        "string"
      ]
    },
    "uriValues": [
      "string"
    ],
    "locationId": "string"
  }'
Response · 200

Google Business Profile: Delete a Attributes item

DELETE/accounts/{accountId}/google-business/attributes/{itemId}

Clear one attribute (masked but absent → unset). Amenities and highlights (Wi-Fi, outdoor seating, accessibility, payments, women-led, online appointments, menu/reservation URLs) available for the primary category. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations/updateAttributes Generic route: /v1/accounts/{accountId}/focus/attributes.

Access: write

Try it with MCPAsk your agent to call google-business-attributes-delete (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/google-business/attributes/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/attributes/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Update attributes (Attributes)

POST/accounts/{accountId}/google-business/attributes/bulk-update

Zernio PUT gmb-attributes: attributes[] + attributeMask. Amenities and highlights (Wi-Fi, outdoor seating, accessibility, payments, women-led, online appointments, menu/reservation URLs) available for the primary category. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations/updateAttributes Generic route: /v1/accounts/{accountId}/focus/attributes.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call google-business-attributes-bulk-update (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

attributesarray of objectrequired
Show 4 item attributes
namestring
valuesarray of any
repeatedEnumValueobject
uriValuesarray of any
attributeMaskarray of string
locationIdstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/attributes/bulk-update
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/attributes/bulk-update" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "attributes": [
      {
        "name": "string",
        "values": [
          null
        ]
      }
    ],
    "attributeMask": [
      "string"
    ],
    "locationId": "string"
  }'
Response · 200

Google updates

Google Business Profile: Get Google updates

GET/accounts/{accountId}/google-business/google-updates

Edits suggested by Google or users that differ from your data (diffMask) and edits still pending review (pendingMask). Accept Google's value or keep yours. Never revert Google-updated values automatically: show the diff and let the user choose. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations/getGoogleUpdated Generic route: /v1/accounts/{accountId}/focus/google-updates.

Access: read

Try it with MCPAsk your agent to call google-business-google-updates-get (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring

Another location this connection manages ("locations/{id}" or "accounts/{a}/locations/{l}")

Returns object

idstringread-only
locationobject

Google-updated values

Show 12 child attributes
titlestring

Business name as on the storefront

≤ 100 characters

storeCodestring

≤ 64 characters

languageCodestring
categoriesobject
Show 2 child attributes
primaryCategoryobject
Show 2 child attributes
namestring

categories/gcid:…

displayNamestringread-only
additionalCategoriesarray of object

≤ 9 items

Show 2 item attributes
namestring

categories/gcid:…

displayNamestringread-only
phoneNumbersobject
Show 2 child attributes
primaryPhonestring
additionalPhonesarray of string

≤ 2 items

websiteUristring (uri)
storefrontAddressobject

Changing the address can trigger re-verification

Show 9 child attributes
regionCodestring

ISO 3166-1 alpha-2 country

≤ 2 characters

languageCodestring
postalCodestring
administrativeAreastring

State / province

localitystring

City / town

sublocalitystring
addressLinesarray of string

≤ 5 items

recipientsarray of string
organizationstring
latlngobject
Show 2 child attributes
latitudenumber
longitudenumber
openInfoobject
Show 3 child attributes
statusstring

OPENCLOSED_TEMPORARILYCLOSED_PERMANENTLY

canReopenbooleanread-only
openingDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

profileobject
Show 1 child attributes
descriptionstring

≤ 750 characters

labelsarray of string

≤ 10 items

adWordsLocationExtensionsobject
Show 1 child attributes
adPhonestring
diffMaskstring
pendingMaskstring
diffFieldsarray of string
pendingFieldsarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/google-updates
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/google-updates" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Accept Google's values (Google updates)

POST/accounts/{accountId}/google-business/google-updates/accept

User-initiated only; never automate. Edits suggested by Google or users that differ from your data (diffMask) and edits still pending review (pendingMask). Accept Google's value or keep yours. Never revert Google-updated values automatically: show the diff and let the user choose. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations/getGoogleUpdated Generic route: /v1/accounts/{accountId}/focus/google-updates.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call google-business-google-updates-accept (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

fieldsarray of string

Default: every field in diffMask

locationIdstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/google-updates/accept
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/google-updates/accept" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": [
      "string"
    ],
    "locationId": "string"
  }'
Response · 200

Google Business Profile: Keep my values (Google updates)

POST/accounts/{accountId}/google-business/google-updates/reject

Re-submit your values for these fields. User-initiated only; never automate. Edits suggested by Google or users that differ from your data (diffMask) and edits still pending review (pendingMask). Accept Google's value or keep yours. Never revert Google-updated values automatically: show the diff and let the user choose. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations/getGoogleUpdated Generic route: /v1/accounts/{accountId}/focus/google-updates.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call google-business-google-updates-reject (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

fieldsarray of string
locationIdstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/google-updates/reject
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/google-updates/reject" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": [
      "string"
    ],
    "locationId": "string"
  }'
Response · 200

Categories

Google Business Profile: List Categories

GET/accounts/{accountId}/google-business/categories

Search Google business categories (primary + up to 9 additional). FULL view adds service types and more-hours types. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/categories/list Generic route: /v1/accounts/{accountId}/focus/categories.

Access: read

Try it with MCPAsk your agent to call google-business-categories-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

searchstring
regionCodestringdefault: "US"
languageCodestringdefault: "en"
viewstring

BASICFULL

pageSizeinteger

≤ 100

pageTokenstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstringread-only
namestring
displayNamestring
serviceTypesarray of object
Show 2 item attributes
serviceTypeIdstring
displayNamestring
moreHoursTypesarray of object
Show 3 item attributes
hoursTypeIdstring
displayNamestring
localizedDisplayNamestring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/categories
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/categories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Get a Categories item

GET/accounts/{accountId}/google-business/categories/{itemId}

Search Google business categories (primary + up to 9 additional). FULL view adds service types and more-hours types. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/categories/list Generic route: /v1/accounts/{accountId}/focus/categories.

Access: read

Try it with MCPAsk your agent to call google-business-categories-get (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Query parameters

regionCodestring
languageCodestring

Returns object

idstringread-only
namestring
displayNamestring
serviceTypesarray of object
Show 2 item attributes
serviceTypeIdstring
displayNamestring
moreHoursTypesarray of object
Show 3 item attributes
hoursTypeIdstring
displayNamestring
localizedDisplayNamestring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/categories/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/categories/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Current categories (Categories)

POST/accounts/{accountId}/google-business/categories/current-categories

Current categories. Search Google business categories (primary + up to 9 additional). FULL view adds service types and more-hours types. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/categories/list Generic route: /v1/accounts/{accountId}/focus/categories.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call google-business-categories-current-categories (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

locationIdstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/categories/current-categories
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/categories/current-categories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "locationId": "string"
  }'
Response · 200

Attribute metadata

Google Business Profile: List Attribute catalog

GET/accounts/{accountId}/google-business/attribute-metadata

Attributes available for this location, or for a category and region. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/attributes/list Generic route: /v1/accounts/{accountId}/focus/attribute-metadata.

Access: readZernio: GET /v1/accounts/{accountId}/gmb-attribute-metadata

Try it with MCPAsk your agent to call google-business-attribute-metadata-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring
categoryNamestring
regionCodestring
languageCodestring
showAllboolean
pageSizeinteger
pageTokenstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 8 item attributes
idstringread-only
parentstring
displayNamestring
groupDisplayNamestring
valueTypestring

BOOLENUMURLREPEATED_ENUM

repeatableboolean
deprecatedboolean
valueMetadataarray of object
Show 2 item attributes
valueany
displayNamestring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/attribute-metadata
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/attribute-metadata" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Chains

Google Business Profile: List Chains

GET/accounts/{accountId}/google-business/chains

Look up a brand/chain to associate locations with (relationshipData.parentChain). Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/chains/search Generic route: /v1/accounts/{accountId}/focus/chains.

Access: read

Try it with MCPAsk your agent to call google-business-chains-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

chainNamestringrequired
pageSizeinteger

≤ 500

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstringread-only
namestring
chainNamesarray of object
Show 2 item attributes
displayNamestring
languageCodestring
websitesarray of object
Show 1 item attributes
uristring (uri)
locationCountinteger
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/chains
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/chains?chainName=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Get a Chains item

GET/accounts/{accountId}/google-business/chains/{itemId}

Look up a brand/chain to associate locations with (relationshipData.parentChain). Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/chains/search Generic route: /v1/accounts/{accountId}/focus/chains.

Access: read

Try it with MCPAsk your agent to call google-business-chains-get (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
namestring
chainNamesarray of object
Show 2 item attributes
displayNamestring
languageCodestring
websitesarray of object
Show 1 item attributes
uristring (uri)
locationCountinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/chains/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/chains/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google locations

Google Business Profile: List Find a Google listing

GET/accounts/{accountId}/google-business/google-locations

Search existing Google listings to claim or request access (300/day). googleLocations:search only for merchants you already have a relationship with. Lead generation leads to revocation. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/googleLocations/search Generic route: /v1/accounts/{accountId}/focus/google-locations.

Access: read

Try it with MCPAsk your agent to call google-business-google-locations-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

querystringrequired

Business name and address

pageSizeinteger

≤ 10

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
idstringread-only
namestring
locationobject
Show 12 child attributes
titlestring

Business name as on the storefront

≤ 100 characters

storeCodestring

≤ 64 characters

languageCodestring
categoriesobject
Show 2 child attributes
primaryCategoryobject
Show 2 child attributes
namestring

categories/gcid:…

displayNamestringread-only
additionalCategoriesarray of object

≤ 9 items

Show 2 item attributes
namestring

categories/gcid:…

displayNamestringread-only
phoneNumbersobject
Show 2 child attributes
primaryPhonestring
additionalPhonesarray of string

≤ 2 items

websiteUristring (uri)
storefrontAddressobject

Changing the address can trigger re-verification

Show 9 child attributes
regionCodestring

ISO 3166-1 alpha-2 country

≤ 2 characters

languageCodestring
postalCodestring
administrativeAreastring

State / province

localitystring

City / town

sublocalitystring
addressLinesarray of string

≤ 5 items

recipientsarray of string
organizationstring
latlngobject
Show 2 child attributes
latitudenumber
longitudenumber
openInfoobject
Show 3 child attributes
statusstring

OPENCLOSED_TEMPORARILYCLOSED_PERMANENTLY

canReopenbooleanread-only
openingDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

profileobject
Show 1 child attributes
descriptionstring

≤ 750 characters

labelsarray of string

≤ 10 items

adWordsLocationExtensionsobject
Show 1 child attributes
adPhonestring
requestAdminRightsUristring (uri)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/google-locations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/google-locations?query=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Posts

Google Business Profile: List Posts

GET/accounts/{accountId}/google-business/posts

Updates, events and offers shown on Search and Maps. CTA buttons: Book, Order, Shop, Learn more, Sign up, Call. One photo or video per post (public URL). Product and Alert posts cannot be created via the API; posts have no insights. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.localPosts Generic route: /v1/accounts/{accountId}/focus/posts.

Access: read

Try it with MCPAsk your agent to call google-business-posts-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring
pageSizeinteger

≤ 100

pageTokenstring
topicTypestring

STANDARDEVENTOFFERALERT

statestring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 15 item attributes
idstringread-only
namestringread-only
topicTypestring

STANDARDEVENTOFFER

summarystring

≤ 1500 characters

languageCodestring
statestringread-only

LIVEPROCESSINGSCHEDULEDRECURRINGREJECTED

searchUrlstring (uri)read-only
createTimestring (date-time)read-only
updateTimestring (date-time)read-only
scheduledTimestring (date-time)

Google-native scheduling

callToActionobject
Show 2 child attributes
actionTypestring

BOOKORDERSHOPLEARN_MORESIGN_UPCALL

urlstring (uri)
eventobject
Show 3 child attributes
titlestring
scheduleobject
Show 4 child attributes
startDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

startTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

endDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

endTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

recurrenceInfoobject
Show 4 child attributes
seriesEndTimestring (date-time)
dailyPatternobject
weeklyPatternobject
Show 1 child attributes
daysOfWeekarray of string
monthlyPatternobject
Show 2 child attributes
dayOfMonthinteger

1–31

dayOfWeekOccurrencestring

FIRSTSECONDTHIRDFOURTHLAST

offerobject
Show 3 child attributes
couponCodestring
redeemOnlineUrlstring (uri)
termsConditionsstring
mediaarray of object

≤ 1 items

Show 3 item attributes
mediaFormatstring

PHOTOVIDEO

sourceUrlstring (uri)
googleUrlstring (uri)read-only
alertTypestringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Create a Posts item

POST/accounts/{accountId}/google-business/posts

Publish now (or hand scheduling to Google via options.scheduledTime). Updates, events and offers shown on Search and Maps. CTA buttons: Book, Order, Shop, Learn more, Sign up, Call. One photo or video per post (public URL). Product and Alert posts cannot be created via the API; posts have no insights. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.localPosts Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-KeyZernio: POST /v1/postsPOST /v1/posts/{postId}/editPOST /v1/posts/{postId}/unpublish

Try it with MCPAsk your agent to call google-business-posts-create (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

Post text + options (topicType, callToAction, event, offer, scheduledTime, locationId)

summarystring

≤ 1500 characters

mediaUrlstring (uri)

Public photo/video URL (sourceUrl)

mediaTypestring

imagevideo

mediastring

Socialit media id (resolved to a public URL)

optionsobject
Show 8 child attributes
topicTypestringdefault: "STANDARD"

Post type. EVENT needs event; OFFER needs event (validity) and usually offer.

STANDARDEVENTOFFER

locationIdstring

Target another location the connection manages: "locations/{id}" or "accounts/{a}/locations/{l}". Default: the account's selected location. Repeat the platform entry with different locationIds to fan out.

googleAccountIdstring

"accounts/{id}" owning locationId, when it differs from the connection's account.

languageCodestring

BCP 47 language of the post (metadata only, no translation). Default: the location language or "en".

callToActionobject
Show 3 child attributes
typestring

Button type (Zernio name).

BOOKORDERSHOPLEARN_MORESIGN_UPCALL

actionTypestring

Button type (Google name; alias of type).

BOOKORDERSHOPLEARN_MORESIGN_UPCALL

urlstring (uri)

HTTPS destination. Required except for CALL (which dials the profile phone).

eventobject
Show 5 child attributes
titlestring

Heading shown in Search/Maps.

scheduleobject
Show 4 child attributes
startDateobject | stringrequired

{year, month, day} or "YYYY-MM-DD" (an ISO datetime is also accepted; its time part fills the matching *Time)

One of 2 shapes

Option 1 object

yearintegerrequired
monthintegerrequired

1–12

dayintegerrequired

1–31

Option 2 string

startTimeobject | string

{hours, minutes} (24 h) or "HH:MM"

One of 2 shapes

Option 1 object

hoursinteger

0–23

minutesinteger

0–59

Option 2 string

endDateobject | stringrequired

{year, month, day} or "YYYY-MM-DD" (an ISO datetime is also accepted; its time part fills the matching *Time)

One of 2 shapes

Option 1 object

yearintegerrequired
monthintegerrequired

1–12

dayintegerrequired

1–31

Option 2 string

endTimeobject | string

{hours, minutes} (24 h) or "HH:MM"

One of 2 shapes

Option 1 object

hoursinteger

0–23

minutesinteger

0–59

Option 2 string

startDateTimestring (date-time)

Shorthand for schedule.startDate + startTime.

endDateTimestring (date-time)

Shorthand for schedule.endDate + endTime.

recurrenceInfoobject

Recurring post (2026-04). Exactly one pattern.

Show 4 child attributes
seriesEndTimestring (date-time)
dailyPatternobject
weeklyPatternobject
Show 1 child attributes
daysOfWeekarray of string
monthlyPatternobject
Show 2 child attributes
dayOfMonthinteger

1–31

dayOfWeekOccurrencestring

FIRSTSECONDTHIRDFOURTHLAST

offerobject
Show 3 child attributes
couponCodestring
redeemOnlineUrlstring (uri)
termsConditionsstring
scheduledTimestring (date-time)

Google-native scheduling: the post stays SCHEDULED until this time. Socialit normally schedules itself; use this only to hand scheduling to Google.

Returns object

idstringread-only
namestringread-only
topicTypestring

STANDARDEVENTOFFER

summarystring

≤ 1500 characters

languageCodestring
statestringread-only

LIVEPROCESSINGSCHEDULEDRECURRINGREJECTED

searchUrlstring (uri)read-only
createTimestring (date-time)read-only
updateTimestring (date-time)read-only
scheduledTimestring (date-time)

Google-native scheduling

callToActionobject
Show 2 child attributes
actionTypestring

BOOKORDERSHOPLEARN_MORESIGN_UPCALL

urlstring (uri)
eventobject
Show 3 child attributes
titlestring
scheduleobject
Show 4 child attributes
startDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

startTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

endDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

endTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

recurrenceInfoobject
Show 4 child attributes
seriesEndTimestring (date-time)
dailyPatternobject
weeklyPatternobject
Show 1 child attributes
daysOfWeekarray of string
monthlyPatternobject
Show 2 child attributes
dayOfMonthinteger

1–31

dayOfWeekOccurrencestring

FIRSTSECONDTHIRDFOURTHLAST

offerobject
Show 3 child attributes
couponCodestring
redeemOnlineUrlstring (uri)
termsConditionsstring
mediaarray of object

≤ 1 items

Show 3 item attributes
mediaFormatstring

PHOTOVIDEO

sourceUrlstring (uri)
googleUrlstring (uri)read-only
alertTypestringread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/posts
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "summary": "string",
    "mediaUrl": "https://example.com",
    "mediaType": "image",
    "media": "string",
    "options": {
      "topicType": "STANDARD",
      "locationId": "string"
    }
  }'
Response · 201

Google Business Profile: Get a Posts item

GET/accounts/{accountId}/google-business/posts/{itemId}

Updates, events and offers shown on Search and Maps. CTA buttons: Book, Order, Shop, Learn more, Sign up, Call. One photo or video per post (public URL). Product and Alert posts cannot be created via the API; posts have no insights. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.localPosts Generic route: /v1/accounts/{accountId}/focus/posts.

Access: read

Try it with MCPAsk your agent to call google-business-posts-get (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
namestringread-only
topicTypestring

STANDARDEVENTOFFER

summarystring

≤ 1500 characters

languageCodestring
statestringread-only

LIVEPROCESSINGSCHEDULEDRECURRINGREJECTED

searchUrlstring (uri)read-only
createTimestring (date-time)read-only
updateTimestring (date-time)read-only
scheduledTimestring (date-time)

Google-native scheduling

callToActionobject
Show 2 child attributes
actionTypestring

BOOKORDERSHOPLEARN_MORESIGN_UPCALL

urlstring (uri)
eventobject
Show 3 child attributes
titlestring
scheduleobject
Show 4 child attributes
startDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

startTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

endDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

endTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

recurrenceInfoobject
Show 4 child attributes
seriesEndTimestring (date-time)
dailyPatternobject
weeklyPatternobject
Show 1 child attributes
daysOfWeekarray of string
monthlyPatternobject
Show 2 child attributes
dayOfMonthinteger

1–31

dayOfWeekOccurrencestring

FIRSTSECONDTHIRDFOURTHLAST

offerobject
Show 3 child attributes
couponCodestring
redeemOnlineUrlstring (uri)
termsConditionsstring
mediaarray of object

≤ 1 items

Show 3 item attributes
mediaFormatstring

PHOTOVIDEO

sourceUrlstring (uri)
googleUrlstring (uri)read-only
alertTypestringread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/posts/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Update a Posts item

PATCH/accounts/{accountId}/google-business/posts/{itemId}

Edit text, CTA, event, offer, media or scheduled time (topic type is immutable). Updates, events and offers shown on Search and Maps. CTA buttons: Book, Order, Shop, Learn more, Sign up, Call. One photo or video per post (public URL). Product and Alert posts cannot be created via the API; posts have no insights. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.localPosts Generic route: /v1/accounts/{accountId}/focus/posts.

Access: write

Try it with MCPAsk your agent to call google-business-posts-update (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

Post text + options (topicType, callToAction, event, offer, scheduledTime, locationId)

summarystring

≤ 1500 characters

mediaUrlstring (uri)

Public photo/video URL (sourceUrl)

mediaTypestring

imagevideo

mediastring

Socialit media id (resolved to a public URL)

optionsobject
Show 8 child attributes
topicTypestringdefault: "STANDARD"

Post type. EVENT needs event; OFFER needs event (validity) and usually offer.

STANDARDEVENTOFFER

locationIdstring

Target another location the connection manages: "locations/{id}" or "accounts/{a}/locations/{l}". Default: the account's selected location. Repeat the platform entry with different locationIds to fan out.

googleAccountIdstring

"accounts/{id}" owning locationId, when it differs from the connection's account.

languageCodestring

BCP 47 language of the post (metadata only, no translation). Default: the location language or "en".

callToActionobject
Show 3 child attributes
typestring

Button type (Zernio name).

BOOKORDERSHOPLEARN_MORESIGN_UPCALL

actionTypestring

Button type (Google name; alias of type).

BOOKORDERSHOPLEARN_MORESIGN_UPCALL

urlstring (uri)

HTTPS destination. Required except for CALL (which dials the profile phone).

eventobject
Show 5 child attributes
titlestring

Heading shown in Search/Maps.

scheduleobject
Show 4 child attributes
startDateobject | stringrequired

{year, month, day} or "YYYY-MM-DD" (an ISO datetime is also accepted; its time part fills the matching *Time)

One of 2 shapes

Option 1 object

yearintegerrequired
monthintegerrequired

1–12

dayintegerrequired

1–31

Option 2 string

startTimeobject | string

{hours, minutes} (24 h) or "HH:MM"

One of 2 shapes

Option 1 object

hoursinteger

0–23

minutesinteger

0–59

Option 2 string

endDateobject | stringrequired

{year, month, day} or "YYYY-MM-DD" (an ISO datetime is also accepted; its time part fills the matching *Time)

One of 2 shapes

Option 1 object

yearintegerrequired
monthintegerrequired

1–12

dayintegerrequired

1–31

Option 2 string

endTimeobject | string

{hours, minutes} (24 h) or "HH:MM"

One of 2 shapes

Option 1 object

hoursinteger

0–23

minutesinteger

0–59

Option 2 string

startDateTimestring (date-time)

Shorthand for schedule.startDate + startTime.

endDateTimestring (date-time)

Shorthand for schedule.endDate + endTime.

recurrenceInfoobject

Recurring post (2026-04). Exactly one pattern.

Show 4 child attributes
seriesEndTimestring (date-time)
dailyPatternobject
weeklyPatternobject
Show 1 child attributes
daysOfWeekarray of string
monthlyPatternobject
Show 2 child attributes
dayOfMonthinteger

1–31

dayOfWeekOccurrencestring

FIRSTSECONDTHIRDFOURTHLAST

offerobject
Show 3 child attributes
couponCodestring
redeemOnlineUrlstring (uri)
termsConditionsstring
scheduledTimestring (date-time)

Google-native scheduling: the post stays SCHEDULED until this time. Socialit normally schedules itself; use this only to hand scheduling to Google.

Returns object

idstringread-only
namestringread-only
topicTypestring

STANDARDEVENTOFFER

summarystring

≤ 1500 characters

languageCodestring
statestringread-only

LIVEPROCESSINGSCHEDULEDRECURRINGREJECTED

searchUrlstring (uri)read-only
createTimestring (date-time)read-only
updateTimestring (date-time)read-only
scheduledTimestring (date-time)

Google-native scheduling

callToActionobject
Show 2 child attributes
actionTypestring

BOOKORDERSHOPLEARN_MORESIGN_UPCALL

urlstring (uri)
eventobject
Show 3 child attributes
titlestring
scheduleobject
Show 4 child attributes
startDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

startTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

endDateobject

Calendar date

Show 3 child attributes
yearinteger

≥ 1

monthinteger

1–12

dayinteger

1–31

endTimeobject

24 h time (hours 24 = midnight end of day)

Show 2 child attributes
hoursinteger

0–24

minutesinteger

0–59

recurrenceInfoobject
Show 4 child attributes
seriesEndTimestring (date-time)
dailyPatternobject
weeklyPatternobject
Show 1 child attributes
daysOfWeekarray of string
monthlyPatternobject
Show 2 child attributes
dayOfMonthinteger

1–31

dayOfWeekOccurrencestring

FIRSTSECONDTHIRDFOURTHLAST

offerobject
Show 3 child attributes
couponCodestring
redeemOnlineUrlstring (uri)
termsConditionsstring
mediaarray of object

≤ 1 items

Show 3 item attributes
mediaFormatstring

PHOTOVIDEO

sourceUrlstring (uri)
googleUrlstring (uri)read-only
alertTypestringread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/google-business/posts/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "summary": "string",
    "mediaUrl": "https://example.com",
    "mediaType": "image",
    "media": "string",
    "options": {
      "topicType": "STANDARD",
      "locationId": "string"
    }
  }'
Response · 200

Google Business Profile: Delete a Posts item

DELETE/accounts/{accountId}/google-business/posts/{itemId}

Updates, events and offers shown on Search and Maps. CTA buttons: Book, Order, Shop, Learn more, Sign up, Call. One photo or video per post (public URL). Product and Alert posts cannot be created via the API; posts have no insights. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.localPosts Generic route: /v1/accounts/{accountId}/focus/posts.

Access: write

Try it with MCPAsk your agent to call google-business-posts-delete (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/google-business/posts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Media

Google Business Profile: List Photos & videos

GET/accounts/{accountId}/google-business/media

Profile media by category (cover, logo, exterior, interior, product, team, food & drink, menu, rooms, …). Photos: JPG/PNG 10 KB–5 MB, ≥ 250×250. Videos: ≤ 30 s, ≤ 75 MB, ≥ 720p. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.media Generic route: /v1/accounts/{accountId}/focus/media.

Access: readZernio: GET /v1/accounts/{accountId}/gmb-media

Try it with MCPAsk your agent to call google-business-media-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring
pageSizeinteger

≤ 2500

pageTokenstring
categorystring

COVERPROFILELOGOEXTERIORINTERIORPRODUCTAT_WORKFOOD_AND_DRINKMENUCOMMON_AREAROOMSTEAMSADDITIONALCATEGORY_UNSPECIFIED

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 11 item attributes
idstringread-only
namestringread-only
mediaFormatstring

PHOTOVIDEO

sourceUrlstring (uri)

Public URL Google fetches (immutable)

googleUrlstring (uri)read-only
thumbnailUrlstring (uri)read-only
descriptionstring

Create only; not allowed on COVER

createTimestring (date-time)read-only
locationAssociationobject
Show 2 child attributes
categorystring

COVERPROFILELOGOEXTERIORINTERIORPRODUCTAT_WORKFOOD_AND_DRINKMENUCOMMON_AREAROOMSTEAMSADDITIONALCATEGORY_UNSPECIFIED

priceListItemIdstring
dimensionsobjectread-only
Show 2 child attributes
widthPixelsinteger
heightPixelsinteger
attributionobjectread-only
Show 4 child attributes
profileNamestring
profilePhotoUrlstring (uri)
profileUrlstring (uri)
takedownUrlstring (uri)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/media
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Create a Photos & videos item

POST/accounts/{accountId}/google-business/media

Add a photo/video from a public URL (Zernio POST gmb-media). Profile media by category (cover, logo, exterior, interior, product, team, food & drink, menu, rooms, …). Photos: JPG/PNG 10 KB–5 MB, ≥ 250×250. Videos: ≤ 30 s, ≤ 75 MB, ≥ 720p. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.media Generic route: /v1/accounts/{accountId}/focus/media.

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/gmb-media

Try it with MCPAsk your agent to call google-business-media-create (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

sourceUrlstring (uri)required
mediaFormatstring

PHOTOVIDEO

categorystring

COVERPROFILELOGOEXTERIORINTERIORPRODUCTAT_WORKFOOD_AND_DRINKMENUCOMMON_AREAROOMSTEAMSADDITIONALCATEGORY_UNSPECIFIED

descriptionstring
locationIdstring

Returns object

idstringread-only
namestringread-only
mediaFormatstring

PHOTOVIDEO

sourceUrlstring (uri)

Public URL Google fetches (immutable)

googleUrlstring (uri)read-only
thumbnailUrlstring (uri)read-only
descriptionstring

Create only; not allowed on COVER

createTimestring (date-time)read-only
locationAssociationobject
Show 2 child attributes
categorystring

COVERPROFILELOGOEXTERIORINTERIORPRODUCTAT_WORKFOOD_AND_DRINKMENUCOMMON_AREAROOMSTEAMSADDITIONALCATEGORY_UNSPECIFIED

priceListItemIdstring
dimensionsobjectread-only
Show 2 child attributes
widthPixelsinteger
heightPixelsinteger
attributionobjectread-only
Show 4 child attributes
profileNamestring
profilePhotoUrlstring (uri)
profileUrlstring (uri)
takedownUrlstring (uri)

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/media
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceUrl": "https://example.com",
    "mediaFormat": "PHOTO",
    "category": "COVER",
    "description": "string",
    "locationId": "string"
  }'
Response · 201

Google Business Profile: Get a Photos & videos item

GET/accounts/{accountId}/google-business/media/{itemId}

Profile media by category (cover, logo, exterior, interior, product, team, food & drink, menu, rooms, …). Photos: JPG/PNG 10 KB–5 MB, ≥ 250×250. Videos: ≤ 30 s, ≤ 75 MB, ≥ 720p. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.media Generic route: /v1/accounts/{accountId}/focus/media.

Access: read

Try it with MCPAsk your agent to call google-business-media-get (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
namestringread-only
mediaFormatstring

PHOTOVIDEO

sourceUrlstring (uri)

Public URL Google fetches (immutable)

googleUrlstring (uri)read-only
thumbnailUrlstring (uri)read-only
descriptionstring

Create only; not allowed on COVER

createTimestring (date-time)read-only
locationAssociationobject
Show 2 child attributes
categorystring

COVERPROFILELOGOEXTERIORINTERIORPRODUCTAT_WORKFOOD_AND_DRINKMENUCOMMON_AREAROOMSTEAMSADDITIONALCATEGORY_UNSPECIFIED

priceListItemIdstring
dimensionsobjectread-only
Show 2 child attributes
widthPixelsinteger
heightPixelsinteger
attributionobjectread-only
Show 4 child attributes
profileNamestring
profilePhotoUrlstring (uri)
profileUrlstring (uri)
takedownUrlstring (uri)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/media/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/media/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Update a Photos & videos item

PATCH/accounts/{accountId}/google-business/media/{itemId}

Change category or description. Profile media by category (cover, logo, exterior, interior, product, team, food & drink, menu, rooms, …). Photos: JPG/PNG 10 KB–5 MB, ≥ 250×250. Videos: ≤ 30 s, ≤ 75 MB, ≥ 720p. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.media Generic route: /v1/accounts/{accountId}/focus/media.

Access: write

Try it with MCPAsk your agent to call google-business-media-update (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

categorystring

COVERPROFILELOGOEXTERIORINTERIORPRODUCTAT_WORKFOOD_AND_DRINKMENUCOMMON_AREAROOMSTEAMSADDITIONALCATEGORY_UNSPECIFIED

descriptionstring
priceListItemIdstring

Returns object

idstringread-only
namestringread-only
mediaFormatstring

PHOTOVIDEO

sourceUrlstring (uri)

Public URL Google fetches (immutable)

googleUrlstring (uri)read-only
thumbnailUrlstring (uri)read-only
descriptionstring

Create only; not allowed on COVER

createTimestring (date-time)read-only
locationAssociationobject
Show 2 child attributes
categorystring

COVERPROFILELOGOEXTERIORINTERIORPRODUCTAT_WORKFOOD_AND_DRINKMENUCOMMON_AREAROOMSTEAMSADDITIONALCATEGORY_UNSPECIFIED

priceListItemIdstring
dimensionsobjectread-only
Show 2 child attributes
widthPixelsinteger
heightPixelsinteger
attributionobjectread-only
Show 4 child attributes
profileNamestring
profilePhotoUrlstring (uri)
profileUrlstring (uri)
takedownUrlstring (uri)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/google-business/media/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/media/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "COVER",
    "description": "string",
    "priceListItemId": "string"
  }'
Response · 200

Google Business Profile: Delete a Photos & videos item

DELETE/accounts/{accountId}/google-business/media/{itemId}

Profile media by category (cover, logo, exterior, interior, product, team, food & drink, menu, rooms, …). Photos: JPG/PNG 10 KB–5 MB, ≥ 250×250. Videos: ≤ 30 s, ≤ 75 MB, ≥ 720p. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.media Generic route: /v1/accounts/{accountId}/focus/media.

Access: writeZernio: DELETE /v1/accounts/{accountId}/gmb-media

Try it with MCPAsk your agent to call google-business-media-delete (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/google-business/media/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/media/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Upload file (Photos & videos)

POST/accounts/{accountId}/google-business/media/upload-file

Upload bytes of a Socialit media item (3-step startUpload flow), for files without a public URL. Profile media by category (cover, logo, exterior, interior, product, team, food & drink, menu, rooms, …). Photos: JPG/PNG 10 KB–5 MB, ≥ 250×250. Videos: ≤ 30 s, ≤ 75 MB, ≥ 720p. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.media Generic route: /v1/accounts/{accountId}/focus/media.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call google-business-media-upload-file (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

mediastringrequired
categorystring

COVERPROFILELOGOEXTERIORINTERIORPRODUCTAT_WORKFOOD_AND_DRINKMENUCOMMON_AREAROOMSTEAMSADDITIONALCATEGORY_UNSPECIFIED

descriptionstring
locationIdstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/media/upload-file
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/media/upload-file" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media": "string",
    "category": "COVER",
    "description": "string",
    "locationId": "string"
  }'
Response · 200

Customer media

Google Business Profile: List Customer photos

GET/accounts/{accountId}/google-business/customer-media

Photos and videos added by Google Maps users (read-only; new ones arrive via the NEW_CUSTOMER_MEDIA notification). Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.media.customers Generic route: /v1/accounts/{accountId}/focus/customer-media.

Access: read

Try it with MCPAsk your agent to call google-business-customer-media-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring
pageSizeinteger
pageTokenstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 11 item attributes
idstringread-only
namestringread-only
mediaFormatstring

PHOTOVIDEO

sourceUrlstring (uri)

Public URL Google fetches (immutable)

googleUrlstring (uri)read-only
thumbnailUrlstring (uri)read-only
descriptionstring

Create only; not allowed on COVER

createTimestring (date-time)read-only
locationAssociationobject
Show 2 child attributes
categorystring

COVERPROFILELOGOEXTERIORINTERIORPRODUCTAT_WORKFOOD_AND_DRINKMENUCOMMON_AREAROOMSTEAMSADDITIONALCATEGORY_UNSPECIFIED

priceListItemIdstring
dimensionsobjectread-only
Show 2 child attributes
widthPixelsinteger
heightPixelsinteger
attributionobjectread-only
Show 4 child attributes
profileNamestring
profilePhotoUrlstring (uri)
profileUrlstring (uri)
takedownUrlstring (uri)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/customer-media
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/customer-media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Get a Customer photos item

GET/accounts/{accountId}/google-business/customer-media/{itemId}

Photos and videos added by Google Maps users (read-only; new ones arrive via the NEW_CUSTOMER_MEDIA notification). Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.media.customers Generic route: /v1/accounts/{accountId}/focus/customer-media.

Access: read

Try it with MCPAsk your agent to call google-business-customer-media-get (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
namestringread-only
mediaFormatstring

PHOTOVIDEO

sourceUrlstring (uri)

Public URL Google fetches (immutable)

googleUrlstring (uri)read-only
thumbnailUrlstring (uri)read-only
descriptionstring

Create only; not allowed on COVER

createTimestring (date-time)read-only
locationAssociationobject
Show 2 child attributes
categorystring

COVERPROFILELOGOEXTERIORINTERIORPRODUCTAT_WORKFOOD_AND_DRINKMENUCOMMON_AREAROOMSTEAMSADDITIONALCATEGORY_UNSPECIFIED

priceListItemIdstring
dimensionsobjectread-only
Show 2 child attributes
widthPixelsinteger
heightPixelsinteger
attributionobjectread-only
Show 4 child attributes
profileNamestring
profilePhotoUrlstring (uri)
profileUrlstring (uri)
takedownUrlstring (uri)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/customer-media/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/customer-media/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Reviews

Google Business Profile: List Reviews

GET/accounts/{accountId}/google-business/reviews

Customer reviews with filters (rating range, unreplied). One owner reply per review: replying again overwrites it. The location must be verified to reply. Reviews cannot be deleted via the API. Automated or AI review replies need the user's prior, specific and express opt-in, per location, with an audit log. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.reviews Generic route: /v1/accounts/{accountId}/focus/reviews.

Access: readZernio: GET /v1/accounts/{accountId}/gmb-reviewsGET /v1/inbox/reviews

Try it with MCPAsk your agent to call google-business-reviews-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring
minRatinginteger

1–5

maxRatinginteger

1–5

hasReplyboolean

false = unreplied only

sortBystring

daterating

sortOrderstring

ascdesc

limitintegerdefault: 50

1–200

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 21 item attributes
idstringread-only
namestringread-only
ratingintegerread-only

1–5

starRatingstringread-only

ONETWOTHREEFOURFIVE

textstringread-only
text_translatedstringread-only
text_originalstringread-only
authorstringread-only
author_avatar_urlstring (uri)read-only
author_is_anonymousbooleanread-only
created_atstring (date-time)read-only
updated_atstring (date-time)read-only
replystring

Owner reply (≤ 4096 bytes)

has_replybooleanread-only
reply_updated_atstring (date-time)read-only
reply_statestringread-only

PENDINGAPPROVEDREJECTED

reply_policy_violationobjectread-only
reply_urlstring (uri)read-only
has_photosbooleanread-only
photo_countintegerread-only
mediaarray of objectread-only
Show 3 item attributes
typestring

imagevideo

urlstring (uri)
thumbnail_urlstring (uri)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/reviews
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/reviews" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Get a Reviews item

GET/accounts/{accountId}/google-business/reviews/{itemId}

Customer reviews with filters (rating range, unreplied). One owner reply per review: replying again overwrites it. The location must be verified to reply. Reviews cannot be deleted via the API. Automated or AI review replies need the user's prior, specific and express opt-in, per location, with an audit log. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.reviews Generic route: /v1/accounts/{accountId}/focus/reviews.

Access: readZernio: GET /v1/accounts/{accountId}/gmb-reviews/{reviewId}

Try it with MCPAsk your agent to call google-business-reviews-get (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
namestringread-only
ratingintegerread-only

1–5

starRatingstringread-only

ONETWOTHREEFOURFIVE

textstringread-only
text_translatedstringread-only
text_originalstringread-only
authorstringread-only
author_avatar_urlstring (uri)read-only
author_is_anonymousbooleanread-only
created_atstring (date-time)read-only
updated_atstring (date-time)read-only
replystring

Owner reply (≤ 4096 bytes)

has_replybooleanread-only
reply_updated_atstring (date-time)read-only
reply_statestringread-only

PENDINGAPPROVEDREJECTED

reply_policy_violationobjectread-only
reply_urlstring (uri)read-only
has_photosbooleanread-only
photo_countintegerread-only
mediaarray of objectread-only
Show 3 item attributes
typestring

imagevideo

urlstring (uri)
thumbnail_urlstring (uri)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/reviews/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/reviews/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Reply (Reviews)

POST/accounts/{accountId}/google-business/reviews/{itemId}/reply

Create or overwrite the owner reply (≤ 4096 bytes). Automated replies require automated: true + userOptIn: true. Customer reviews with filters (rating range, unreplied). One owner reply per review: replying again overwrites it. The location must be verified to reply. Reviews cannot be deleted via the API. Automated or AI review replies need the user's prior, specific and express opt-in, per location, with an audit log. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.reviews Generic route: /v1/accounts/{accountId}/focus/reviews.

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/gmb-reviews/batchPOST /v1/accounts/{accountId}/gmb-reviews/{reviewId}/replyDELETE /v1/accounts/{accountId}/gmb-reviews/{reviewId}/replyPOST /v1/inbox/reviews/{reviewId}/replyDELETE /v1/inbox/reviews/{reviewId}/reply

Try it with MCPAsk your agent to call google-business-reviews-reply (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

commentstringrequired

≤ 4096 characters

automatedboolean

Set by automation / AI flows

userOptInboolean

The user opted in to automated replies for this location

locationIdstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/reviews/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/reviews/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "comment": "string",
    "automated": true,
    "userOptIn": true,
    "locationId": "string"
  }'
Response · 200

Google Business Profile: Delete reply (Reviews)

POST/accounts/{accountId}/google-business/reviews/{itemId}/delete-reply

Delete reply. Customer reviews with filters (rating range, unreplied). One owner reply per review: replying again overwrites it. The location must be verified to reply. Reviews cannot be deleted via the API. Automated or AI review replies need the user's prior, specific and express opt-in, per location, with an audit log. Destructive. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.reviews Generic route: /v1/accounts/{accountId}/focus/reviews.

Access: write

Try it with MCPAsk your agent to call google-business-reviews-delete-reply (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

locationIdstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/reviews/{itemId}/delete-reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/reviews/ITEM_ID/delete-reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "locationId": "string"
  }'
Response · 200

Google Business Profile: Reviews across locations (Reviews)

POST/accounts/{accountId}/google-business/reviews/batch

Up to 50 locations of one Google account (Zernio POST gmb-reviews/batch). Customer reviews with filters (rating range, unreplied). One owner reply per review: replying again overwrites it. The location must be verified to reply. Reviews cannot be deleted via the API. Automated or AI review replies need the user's prior, specific and express opt-in, per location, with an audit log. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.reviews Generic route: /v1/accounts/{accountId}/focus/reviews.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call google-business-reviews-batch (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

locationNamesarray of stringrequired

1–50 items

googleAccountIdstring
pageSizeinteger

≤ 50

pageTokenstring
orderBystring

updateTime descratingrating desc

ignoreRatingOnlyReviewsboolean

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/reviews/batch
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/reviews/batch" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "locationNames": [
      "string"
    ],
    "googleAccountId": "string",
    "pageSize": 1,
    "pageToken": "string",
    "orderBy": "updateTime desc"
  }'
Response · 200

Performance

Google Business Profile: List Performance

GET/accounts/{accountId}/google-business/performance

Daily impressions (Search/Maps × desktop/mobile), calls, website clicks, direction requests, bookings and menu clicks. Unique users per day; ~18 months of history; 2-3 day delay. BUSINESS_CONVERSATIONS and BUSINESS_FOOD_ORDERS are deprecated. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/performance/rest/v1/locations/fetchMultiDailyMetricsTimeSeries Generic route: /v1/accounts/{accountId}/focus/performance.

Access: readZernio: GET /v1/analytics/googlebusiness/performance

Try it with MCPAsk your agent to call google-business-performance-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring
fromDatestring (date)

Default: 30 days ago

toDatestring (date)

Default: today (data lags 2-3 days)

metricsarray of stringdefault: ["BUSINESS_IMPRESSIONS_DESKTOP_MAPS","BUSINESS_IMPRESSIONS_DESKTOP_SEARCH","BUSINESS_IMPRESSIONS_MOBILE_MAPS","BUSINESS_IMPRESSIONS_MOBILE_SEARCH","BUSINESS_DIRECTION_REQUESTS","CALL_CLICKS","WEBSITE_CLICKS","BUSINESS_BOOKINGS","BUSINESS_FOOD_MENU_CLICKS"]

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 15 item attributes
idstringread-only
datestring (date)
BUSINESS_IMPRESSIONS_DESKTOP_MAPSinteger
BUSINESS_IMPRESSIONS_DESKTOP_SEARCHinteger
BUSINESS_IMPRESSIONS_MOBILE_MAPSinteger
BUSINESS_IMPRESSIONS_MOBILE_SEARCHinteger
BUSINESS_DIRECTION_REQUESTSinteger
CALL_CLICKSinteger
WEBSITE_CLICKSinteger
BUSINESS_BOOKINGSinteger
BUSINESS_FOOD_MENU_CLICKSinteger
BUSINESS_CONVERSATIONSinteger
BUSINESS_FOOD_ORDERSinteger
impressionsinteger

Σ impressions (maps + search, desktop + mobile)

interactionsinteger

calls + website + directions + bookings + menu clicks

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/performance
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/performance" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Search keywords

Google Business Profile: List Search keywords

GET/accounts/{accountId}/google-business/search-keywords

Monthly search terms that showed this profile (unique users). Low-volume terms come back as thresholds ("< N"). Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/performance/rest/v1/locations.searchkeywords.impressions.monthly/list Generic route: /v1/accounts/{accountId}/focus/search-keywords.

Access: readZernio: GET /v1/analytics/googlebusiness/search-keywords

Try it with MCPAsk your agent to call google-business-search-keywords-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring
startMonthstring

YYYY-MM (default: 3 months ago)

endMonthstring

YYYY-MM (default: last month)

pageTokenstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
keywordstring
impressionsinteger
thresholdboolean

impressions is an upper bound

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/search-keywords
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/search-keywords" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Metric breakdown

Google Business Profile: List Metric breakdown

GET/accounts/{accountId}/google-business/metric-breakdown

One daily metric, optionally for a single weekday or hour of the day. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/performance/rest/v1/locations/getDailyMetricsTimeSeries Generic route: /v1/accounts/{accountId}/focus/metric-breakdown.

Access: read

Try it with MCPAsk your agent to call google-business-metric-breakdown-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring
fromDatestring (date)

Default: 30 days ago

toDatestring (date)

Default: today (data lags 2-3 days)

metricstringrequired

BUSINESS_IMPRESSIONS_DESKTOP_MAPSBUSINESS_IMPRESSIONS_DESKTOP_SEARCHBUSINESS_IMPRESSIONS_MOBILE_MAPSBUSINESS_IMPRESSIONS_MOBILE_SEARCHBUSINESS_DIRECTION_REQUESTSCALL_CLICKSWEBSITE_CLICKSBUSINESS_BOOKINGSBUSINESS_FOOD_MENU_CLICKSBUSINESS_CONVERSATIONSBUSINESS_FOOD_ORDERS

dayOfWeekstring

MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY

hourinteger

0–23

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
datestring (date)
valueinteger
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/metric-breakdown
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/metric-breakdown?metric=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Food menus

Google Business Profile: Get Menu

GET/accounts/{accountId}/google-business/food-menus

Structured food menus (sections, items, prices, dietary restrictions, allergens, spiciness). Only for menu-capable locations (metadata.canHaveFoodMenus). Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations/getFoodMenus Generic route: /v1/accounts/{accountId}/focus/food-menus.

Access: readZernio: GET /v1/accounts/{accountId}/gmb-food-menus

Try it with MCPAsk your agent to call google-business-food-menus-get (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring

Returns object

idstringread-only
namestringread-only
menusarray of object
Show 4 item attributes
labelsarray of object
Show 3 item attributes
displayNamestring

≤ 140 characters

descriptionstring

≤ 1000 characters

languageCodestring
sourceUrlstring (uri)
cuisinesarray of string
sectionsarray of object
Show 2 item attributes
labelsarray of object
Show 3 item attributes
displayNamestring

≤ 140 characters

descriptionstring

≤ 1000 characters

languageCodestring
itemsarray of object
Show 3 item attributes
labelsarray of object
Show 3 item attributes
displayNamestring

≤ 140 characters

descriptionstring

≤ 1000 characters

languageCodestring
attributesobject
Show 10 child attributes
priceobject
Show 3 child attributes
currencyCodestring

≤ 3 characters

unitsstring
nanosinteger
spicinessstring

MILDMEDIUMHOT

allergenarray of string
dietaryRestrictionarray of string
servesNumPeopleinteger

≥ 1

preparationMethodsarray of string
mediaKeysarray of string
nutritionFactsobject
ingredientsarray of object
portionSizeobject
optionsarray of object
Show 2 item attributes
labelsarray of object
Show 3 item attributes
displayNamestring

≤ 140 characters

descriptionstring

≤ 1000 characters

languageCodestring
attributesobject
Show 10 child attributes
priceobject
spicinessstring

MILDMEDIUMHOT

allergenarray of string
dietaryRestrictionarray of string
servesNumPeopleinteger

≥ 1

preparationMethodsarray of string
mediaKeysarray of string
nutritionFactsobject
ingredientsarray of object
portionSizeobject

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/food-menus
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/food-menus" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Update Menu

PATCH/accounts/{accountId}/google-business/food-menus

Structured food menus (sections, items, prices, dietary restrictions, allergens, spiciness). Only for menu-capable locations (metadata.canHaveFoodMenus). Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations/getFoodMenus Generic route: /v1/accounts/{accountId}/focus/food-menus.

Access: writeZernio: PUT /v1/accounts/{accountId}/gmb-food-menus

Try it with MCPAsk your agent to call google-business-food-menus-update (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

menusarray of objectrequired
Show 4 item attributes
labelsarray of object
Show 3 item attributes
displayNamestring

≤ 140 characters

descriptionstring

≤ 1000 characters

languageCodestring
sourceUrlstring (uri)
cuisinesarray of string
sectionsarray of object
Show 2 item attributes
labelsarray of object
Show 3 item attributes
displayNamestring

≤ 140 characters

descriptionstring

≤ 1000 characters

languageCodestring
itemsarray of object
Show 3 item attributes
labelsarray of object
Show 3 item attributes
displayNamestring

≤ 140 characters

descriptionstring

≤ 1000 characters

languageCodestring
attributesobject
Show 10 child attributes
priceobject
Show 3 child attributes
currencyCodestring

≤ 3 characters

unitsstring
nanosinteger
spicinessstring

MILDMEDIUMHOT

allergenarray of string
dietaryRestrictionarray of string
servesNumPeopleinteger

≥ 1

preparationMethodsarray of string
mediaKeysarray of string
nutritionFactsobject
ingredientsarray of object
portionSizeobject
optionsarray of object
Show 2 item attributes
labelsarray of object
Show 3 item attributes
displayNamestring

≤ 140 characters

descriptionstring

≤ 1000 characters

languageCodestring
attributesobject
Show 10 child attributes
priceobject
spicinessstring

MILDMEDIUMHOT

allergenarray of string
dietaryRestrictionarray of string
servesNumPeopleinteger

≥ 1

preparationMethodsarray of string
mediaKeysarray of string
nutritionFactsobject
ingredientsarray of object
portionSizeobject
updateMaskstringdefault: "menus"
locationIdstring

Returns object

idstringread-only
namestringread-only
menusarray of object
Show 4 item attributes
labelsarray of object
Show 3 item attributes
displayNamestring

≤ 140 characters

descriptionstring

≤ 1000 characters

languageCodestring
sourceUrlstring (uri)
cuisinesarray of string
sectionsarray of object
Show 2 item attributes
labelsarray of object
Show 3 item attributes
displayNamestring

≤ 140 characters

descriptionstring

≤ 1000 characters

languageCodestring
itemsarray of object
Show 3 item attributes
labelsarray of object
Show 3 item attributes
displayNamestring

≤ 140 characters

descriptionstring

≤ 1000 characters

languageCodestring
attributesobject
Show 10 child attributes
priceobject
Show 3 child attributes
currencyCodestring

≤ 3 characters

unitsstring
nanosinteger
spicinessstring

MILDMEDIUMHOT

allergenarray of string
dietaryRestrictionarray of string
servesNumPeopleinteger

≥ 1

preparationMethodsarray of string
mediaKeysarray of string
nutritionFactsobject
ingredientsarray of object
portionSizeobject
optionsarray of object
Show 2 item attributes
labelsarray of object
Show 3 item attributes
displayNamestring

≤ 140 characters

descriptionstring

≤ 1000 characters

languageCodestring
attributesobject
Show 10 child attributes
priceobject
spicinessstring

MILDMEDIUMHOT

allergenarray of string
dietaryRestrictionarray of string
servesNumPeopleinteger

≥ 1

preparationMethodsarray of string
mediaKeysarray of string
nutritionFactsobject
ingredientsarray of object
portionSizeobject

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/google-business/food-menus
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/food-menus" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "menus": [
      {
        "labels": [
          {
            "displayName": "string",
            "description": "string"
          }
        ],
        "sourceUrl": "https://example.com"
      }
    ],
    "updateMask": "menus",
    "locationId": "string"
  }'
Response · 200

Services

Google Business Profile: List Services

GET/accounts/{accountId}/google-business/services

Services offered: structured (Google service types of your categories) or free-form, with optional price. Google stores them as one list: every change replaces the whole list. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations#ServiceItem Generic route: /v1/accounts/{accountId}/focus/services.

Access: readZernio: GET /v1/accounts/{accountId}/gmb-services

Try it with MCPAsk your agent to call google-business-services-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
idstringread-only
structuredServiceItemobject
Show 2 child attributes
serviceTypeIdstring
descriptionstring

≤ 300 characters

freeFormServiceItemobject
Show 2 child attributes
categorystring

categories/gcid:…

labelobject
Show 3 child attributes
displayNamestring

≤ 140 characters

descriptionstring

≤ 250 characters

languageCodestring
priceobject
Show 3 child attributes
currencyCodestring

≤ 3 characters

unitsstring
nanosinteger
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/services
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/services" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Create a Services item

POST/accounts/{accountId}/google-business/services

Append a service. Services offered: structured (Google service types of your categories) or free-form, with optional price. Google stores them as one list: every change replaces the whole list. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations#ServiceItem Generic route: /v1/accounts/{accountId}/focus/services.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call google-business-services-create (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

structuredServiceItemobject
Show 2 child attributes
serviceTypeIdstring
descriptionstring

≤ 300 characters

freeFormServiceItemobject
Show 2 child attributes
categorystring

categories/gcid:…

labelobject
Show 3 child attributes
displayNamestring

≤ 140 characters

descriptionstring

≤ 250 characters

languageCodestring
priceobject
Show 3 child attributes
currencyCodestring

≤ 3 characters

unitsstring
nanosinteger

Returns object

idstringread-only
structuredServiceItemobject
Show 2 child attributes
serviceTypeIdstring
descriptionstring

≤ 300 characters

freeFormServiceItemobject
Show 2 child attributes
categorystring

categories/gcid:…

labelobject
Show 3 child attributes
displayNamestring

≤ 140 characters

descriptionstring

≤ 250 characters

languageCodestring
priceobject
Show 3 child attributes
currencyCodestring

≤ 3 characters

unitsstring
nanosinteger

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/services
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/services" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "structuredServiceItem": {
      "serviceTypeId": "string",
      "description": "string"
    },
    "freeFormServiceItem": {
      "category": "string",
      "label": {
        "displayName": "string",
        "description": "string"
      }
    },
    "price": {
      "currencyCode": "string",
      "units": "string"
    }
  }'
Response · 201

Google Business Profile: Update a Services item

PATCH/accounts/{accountId}/google-business/services/{itemId}

Services offered: structured (Google service types of your categories) or free-form, with optional price. Google stores them as one list: every change replaces the whole list. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations#ServiceItem Generic route: /v1/accounts/{accountId}/focus/services.

Access: writeZernio: PUT /v1/accounts/{accountId}/gmb-services

Try it with MCPAsk your agent to call google-business-services-update (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

structuredServiceItemobject
Show 2 child attributes
serviceTypeIdstring
descriptionstring

≤ 300 characters

freeFormServiceItemobject
Show 2 child attributes
categorystring

categories/gcid:…

labelobject
Show 3 child attributes
displayNamestring

≤ 140 characters

descriptionstring

≤ 250 characters

languageCodestring
priceobject
Show 3 child attributes
currencyCodestring

≤ 3 characters

unitsstring
nanosinteger

Returns object

idstringread-only
structuredServiceItemobject
Show 2 child attributes
serviceTypeIdstring
descriptionstring

≤ 300 characters

freeFormServiceItemobject
Show 2 child attributes
categorystring

categories/gcid:…

labelobject
Show 3 child attributes
displayNamestring

≤ 140 characters

descriptionstring

≤ 250 characters

languageCodestring
priceobject
Show 3 child attributes
currencyCodestring

≤ 3 characters

unitsstring
nanosinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/google-business/services/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/services/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "structuredServiceItem": {
      "serviceTypeId": "string",
      "description": "string"
    },
    "freeFormServiceItem": {
      "category": "string",
      "label": {
        "displayName": "string",
        "description": "string"
      }
    },
    "price": {
      "currencyCode": "string",
      "units": "string"
    }
  }'
Response · 200

Google Business Profile: Delete a Services item

DELETE/accounts/{accountId}/google-business/services/{itemId}

Services offered: structured (Google service types of your categories) or free-form, with optional price. Google stores them as one list: every change replaces the whole list. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations#ServiceItem Generic route: /v1/accounts/{accountId}/focus/services.

Access: write

Try it with MCPAsk your agent to call google-business-services-delete (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/google-business/services/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/services/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Replace all services (Services)

POST/accounts/{accountId}/google-business/services/replace

Zernio PUT gmb-services (full-list replace). Services offered: structured (Google service types of your categories) or free-form, with optional price. Google stores them as one list: every change replaces the whole list. Destructive. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations#ServiceItem Generic route: /v1/accounts/{accountId}/focus/services.

Access: write

Try it with MCPAsk your agent to call google-business-services-replace (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

serviceItemsarray of objectrequired
Show 3 item attributes
structuredServiceItemobject
Show 2 child attributes
serviceTypeIdstring
descriptionstring

≤ 300 characters

freeFormServiceItemobject
Show 2 child attributes
categorystring

categories/gcid:…

labelobject
Show 3 child attributes
displayNamestring

≤ 140 characters

descriptionstring

≤ 250 characters

languageCodestring
priceobject
Show 3 child attributes
currencyCodestring

≤ 3 characters

unitsstring
nanosinteger
locationIdstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/services/replace
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/services/replace" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "serviceItems": [
      {
        "structuredServiceItem": {
          "serviceTypeId": "string",
          "description": "string"
        },
        "freeFormServiceItem": {
          "category": "string",
          "label": {
            "displayName": "string",
            "description": "string"
          }
        }
      }
    ],
    "locationId": "string"
  }'
Response · 200
GET/accounts/{accountId}/google-business/place-action-links

Booking, ordering, reservation and shop links on the profile. Links from third-party providers are read-only. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/placeactions/rest/v1/locations.placeActionLinks Generic route: /v1/accounts/{accountId}/focus/place-action-links.

Access: readZernio: GET /v1/accounts/{accountId}/gmb-place-actions

Try it with MCPAsk your agent to call google-business-place-action-links-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring
placeActionTypestring

APPOINTMENTONLINE_APPOINTMENTDINING_RESERVATIONFOOD_ORDERINGFOOD_DELIVERYFOOD_TAKEOUTSHOP_ONLINESOLOPRENEUR_APPOINTMENT

pageSizeinteger
pageTokenstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstringread-only
namestringread-only
uristring (uri)
placeActionTypestring

APPOINTMENTONLINE_APPOINTMENTDINING_RESERVATIONFOOD_ORDERINGFOOD_DELIVERYFOOD_TAKEOUTSHOP_ONLINESOLOPRENEUR_APPOINTMENT

isPreferredboolean
isEditablebooleanread-only
providerTypestringread-only

MERCHANTAGGREGATOR_3P

createTimestring (date-time)read-only
updateTimestring (date-time)read-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/place-action-links
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/place-action-links" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
POST/accounts/{accountId}/google-business/place-action-links

Booking, ordering, reservation and shop links on the profile. Links from third-party providers are read-only. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/placeactions/rest/v1/locations.placeActionLinks Generic route: /v1/accounts/{accountId}/focus/place-action-links.

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/gmb-place-actions

Try it with MCPAsk your agent to call google-business-place-action-links-create (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

uristring (uri)required
placeActionTypestringrequired

APPOINTMENTONLINE_APPOINTMENTDINING_RESERVATIONFOOD_ORDERINGFOOD_DELIVERYFOOD_TAKEOUTSHOP_ONLINESOLOPRENEUR_APPOINTMENT

isPreferredboolean
locationIdstring

Returns object

idstringread-only
namestringread-only
uristring (uri)
placeActionTypestring

APPOINTMENTONLINE_APPOINTMENTDINING_RESERVATIONFOOD_ORDERINGFOOD_DELIVERYFOOD_TAKEOUTSHOP_ONLINESOLOPRENEUR_APPOINTMENT

isPreferredboolean
isEditablebooleanread-only
providerTypestringread-only

MERCHANTAGGREGATOR_3P

createTimestring (date-time)read-only
updateTimestring (date-time)read-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/place-action-links
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/place-action-links" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "uri": "https://example.com",
    "placeActionType": "APPOINTMENT",
    "isPreferred": true,
    "locationId": "string"
  }'
Response · 201
GET/accounts/{accountId}/google-business/place-action-links/{itemId}

Booking, ordering, reservation and shop links on the profile. Links from third-party providers are read-only. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/placeactions/rest/v1/locations.placeActionLinks Generic route: /v1/accounts/{accountId}/focus/place-action-links.

Access: read

Try it with MCPAsk your agent to call google-business-place-action-links-get (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
namestringread-only
uristring (uri)
placeActionTypestring

APPOINTMENTONLINE_APPOINTMENTDINING_RESERVATIONFOOD_ORDERINGFOOD_DELIVERYFOOD_TAKEOUTSHOP_ONLINESOLOPRENEUR_APPOINTMENT

isPreferredboolean
isEditablebooleanread-only
providerTypestringread-only

MERCHANTAGGREGATOR_3P

createTimestring (date-time)read-only
updateTimestring (date-time)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/place-action-links/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/place-action-links/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
PATCH/accounts/{accountId}/google-business/place-action-links/{itemId}

Booking, ordering, reservation and shop links on the profile. Links from third-party providers are read-only. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/placeactions/rest/v1/locations.placeActionLinks Generic route: /v1/accounts/{accountId}/focus/place-action-links.

Access: writeZernio: PATCH /v1/accounts/{accountId}/gmb-place-actions

Try it with MCPAsk your agent to call google-business-place-action-links-update (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

uristring (uri)
placeActionTypestring

APPOINTMENTONLINE_APPOINTMENTDINING_RESERVATIONFOOD_ORDERINGFOOD_DELIVERYFOOD_TAKEOUTSHOP_ONLINESOLOPRENEUR_APPOINTMENT

isPreferredboolean

Returns object

idstringread-only
namestringread-only
uristring (uri)
placeActionTypestring

APPOINTMENTONLINE_APPOINTMENTDINING_RESERVATIONFOOD_ORDERINGFOOD_DELIVERYFOOD_TAKEOUTSHOP_ONLINESOLOPRENEUR_APPOINTMENT

isPreferredboolean
isEditablebooleanread-only
providerTypestringread-only

MERCHANTAGGREGATOR_3P

createTimestring (date-time)read-only
updateTimestring (date-time)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/google-business/place-action-links/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/place-action-links/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "uri": "https://example.com",
    "placeActionType": "APPOINTMENT",
    "isPreferred": true
  }'
Response · 200
DELETE/accounts/{accountId}/google-business/place-action-links/{itemId}

Booking, ordering, reservation and shop links on the profile. Links from third-party providers are read-only. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/placeactions/rest/v1/locations.placeActionLinks Generic route: /v1/accounts/{accountId}/focus/place-action-links.

Access: writeZernio: DELETE /v1/accounts/{accountId}/gmb-place-actions

Try it with MCPAsk your agent to call google-business-place-action-links-delete (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/google-business/place-action-links/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/place-action-links/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Place action types

Google Business Profile: List Action link types

GET/accounts/{accountId}/google-business/place-action-types

Action link types available for this location or a region. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/placeactions/rest/v1/placeActionTypeMetadata/list Generic route: /v1/accounts/{accountId}/focus/place-action-types.

Access: read

Try it with MCPAsk your agent to call google-business-place-action-types-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring
regionCodestring
languageCodestring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
placeActionTypestring

APPOINTMENTONLINE_APPOINTMENTDINING_RESERVATIONFOOD_ORDERINGFOOD_DELIVERYFOOD_TAKEOUTSHOP_ONLINESOLOPRENEUR_APPOINTMENT

displayNamestring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/place-action-types
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/place-action-types" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Lodging

Google Business Profile: Get Hotel details

GET/accounts/{accountId}/google-business/lodging

Lodging attributes for hotels (metadata.canOperateLodgingData): property, policies, pools, wellness, food & drink, accessibility, connectivity, guest units, sustainability, …. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/lodging/rest/v1/locations.lodging Generic route: /v1/accounts/{accountId}/focus/lodging.

Access: read

Try it with MCPAsk your agent to call google-business-lodging-get (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring
readMaskstringdefault: "*"

Returns object

propertyobject
servicesobject
policiesobject
foodAndDrinkobject
poolsobject
wellnessobject
activitiesobject
transportationobject
familiesobject
connectivityobject
businessobject
accessibilityobject
housekeepingobject
healthAndSafetyobject
parkingobject
petsobject
sustainabilityobject
commonLivingAreaobject
guestUnitsarray of object
allUnitsobjectread-only
someUnitsobjectread-only
metadataobjectread-only
Show 1 child attributes
updateTimestring (date-time)
namestringread-only
idstringread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/lodging
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/lodging" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Update Hotel details

PATCH/accounts/{accountId}/google-business/lodging

Lodging attributes for hotels (metadata.canOperateLodgingData): property, policies, pools, wellness, food & drink, accessibility, connectivity, guest units, sustainability, …. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/lodging/rest/v1/locations.lodging Generic route: /v1/accounts/{accountId}/focus/lodging.

Access: write

Try it with MCPAsk your agent to call google-business-lodging-update (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

lodgingobjectrequired
updateMaskstring
locationIdstring

Returns object

propertyobject
servicesobject
policiesobject
foodAndDrinkobject
poolsobject
wellnessobject
activitiesobject
transportationobject
familiesobject
connectivityobject
businessobject
accessibilityobject
housekeepingobject
healthAndSafetyobject
parkingobject
petsobject
sustainabilityobject
commonLivingAreaobject
guestUnitsarray of object
allUnitsobjectread-only
someUnitsobjectread-only
metadataobjectread-only
Show 1 child attributes
updateTimestring (date-time)
namestringread-only
idstringread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/google-business/lodging
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/lodging" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lodging": {},
    "updateMask": "string",
    "locationId": "string"
  }'
Response · 200

Google Business Profile: Google-updated values (Hotel details)

POST/accounts/{accountId}/google-business/lodging/google-updated

Google-updated values. Lodging attributes for hotels (metadata.canOperateLodgingData): property, policies, pools, wellness, food & drink, accessibility, connectivity, guest units, sustainability, …. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/lodging/rest/v1/locations.lodging Generic route: /v1/accounts/{accountId}/focus/lodging.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call google-business-lodging-google-updated (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

locationIdstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/lodging/google-updated
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/lodging/google-updated" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "locationId": "string"
  }'
Response · 200

Verifications

Google Business Profile: List Verifications

GET/accounts/{accountId}/google-business/verifications

Verify the location: fetch available methods, start (postcard, phone call, SMS, email, auto) and complete with the PIN. Service-area businesses must pass their address as context. Video verification is UI-only. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/verifications/rest Generic route: /v1/accounts/{accountId}/focus/verifications.

Access: readZernio: GET /v1/accounts/{accountId}/gmb-verifications

Try it with MCPAsk your agent to call google-business-verifications-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring
pageSizeinteger
pageTokenstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstringread-only
namestringread-only
methodstring

ADDRESSEMAILPHONE_CALLSMSAUTOTRUSTED_PARTNER

statestring

PENDINGCOMPLETEDFAILED

createTimestring (date-time)
announcementstring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/verifications
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/verifications" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Create a Verifications item

POST/accounts/{accountId}/google-business/verifications

Start a verification. Verify the location: fetch available methods, start (postcard, phone call, SMS, email, auto) and complete with the PIN. Service-area businesses must pass their address as context. Video verification is UI-only. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/verifications/rest Generic route: /v1/accounts/{accountId}/focus/verifications.

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/gmb-verifications/optionsPOST /v1/accounts/{accountId}/gmb-verificationsPOST /v1/accounts/{accountId}/gmb-verifications/{verificationId}/complete

Try it with MCPAsk your agent to call google-business-verifications-create (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

methodstringrequired

ADDRESSEMAILPHONE_CALLSMSAUTOTRUSTED_PARTNER

languageCodestringdefault: "en"
phoneNumberstring

PHONE_CALL / SMS

emailAddressstring

EMAIL

mailerContactstring

ADDRESS: name on the postcard

trustedPartnerTokenstring
contextobject
Show 1 child attributes
addressobject
Show 9 child attributes
regionCodestring

ISO 3166-1 alpha-2 country

≤ 2 characters

languageCodestring
postalCodestring
administrativeAreastring

State / province

localitystring

City / town

sublocalitystring
addressLinesarray of string

≤ 5 items

recipientsarray of string
organizationstring
locationIdstring

Returns object

idstringread-only
namestringread-only
methodstring

ADDRESSEMAILPHONE_CALLSMSAUTOTRUSTED_PARTNER

statestring

PENDINGCOMPLETEDFAILED

createTimestring (date-time)
announcementstring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/verifications
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/verifications" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "ADDRESS",
    "languageCode": "en",
    "phoneNumber": "string",
    "emailAddress": "string",
    "mailerContact": "string"
  }'
Response · 201

Google Business Profile: Available methods (Verifications)

POST/accounts/{accountId}/google-business/verifications/options

Available methods. Verify the location: fetch available methods, start (postcard, phone call, SMS, email, auto) and complete with the PIN. Service-area businesses must pass their address as context. Video verification is UI-only. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/verifications/rest Generic route: /v1/accounts/{accountId}/focus/verifications.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call google-business-verifications-options (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

languageCodestringdefault: "en"
contextobject
Show 1 child attributes
addressobject
Show 9 child attributes
regionCodestring

ISO 3166-1 alpha-2 country

≤ 2 characters

languageCodestring
postalCodestring
administrativeAreastring

State / province

localitystring

City / town

sublocalitystring
addressLinesarray of string

≤ 5 items

recipientsarray of string
organizationstring
locationIdstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/verifications/options
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/verifications/options" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "languageCode": "en",
    "context": {
      "address": {
        "regionCode": "string",
        "languageCode": "string"
      }
    },
    "locationId": "string"
  }'
Response · 200

Google Business Profile: Enter PIN (Verifications)

POST/accounts/{accountId}/google-business/verifications/{itemId}/complete

Enter PIN. Verify the location: fetch available methods, start (postcard, phone call, SMS, email, auto) and complete with the PIN. Service-area businesses must pass their address as context. Video verification is UI-only. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/verifications/rest Generic route: /v1/accounts/{accountId}/focus/verifications.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call google-business-verifications-complete (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

pinstringrequired
locationIdstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/verifications/{itemId}/complete
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/verifications/ITEM_ID/complete" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "pin": "string",
    "locationId": "string"
  }'
Response · 200

Voice of merchant

Google Business Profile: Get Profile status

GET/accounts/{accountId}/google-business/voice-of-merchant

Whether edits and posts go live (Voice of Merchant), and what to do otherwise: verify, wait, resolve an ownership conflict, or comply with guidelines (suspended/disabled). Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/verifications/rest/v1/locations/getVoiceOfMerchantState Generic route: /v1/accounts/{accountId}/focus/voice-of-merchant.

Access: readZernio: GET /v1/accounts/{accountId}/gmb-verifications

Try it with MCPAsk your agent to call google-business-voice-of-merchant-get (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring

Returns object

hasVoiceOfMerchantboolean
hasBusinessAuthorityboolean
waitForVoiceOfMerchantobject
verifyobject
Show 1 child attributes
hasPendingVerificationboolean
resolveOwnershipConflictobject
complyWithGuidelinesobject
Show 1 child attributes
recommendationReasonstring

BUSINESS_LOCATION_SUSPENDEDBUSINESS_LOCATION_DISABLED

summaryobject
Show 3 child attributes
statusstring

livepending_verificationneeds_verificationwaitingownership_conflictsuspendeddisabledunknown

canEditboolean
messagestring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/voice-of-merchant
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/voice-of-merchant" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Accounts

Google Business Profile: List Business accounts

GET/accounts/{accountId}/google-business/accounts

Personal accounts, location groups and organizations this Google login can access. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: read

Try it with MCPAsk your agent to call google-business-accounts-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

typestring

PERSONALLOCATION_GROUPUSER_GROUPORGANIZATION

parentAccountstring
pageSizeinteger

≤ 20

pageTokenstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 11 item attributes
idstringread-only
namestringread-only
accountNamestring
typestring

PERSONALLOCATION_GROUPUSER_GROUPORGANIZATION

rolestringread-only

PRIMARY_OWNEROWNERMANAGERSITE_MANAGER

verificationStatestringread-only

VERIFIEDUNVERIFIEDVERIFICATION_REQUESTED

vettedStatestringread-only

NOT_VETTEDVETTEDINVALID

permissionLevelstringread-only

OWNER_LEVELMEMBER_LEVEL

accountNumberstringread-only
primaryOwnerstring
organizationInfoobjectread-only
Show 3 child attributes
registeredDomainstring
phoneNumberstring
addressobject
Show 9 child attributes
regionCodestring

ISO 3166-1 alpha-2 country

≤ 2 characters

languageCodestring
postalCodestring
administrativeAreastring

State / province

localitystring

City / town

sublocalitystring
addressLinesarray of string

≤ 5 items

recipientsarray of string
organizationstring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/accounts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Create a Business accounts item

POST/accounts/{accountId}/google-business/accounts

Create a location group. Personal accounts, location groups and organizations this Google login can access. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call google-business-accounts-create (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

accountNamestringrequired
primaryOwnerstring

accounts/{id} of the owner

Returns object

idstringread-only
namestringread-only
accountNamestring
typestring

PERSONALLOCATION_GROUPUSER_GROUPORGANIZATION

rolestringread-only

PRIMARY_OWNEROWNERMANAGERSITE_MANAGER

verificationStatestringread-only

VERIFIEDUNVERIFIEDVERIFICATION_REQUESTED

vettedStatestringread-only

NOT_VETTEDVETTEDINVALID

permissionLevelstringread-only

OWNER_LEVELMEMBER_LEVEL

accountNumberstringread-only
primaryOwnerstring
organizationInfoobjectread-only
Show 3 child attributes
registeredDomainstring
phoneNumberstring
addressobject
Show 9 child attributes
regionCodestring

ISO 3166-1 alpha-2 country

≤ 2 characters

languageCodestring
postalCodestring
administrativeAreastring

State / province

localitystring

City / town

sublocalitystring
addressLinesarray of string

≤ 5 items

recipientsarray of string
organizationstring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/accounts
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "accountName": "string",
    "primaryOwner": "string"
  }'
Response · 201

Google Business Profile: Get a Business accounts item

GET/accounts/{accountId}/google-business/accounts/{itemId}

Personal accounts, location groups and organizations this Google login can access. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: read

Try it with MCPAsk your agent to call google-business-accounts-get (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
namestringread-only
accountNamestring
typestring

PERSONALLOCATION_GROUPUSER_GROUPORGANIZATION

rolestringread-only

PRIMARY_OWNEROWNERMANAGERSITE_MANAGER

verificationStatestringread-only

VERIFIEDUNVERIFIEDVERIFICATION_REQUESTED

vettedStatestringread-only

NOT_VETTEDVETTEDINVALID

permissionLevelstringread-only

OWNER_LEVELMEMBER_LEVEL

accountNumberstringread-only
primaryOwnerstring
organizationInfoobjectread-only
Show 3 child attributes
registeredDomainstring
phoneNumberstring
addressobject
Show 9 child attributes
regionCodestring

ISO 3166-1 alpha-2 country

≤ 2 characters

languageCodestring
postalCodestring
administrativeAreastring

State / province

localitystring

City / town

sublocalitystring
addressLinesarray of string

≤ 5 items

recipientsarray of string
organizationstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/accounts/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/accounts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Update a Business accounts item

PATCH/accounts/{accountId}/google-business/accounts/{itemId}

Rename (location groups). Personal accounts, location groups and organizations this Google login can access. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: write

Try it with MCPAsk your agent to call google-business-accounts-update (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

accountNamestringrequired
validateOnlyboolean

Returns object

idstringread-only
namestringread-only
accountNamestring
typestring

PERSONALLOCATION_GROUPUSER_GROUPORGANIZATION

rolestringread-only

PRIMARY_OWNEROWNERMANAGERSITE_MANAGER

verificationStatestringread-only

VERIFIEDUNVERIFIEDVERIFICATION_REQUESTED

vettedStatestringread-only

NOT_VETTEDVETTEDINVALID

permissionLevelstringread-only

OWNER_LEVELMEMBER_LEVEL

accountNumberstringread-only
primaryOwnerstring
organizationInfoobjectread-only
Show 3 child attributes
registeredDomainstring
phoneNumberstring
addressobject
Show 9 child attributes
regionCodestring

ISO 3166-1 alpha-2 country

≤ 2 characters

languageCodestring
postalCodestring
administrativeAreastring

State / province

localitystring

City / town

sublocalitystring
addressLinesarray of string

≤ 5 items

recipientsarray of string
organizationstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/google-business/accounts/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/accounts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountName": "string",
    "validateOnly": true
  }'
Response · 200

Account admins

Google Business Profile: List Account admins

GET/accounts/{accountId}/google-business/account-admins

Owners and managers of a business account. Notify the end client within 48 h of admin/manager changes. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts.admins Generic route: /v1/accounts/{accountId}/focus/account-admins.

Access: read

Try it with MCPAsk your agent to call google-business-account-admins-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

googleAccountIdstring

Default: the connection's account

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstringread-only
namestringread-only
adminstring

Invitee email on create; display name afterwards

accountstringread-only
rolestring

PRIMARY_OWNEROWNERMANAGERSITE_MANAGER

pendingInvitationbooleanread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/account-admins
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/account-admins" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Create a Account admins item

POST/accounts/{accountId}/google-business/account-admins

Invite by email. Owners and managers of a business account. Notify the end client within 48 h of admin/manager changes. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts.admins Generic route: /v1/accounts/{accountId}/focus/account-admins.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call google-business-account-admins-create (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

emailstring (email)required
rolestringrequired

OWNERMANAGER

googleAccountIdstring

Returns object

idstringread-only
namestringread-only
adminstring

Invitee email on create; display name afterwards

accountstringread-only
rolestring

PRIMARY_OWNEROWNERMANAGERSITE_MANAGER

pendingInvitationbooleanread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/account-admins
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/account-admins" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "role": "OWNER",
    "googleAccountId": "string"
  }'
Response · 201

Google Business Profile: Update a Account admins item

PATCH/accounts/{accountId}/google-business/account-admins/{itemId}

Owners and managers of a business account. Notify the end client within 48 h of admin/manager changes. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts.admins Generic route: /v1/accounts/{accountId}/focus/account-admins.

Access: write

Try it with MCPAsk your agent to call google-business-account-admins-update (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

rolestringrequired

PRIMARY_OWNEROWNERMANAGERSITE_MANAGER

Returns object

idstringread-only
namestringread-only
adminstring

Invitee email on create; display name afterwards

accountstringread-only
rolestring

PRIMARY_OWNEROWNERMANAGERSITE_MANAGER

pendingInvitationbooleanread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/google-business/account-admins/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/account-admins/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "PRIMARY_OWNER"
  }'
Response · 200

Google Business Profile: Delete a Account admins item

DELETE/accounts/{accountId}/google-business/account-admins/{itemId}

Owners and managers of a business account. Notify the end client within 48 h of admin/manager changes. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts.admins Generic route: /v1/accounts/{accountId}/focus/account-admins.

Access: write

Try it with MCPAsk your agent to call google-business-account-admins-delete (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/google-business/account-admins/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/account-admins/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Location admins

Google Business Profile: List Location managers

GET/accounts/{accountId}/google-business/location-admins

People who can manage this location (owner, manager, site manager). Notify the end client within 48 h of admin/manager changes. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/locations.admins Generic route: /v1/accounts/{accountId}/focus/location-admins.

Access: read

Try it with MCPAsk your agent to call google-business-location-admins-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

locationIdstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstringread-only
namestringread-only
adminstring

Invitee email on create; display name afterwards

accountstringread-only
rolestring

PRIMARY_OWNEROWNERMANAGERSITE_MANAGER

pendingInvitationbooleanread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/location-admins
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/location-admins" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Create a Location managers item

POST/accounts/{accountId}/google-business/location-admins

Invite by email. People who can manage this location (owner, manager, site manager). Notify the end client within 48 h of admin/manager changes. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/locations.admins Generic route: /v1/accounts/{accountId}/focus/location-admins.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call google-business-location-admins-create (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

emailstring (email)required
rolestringrequired

OWNERMANAGERSITE_MANAGER

locationIdstring

Returns object

idstringread-only
namestringread-only
adminstring

Invitee email on create; display name afterwards

accountstringread-only
rolestring

PRIMARY_OWNEROWNERMANAGERSITE_MANAGER

pendingInvitationbooleanread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/location-admins
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/location-admins" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "role": "OWNER",
    "locationId": "string"
  }'
Response · 201

Google Business Profile: Update a Location managers item

PATCH/accounts/{accountId}/google-business/location-admins/{itemId}

People who can manage this location (owner, manager, site manager). Notify the end client within 48 h of admin/manager changes. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/locations.admins Generic route: /v1/accounts/{accountId}/focus/location-admins.

Access: write

Try it with MCPAsk your agent to call google-business-location-admins-update (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

rolestringrequired

PRIMARY_OWNEROWNERMANAGERSITE_MANAGER

Returns object

idstringread-only
namestringread-only
adminstring

Invitee email on create; display name afterwards

accountstringread-only
rolestring

PRIMARY_OWNEROWNERMANAGERSITE_MANAGER

pendingInvitationbooleanread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/google-business/location-admins/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/location-admins/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "PRIMARY_OWNER"
  }'
Response · 200

Google Business Profile: Delete a Location managers item

DELETE/accounts/{accountId}/google-business/location-admins/{itemId}

People who can manage this location (owner, manager, site manager). Notify the end client within 48 h of admin/manager changes. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/locations.admins Generic route: /v1/accounts/{accountId}/focus/location-admins.

Access: write

Try it with MCPAsk your agent to call google-business-location-admins-delete (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/google-business/location-admins/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/location-admins/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Invitations

Google Business Profile: List Invitations

GET/accounts/{accountId}/google-business/invitations

Pending invitations for this Google login to manage accounts or locations. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts.invitations Generic route: /v1/accounts/{accountId}/focus/invitations.

Access: read

Try it with MCPAsk your agent to call google-business-invitations-list (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

googleAccountIdstring
targetTypestring

ACCOUNTS_ONLYLOCATIONS_ONLY

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstringread-only
namestringread-only
rolestringread-only

PRIMARY_OWNEROWNERMANAGERSITE_MANAGER

targetTypestringread-only

ACCOUNTS_ONLYLOCATIONS_ONLY

targetAccountobject
Show 11 child attributes
idstringread-only
namestringread-only
accountNamestring
typestring

PERSONALLOCATION_GROUPUSER_GROUPORGANIZATION

rolestringread-only

PRIMARY_OWNEROWNERMANAGERSITE_MANAGER

verificationStatestringread-only

VERIFIEDUNVERIFIEDVERIFICATION_REQUESTED

vettedStatestringread-only

NOT_VETTEDVETTEDINVALID

permissionLevelstringread-only

OWNER_LEVELMEMBER_LEVEL

accountNumberstringread-only
primaryOwnerstring
organizationInfoobjectread-only
Show 3 child attributes
registeredDomainstring
phoneNumberstring
addressobject
Show 9 child attributes
regionCodestring

ISO 3166-1 alpha-2 country

≤ 2 characters

languageCodestring
postalCodestring
administrativeAreastring

State / province

localitystring

City / town

sublocalitystring
addressLinesarray of string

≤ 5 items

recipientsarray of string
organizationstring
targetLocationobjectread-only
Show 3 child attributes
locationNamestring
addressstring
placeIdstring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/invitations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/invitations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Accept (Invitations)

POST/accounts/{accountId}/google-business/invitations/{itemId}/accept

Accept. Pending invitations for this Google login to manage accounts or locations. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts.invitations Generic route: /v1/accounts/{accountId}/focus/invitations.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call google-business-invitations-accept (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/invitations/{itemId}/accept
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/invitations/ITEM_ID/accept" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Google Business Profile: Decline (Invitations)

POST/accounts/{accountId}/google-business/invitations/{itemId}/decline

Decline. Pending invitations for this Google login to manage accounts or locations. Destructive. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts.invitations Generic route: /v1/accounts/{accountId}/focus/invitations.

Access: write

Try it with MCPAsk your agent to call google-business-invitations-decline (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/invitations/{itemId}/decline
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/invitations/ITEM_ID/decline" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Notification settings

Google Business Profile: Get Real-time notifications

GET/accounts/{accountId}/google-business/notification-settings

Pub/Sub topic and notification types for this business account (new/updated reviews, customer media, Google updates, duplicate location, Voice of Merchant changes). Q&A types are deprecated. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/notifications/rest/v1/NotificationSetting Generic route: /v1/accounts/{accountId}/focus/notification-settings.

Access: read

Try it with MCPAsk your agent to call google-business-notification-settings-get (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

googleAccountIdstring

Returns object

namestringread-only
pubsubTopicstring

projects/{project}/topics/{topic}; empty disables

notificationTypesarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/google-business/notification-settings
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/notification-settings" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Google Business Profile: Update Real-time notifications

PATCH/accounts/{accountId}/google-business/notification-settings

Pub/Sub topic and notification types for this business account (new/updated reviews, customer media, Google updates, duplicate location, Voice of Merchant changes). Q&A types are deprecated. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/notifications/rest/v1/NotificationSetting Generic route: /v1/accounts/{accountId}/focus/notification-settings.

Access: write

Try it with MCPAsk your agent to call google-business-notification-settings-update (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

pubsubTopicstring
notificationTypesarray of string
googleAccountIdstring

Returns object

namestringread-only
pubsubTopicstring

projects/{project}/topics/{topic}; empty disables

notificationTypesarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/google-business/notification-settings
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/notification-settings" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pubsubTopic": "string",
    "notificationTypes": [
      "GOOGLE_UPDATE"
    ],
    "googleAccountId": "string"
  }'
Response · 200

Google Business Profile: Enable Socialit notifications (Real-time notifications)

POST/accounts/{accountId}/google-business/notification-settings/subscribe

Subscribe to NEW_REVIEW, UPDATED_REVIEW, NEW_CUSTOMER_MEDIA, GOOGLE_UPDATE, DUPLICATE_LOCATION, VOICE_OF_MERCHANT_UPDATED on the Socialit topic. Pub/Sub topic and notification types for this business account (new/updated reviews, customer media, Google updates, duplicate location, Voice of Merchant changes). Q&A types are deprecated. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/notifications/rest/v1/NotificationSetting Generic route: /v1/accounts/{accountId}/focus/notification-settings.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call google-business-notification-settings-subscribe (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

googleAccountIdstring
pubsubTopicstring
notificationTypesarray of string

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/notification-settings/subscribe
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/notification-settings/subscribe" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "googleAccountId": "string",
    "pubsubTopic": "string",
    "notificationTypes": [
      "GOOGLE_UPDATE"
    ]
  }'
Response · 200

Google Business Profile: Disable notifications (Real-time notifications)

POST/accounts/{accountId}/google-business/notification-settings/disable

Disable notifications. Pub/Sub topic and notification types for this business account (new/updated reviews, customer media, Google updates, duplicate location, Voice of Merchant changes). Q&A types are deprecated. Destructive. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/notifications/rest/v1/NotificationSetting Generic route: /v1/accounts/{accountId}/focus/notification-settings.

Access: write

Try it with MCPAsk your agent to call google-business-notification-settings-disable (toolset focus_google_business)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

googleAccountIdstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/google-business/notification-settings/disable
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/notification-settings/disable" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "googleAccountId": "string"
  }'
Response · 200