# Focus · Google Business Profile API

> 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 URL: `https://api.socialit.com/v1`. Authenticate with `Authorization: Bearer <API key or OAuth token>`.

## 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: `read` · MCP tool: `google-business-locations-list` · Zernio: `GET /v1/accounts/{accountId}/gmb-locations`, `GET /v1/connect/googlebusiness/locations`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `search` (string): Business-name substring
- `filter` (string): Raw Google filter, e.g. storeCode="12" (takes precedence)
- `googleAccountId` (string)
- `limit` (integer; 1–500)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/locations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "locationId": "string",
      "externalId": "string",
      "title": "string",
      "accountId": "string",
      "accountName": "string",
      "accountType": "PERSONAL",
      "address": "string",
      "category": "string",
      "storeCode": "string",
      "phone": "+15551234567",
      "websiteUri": "https://example.com",
      "openStatus": "OPEN",
      "isVerified": true,
      "hasPendingEdits": true,
      "hasGoogleUpdated": true,
      "placeId": "string",
      "mapsUri": "https://example.com",
      "reviewUrl": "https://example.com",
      "selected": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `google-business-locations-create` · Zernio: `POST /v1/accounts/{accountId}/gmb-locations/assign`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `googleAccountId` (string)
- `requestId` (string)
- `validateOnly` (boolean)
- `location` (object; required)
  - `location.title` (string; ≤ 100 characters): Business name as on the storefront
  - `location.storeCode` (string; ≤ 64 characters)
  - `location.languageCode` (string)
  - `location.categories` (object)
    - `location.categories.primaryCategory` (object)
      - `location.categories.primaryCategory.name` (string): categories/gcid:…
    - `location.categories.additionalCategories` (array of object; ≤ 9 items)
      - `location.categories.additionalCategories[].name` (string): categories/gcid:…
  - `location.phoneNumbers` (object)
    - `location.phoneNumbers.primaryPhone` (string)
    - `location.phoneNumbers.additionalPhones` (array of string; ≤ 2 items)
  - `location.websiteUri` (string (uri))
  - `location.storefrontAddress` (object): Changing the address can trigger re-verification
    - `location.storefrontAddress.regionCode` (string; ≤ 2 characters): ISO 3166-1 alpha-2 country
    - `location.storefrontAddress.languageCode` (string)
    - `location.storefrontAddress.postalCode` (string)
    - `location.storefrontAddress.administrativeArea` (string): State / province
    - `location.storefrontAddress.locality` (string): City / town
    - `location.storefrontAddress.sublocality` (string)
    - `location.storefrontAddress.addressLines` (array of string; ≤ 5 items)
    - `location.storefrontAddress.recipients` (array of string)
    - `location.storefrontAddress.organization` (string)
  - `location.latlng` (object)
    - `location.latlng.latitude` (number)
    - `location.latlng.longitude` (number)
  - `location.openInfo` (object)
    - `location.openInfo.status` (string; one of OPEN, CLOSED_TEMPORARILY, CLOSED_PERMANENTLY)
    - `location.openInfo.openingDate` (object): Calendar date
      - `location.openInfo.openingDate.year` (integer; ≥ 1)
      - `location.openInfo.openingDate.month` (integer; 1–12)
      - `location.openInfo.openingDate.day` (integer; 1–31)
  - `location.profile` (object)
    - `location.profile.description` (string; ≤ 750 characters)
  - `location.labels` (array of string; ≤ 10 items)
  - `location.adWordsLocationExtensions` (object)
    - `location.adWordsLocationExtensions.adPhone` (string)

```bash
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:

```json
{
  "id": "string",
  "locationId": "string",
  "externalId": "string",
  "title": "string",
  "accountId": "string",
  "accountName": "string",
  "accountType": "PERSONAL",
  "address": "string",
  "category": "string",
  "storeCode": "string",
  "phone": "+15551234567",
  "websiteUri": "https://example.com",
  "openStatus": "OPEN",
  "isVerified": true,
  "hasPendingEdits": true,
  "hasGoogleUpdated": true,
  "placeId": "string",
  "mapsUri": "https://example.com",
  "reviewUrl": "https://example.com",
  "selected": true
}
```

## 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` · MCP tool: `google-business-locations-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/locations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "locationId": "string",
  "externalId": "string",
  "title": "string",
  "accountId": "string",
  "accountName": "string",
  "accountType": "PERSONAL",
  "address": "string",
  "category": "string",
  "storeCode": "string",
  "phone": "+15551234567",
  "websiteUri": "https://example.com",
  "openStatus": "OPEN",
  "isVerified": true,
  "hasPendingEdits": true,
  "hasGoogleUpdated": true,
  "placeId": "string",
  "mapsUri": "https://example.com",
  "reviewUrl": "https://example.com",
  "selected": true
}
```

## 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` · MCP tool: `google-business-locations-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/locations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `google-business-locations-select` · Zernio: `PUT /v1/accounts/{accountId}/gmb-locations`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `googleAccountId` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `google-business-locations-assign`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `profileId` (string; required)
- `googleAccountId` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `google-business-locations-transfer`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `destinationAccount` (string; required): accounts/{id}

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `google-business-business-info-get` · Zernio: `GET /v1/accounts/{accountId}/gmb-location-details`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string): Another location this connection manages ("locations/{id}" or "accounts/{a}/locations/{l}")

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/business-info" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "title": "string",
  "storeCode": "string",
  "languageCode": "string",
  "categories": {
    "primaryCategory": {
      "name": "string",
      "displayName": "string"
    },
    "additionalCategories": [
      {
        "name": "string",
        "displayName": "string"
      }
    ]
  },
  "phoneNumbers": {
    "primaryPhone": "string",
    "additionalPhones": [
      "string"
    ]
  },
  "websiteUri": "https://example.com",
  "storefrontAddress": {
    "regionCode": "string",
    "languageCode": "string",
    "postalCode": "string",
    "administrativeArea": "string",
    "locality": "string",
    "sublocality": "string",
    "addressLines": [
      "string"
    ],
    "recipients": [
      "string"
    ],
    "organization": "string"
  },
  "latlng": {
    "latitude": 1.5,
    "longitude": 1.5
  },
  "openInfo": {
    "status": "OPEN",
    "canReopen": true,
    "openingDate": {
      "year": 1,
      "month": 1,
      "day": 1
    }
  },
  "profile": {
    "description": "string"
  },
  "labels": [
    "string"
  ],
  "adWordsLocationExtensions": {
    "adPhone": "string"
  },
  "metadata": {
    "placeId": "string",
    "mapsUri": "https://example.com",
    "newReviewUri": "https://example.com",
    "hasVoiceOfMerchant": true,
    "hasPendingEdits": true,
    "hasGoogleUpdated": true,
    "canHaveFoodMenus": true,
    "canOperateLodgingData": true,
    "canOperateLocalPost": true,
    "canModifyServiceList": true,
    "canDelete": true,
    "duplicateLocation": "string"
  }
}
```

## 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: `write` · MCP tool: `google-business-business-info-update` · Zernio: `PUT /v1/accounts/{accountId}/gmb-location-details`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `title` (string; ≤ 100 characters): Business name as on the storefront
- `storeCode` (string; ≤ 64 characters)
- `languageCode` (string)
- `categories` (object)
  - `categories.primaryCategory` (object)
    - `categories.primaryCategory.name` (string): categories/gcid:…
  - `categories.additionalCategories` (array of object; ≤ 9 items)
    - `categories.additionalCategories[].name` (string): categories/gcid:…
- `phoneNumbers` (object)
  - `phoneNumbers.primaryPhone` (string)
  - `phoneNumbers.additionalPhones` (array of string; ≤ 2 items)
- `websiteUri` (string (uri))
- `storefrontAddress` (object): Changing the address can trigger re-verification
  - `storefrontAddress.regionCode` (string; ≤ 2 characters): ISO 3166-1 alpha-2 country
  - `storefrontAddress.languageCode` (string)
  - `storefrontAddress.postalCode` (string)
  - `storefrontAddress.administrativeArea` (string): State / province
  - `storefrontAddress.locality` (string): City / town
  - `storefrontAddress.sublocality` (string)
  - `storefrontAddress.addressLines` (array of string; ≤ 5 items)
  - `storefrontAddress.recipients` (array of string)
  - `storefrontAddress.organization` (string)
- `latlng` (object)
  - `latlng.latitude` (number)
  - `latlng.longitude` (number)
- `openInfo` (object)
  - `openInfo.status` (string; one of OPEN, CLOSED_TEMPORARILY, CLOSED_PERMANENTLY)
  - `openInfo.openingDate` (object): Calendar date
    - `openInfo.openingDate.year` (integer; ≥ 1)
    - `openInfo.openingDate.month` (integer; 1–12)
    - `openInfo.openingDate.day` (integer; 1–31)
- `profile` (object)
  - `profile.description` (string; ≤ 750 characters)
- `labels` (array of string; ≤ 10 items)
- `adWordsLocationExtensions` (object)
  - `adWordsLocationExtensions.adPhone` (string)
- `updateMask` (string): Comma-separated, e.g. profile.description,websiteUri
- `validateOnly` (boolean)
- `locationId` (string)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "title": "string",
  "storeCode": "string",
  "languageCode": "string",
  "categories": {
    "primaryCategory": {
      "name": "string",
      "displayName": "string"
    },
    "additionalCategories": [
      {
        "name": "string",
        "displayName": "string"
      }
    ]
  },
  "phoneNumbers": {
    "primaryPhone": "string",
    "additionalPhones": [
      "string"
    ]
  },
  "websiteUri": "https://example.com",
  "storefrontAddress": {
    "regionCode": "string",
    "languageCode": "string",
    "postalCode": "string",
    "administrativeArea": "string",
    "locality": "string",
    "sublocality": "string",
    "addressLines": [
      "string"
    ],
    "recipients": [
      "string"
    ],
    "organization": "string"
  },
  "latlng": {
    "latitude": 1.5,
    "longitude": 1.5
  },
  "openInfo": {
    "status": "OPEN",
    "canReopen": true,
    "openingDate": {
      "year": 1,
      "month": 1,
      "day": 1
    }
  },
  "profile": {
    "description": "string"
  },
  "labels": [
    "string"
  ],
  "adWordsLocationExtensions": {
    "adPhone": "string"
  },
  "metadata": {
    "placeId": "string",
    "mapsUri": "https://example.com",
    "newReviewUri": "https://example.com",
    "hasVoiceOfMerchant": true,
    "hasPendingEdits": true,
    "hasGoogleUpdated": true,
    "canHaveFoodMenus": true,
    "canOperateLodgingData": true,
    "canOperateLocalPost": true,
    "canModifyServiceList": true,
    "canDelete": true,
    "duplicateLocation": "string"
  }
}
```

## 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: `write` · MCP tool: `google-business-business-info-search-categories`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `search` (string; required)
- `regionCode` (string)
- `languageCode` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `google-business-hours-get` · Zernio: `GET /v1/accounts/{accountId}/gmb-location-details`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string): Another location this connection manages ("locations/{id}" or "accounts/{a}/locations/{l}")

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/hours" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "regularHours": {
    "periods": [
      {
        "openDay": "MONDAY",
        "openTime": {
          "hours": 0,
          "minutes": 0
        },
        "closeDay": "MONDAY",
        "closeTime": {
          "hours": 0,
          "minutes": 0
        }
      }
    ]
  },
  "specialHours": {
    "specialHourPeriods": [
      {
        "startDate": {
          "year": 1,
          "month": 1,
          "day": 1
        },
        "endDate": {
          "year": 1,
          "month": 1,
          "day": 1
        },
        "openTime": {
          "hours": 0,
          "minutes": 0
        },
        "closeTime": {
          "hours": 0,
          "minutes": 0
        },
        "closed": true
      }
    ]
  },
  "moreHours": [
    {
      "hoursTypeId": "string",
      "periods": [
        {
          "openDay": "MONDAY",
          "openTime": {
            "hours": null,
            "minutes": null
          },
          "closeDay": "MONDAY",
          "closeTime": {
            "hours": null,
            "minutes": null
          }
        }
      ]
    }
  ],
  "availableMoreHoursTypes": [
    {
      "hoursTypeId": "string",
      "displayName": "string",
      "localizedDisplayName": "string"
    }
  ]
}
```

## 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: `write` · MCP tool: `google-business-hours-update` · Zernio: `PUT /v1/accounts/{accountId}/gmb-location-details`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `regularHours` (object): Regular opening hours
  - `regularHours.periods` (array of object)
    - `regularHours.periods[].openDay` (string; one of MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY)
    - `regularHours.periods[].openTime` (object): 24 h time (hours 24 = midnight end of day)
      - `regularHours.periods[].openTime.hours` (integer; 0–24)
      - `regularHours.periods[].openTime.minutes` (integer; 0–59)
    - `regularHours.periods[].closeDay` (string; one of MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY)
    - `regularHours.periods[].closeTime` (object): 24 h time (hours 24 = midnight end of day)
      - `regularHours.periods[].closeTime.hours` (integer; 0–24)
      - `regularHours.periods[].closeTime.minutes` (integer; 0–59)
- `specialHours` (object): Holiday / exceptional hours
  - `specialHours.specialHourPeriods` (array of object)
    - `specialHours.specialHourPeriods[].startDate` (object): Calendar date
      - `specialHours.specialHourPeriods[].startDate.year` (integer; ≥ 1)
      - `specialHours.specialHourPeriods[].startDate.month` (integer; 1–12)
      - `specialHours.specialHourPeriods[].startDate.day` (integer; 1–31)
    - `specialHours.specialHourPeriods[].endDate` (object): Calendar date
      - `specialHours.specialHourPeriods[].endDate.year` (integer; ≥ 1)
      - `specialHours.specialHourPeriods[].endDate.month` (integer; 1–12)
      - `specialHours.specialHourPeriods[].endDate.day` (integer; 1–31)
    - `specialHours.specialHourPeriods[].openTime` (object): 24 h time (hours 24 = midnight end of day)
      - `specialHours.specialHourPeriods[].openTime.hours` (integer; 0–24)
      - `specialHours.specialHourPeriods[].openTime.minutes` (integer; 0–59)
    - `specialHours.specialHourPeriods[].closeTime` (object): 24 h time (hours 24 = midnight end of day)
      - `specialHours.specialHourPeriods[].closeTime.hours` (integer; 0–24)
      - `specialHours.specialHourPeriods[].closeTime.minutes` (integer; 0–59)
    - `specialHours.specialHourPeriods[].closed` (boolean)
- `moreHours` (array of object)
  - `moreHours[].hoursTypeId` (string): From the primary category moreHoursTypes, e.g. DELIVERY, DRIVE_THROUGH
  - `moreHours[].periods` (array of object)
    - `moreHours[].periods[].openDay` (string; one of MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY)
    - `moreHours[].periods[].openTime` (object): 24 h time (hours 24 = midnight end of day)
      - `moreHours[].periods[].openTime.hours` (integer; 0–24)
      - `moreHours[].periods[].openTime.minutes` (integer; 0–59)
    - `moreHours[].periods[].closeDay` (string; one of MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY)
    - `moreHours[].periods[].closeTime` (object): 24 h time (hours 24 = midnight end of day)
      - `moreHours[].periods[].closeTime.hours` (integer; 0–24)
      - `moreHours[].periods[].closeTime.minutes` (integer; 0–59)
- `locationId` (string)

```bash
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:

```json
{
  "id": "string",
  "regularHours": {
    "periods": [
      {
        "openDay": "MONDAY",
        "openTime": {
          "hours": 0,
          "minutes": 0
        },
        "closeDay": "MONDAY",
        "closeTime": {
          "hours": 0,
          "minutes": 0
        }
      }
    ]
  },
  "specialHours": {
    "specialHourPeriods": [
      {
        "startDate": {
          "year": 1,
          "month": 1,
          "day": 1
        },
        "endDate": {
          "year": 1,
          "month": 1,
          "day": 1
        },
        "openTime": {
          "hours": 0,
          "minutes": 0
        },
        "closeTime": {
          "hours": 0,
          "minutes": 0
        },
        "closed": true
      }
    ]
  },
  "moreHours": [
    {
      "hoursTypeId": "string",
      "periods": [
        {
          "openDay": "MONDAY",
          "openTime": {
            "hours": null,
            "minutes": null
          },
          "closeDay": "MONDAY",
          "closeTime": {
            "hours": null,
            "minutes": null
          }
        }
      ]
    }
  ],
  "availableMoreHoursTypes": [
    {
      "hoursTypeId": "string",
      "displayName": "string",
      "localizedDisplayName": "string"
    }
  ]
}
```

## 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` · MCP tool: `google-business-service-area-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string): Another location this connection manages ("locations/{id}" or "accounts/{a}/locations/{l}")

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/service-area" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "serviceArea": {
    "businessType": "CUSTOMER_LOCATION_ONLY",
    "regionCode": "string",
    "places": {
      "placeInfos": [
        {
          "placeName": "string",
          "placeId": "string"
        }
      ]
    }
  },
  "storefrontAddress": {
    "regionCode": "string",
    "languageCode": "string",
    "postalCode": "string",
    "administrativeArea": "string",
    "locality": "string",
    "sublocality": "string",
    "addressLines": [
      "string"
    ],
    "recipients": [
      "string"
    ],
    "organization": "string"
  }
}
```

## 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` · MCP tool: `google-business-service-area-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `serviceArea` (object; required)
  - `serviceArea.businessType` (string; one of CUSTOMER_LOCATION_ONLY, CUSTOMER_AND_BUSINESS_LOCATION)
  - `serviceArea.regionCode` (string)
  - `serviceArea.places` (object)
    - `serviceArea.places.placeInfos` (array of object; ≤ 20 items)
      - `serviceArea.places.placeInfos[].placeName` (string)
      - `serviceArea.places.placeInfos[].placeId` (string)
- `locationId` (string)

```bash
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:

```json
{
  "id": "string",
  "serviceArea": {
    "businessType": "CUSTOMER_LOCATION_ONLY",
    "regionCode": "string",
    "places": {
      "placeInfos": [
        {
          "placeName": "string",
          "placeId": "string"
        }
      ]
    }
  },
  "storefrontAddress": {
    "regionCode": "string",
    "languageCode": "string",
    "postalCode": "string",
    "administrativeArea": "string",
    "locality": "string",
    "sublocality": "string",
    "addressLines": [
      "string"
    ],
    "recipients": [
      "string"
    ],
    "organization": "string"
  }
}
```

## 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: `read` · MCP tool: `google-business-attributes-list` · Zernio: `GET /v1/accounts/{accountId}/gmb-attributes`, `GET /v1/accounts/{accountId}/gmb-attribute-metadata`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string)
- `includeUnset` (boolean): Also list attributes available but not set

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/attributes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "displayName": "string",
      "groupDisplayName": "string",
      "valueType": "BOOL",
      "values": [
        null
      ],
      "repeatedEnumValue": {
        "setValues": [
          "string"
        ],
        "unsetValues": [
          "string"
        ]
      },
      "uriValues": [
        {
          "uri": "https://example.com"
        }
      ],
      "valueMetadata": [
        {
          "value": null,
          "displayName": "string"
        }
      ],
      "repeatable": true,
      "deprecated": true,
      "set": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `google-business-attributes-update` · Zernio: `PUT /v1/accounts/{accountId}/gmb-attributes`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `values` (array of any)
- `repeatedEnumValue` (object)
  - `repeatedEnumValue.setValues` (array of string)
  - `repeatedEnumValue.unsetValues` (array of string)
- `uriValues` (array of string)
- `locationId` (string)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "displayName": "string",
  "groupDisplayName": "string",
  "valueType": "BOOL",
  "values": [
    null
  ],
  "repeatedEnumValue": {
    "setValues": [
      "string"
    ],
    "unsetValues": [
      "string"
    ]
  },
  "uriValues": [
    {
      "uri": "https://example.com"
    }
  ],
  "valueMetadata": [
    {
      "value": null,
      "displayName": "string"
    }
  ],
  "repeatable": true,
  "deprecated": true,
  "set": true
}
```

## 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` · MCP tool: `google-business-attributes-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/attributes/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `google-business-attributes-bulk-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `attributes` (array of object; required)
  - `attributes[].name` (string)
  - `attributes[].values` (array of any)
  - `attributes[].repeatedEnumValue` (object)
  - `attributes[].uriValues` (array of any)
- `attributeMask` (array of string)
- `locationId` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `google-business-google-updates-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string): Another location this connection manages ("locations/{id}" or "accounts/{a}/locations/{l}")

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/google-updates" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "location": {
    "title": "string",
    "storeCode": "string",
    "languageCode": "string",
    "categories": {
      "primaryCategory": {
        "name": "string",
        "displayName": "string"
      },
      "additionalCategories": [
        {
          "name": "string",
          "displayName": "string"
        }
      ]
    },
    "phoneNumbers": {
      "primaryPhone": "string",
      "additionalPhones": [
        "string"
      ]
    },
    "websiteUri": "https://example.com",
    "storefrontAddress": {
      "regionCode": "string",
      "languageCode": "string",
      "postalCode": "string",
      "administrativeArea": "string",
      "locality": "string",
      "sublocality": "string",
      "addressLines": [
        "string"
      ],
      "recipients": [
        "string"
      ],
      "organization": "string"
    },
    "latlng": {
      "latitude": 1.5,
      "longitude": 1.5
    },
    "openInfo": {
      "status": "OPEN",
      "canReopen": true,
      "openingDate": {
        "year": 1,
        "month": 1,
        "day": 1
      }
    },
    "profile": {
      "description": "string"
    },
    "labels": [
      "string"
    ],
    "adWordsLocationExtensions": {
      "adPhone": "string"
    }
  },
  "diffMask": "string",
  "pendingMask": "string",
  "diffFields": [
    "string"
  ],
  "pendingFields": [
    "string"
  ]
}
```

## 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: `write` · MCP tool: `google-business-google-updates-accept`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `fields` (array of string): Default: every field in diffMask
- `locationId` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `google-business-google-updates-reject`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `fields` (array of string)
- `locationId` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `google-business-categories-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `search` (string)
- `regionCode` (string)
- `languageCode` (string)
- `view` (string; one of BASIC, FULL)
- `pageSize` (integer; ≤ 100)
- `pageToken` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/categories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "displayName": "string",
      "serviceTypes": [
        {
          "serviceTypeId": "string",
          "displayName": "string"
        }
      ],
      "moreHoursTypes": [
        {
          "hoursTypeId": "string",
          "displayName": "string",
          "localizedDisplayName": "string"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `google-business-categories-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Query parameters

- `regionCode` (string)
- `languageCode` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/categories/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "displayName": "string",
  "serviceTypes": [
    {
      "serviceTypeId": "string",
      "displayName": "string"
    }
  ],
  "moreHoursTypes": [
    {
      "hoursTypeId": "string",
      "displayName": "string",
      "localizedDisplayName": "string"
    }
  ]
}
```

## 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: `write` · MCP tool: `google-business-categories-current-categories`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `locationId` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `google-business-attribute-metadata-list` · Zernio: `GET /v1/accounts/{accountId}/gmb-attribute-metadata`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string)
- `categoryName` (string)
- `regionCode` (string)
- `languageCode` (string)
- `showAll` (boolean)
- `pageSize` (integer)
- `pageToken` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/attribute-metadata" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "parent": "string",
      "displayName": "string",
      "groupDisplayName": "string",
      "valueType": "BOOL",
      "repeatable": true,
      "deprecated": true,
      "valueMetadata": [
        {
          "value": null,
          "displayName": "string"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `google-business-chains-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `chainName` (string; required)
- `pageSize` (integer; ≤ 500)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/chains?chainName=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "chainNames": [
        {
          "displayName": "string",
          "languageCode": "string"
        }
      ],
      "websites": [
        {
          "uri": "https://example.com"
        }
      ],
      "locationCount": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `google-business-chains-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/chains/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "chainNames": [
    {
      "displayName": "string",
      "languageCode": "string"
    }
  ],
  "websites": [
    {
      "uri": "https://example.com"
    }
  ],
  "locationCount": 1
}
```

## 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` · MCP tool: `google-business-google-locations-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `query` (string; required): Business name and address
- `pageSize` (integer; ≤ 10)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/google-locations?query=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "location": {
        "title": "string",
        "storeCode": "string",
        "languageCode": "string",
        "categories": {
          "primaryCategory": {
            "name": null,
            "displayName": null
          },
          "additionalCategories": []
        },
        "phoneNumbers": {
          "primaryPhone": "string",
          "additionalPhones": []
        },
        "websiteUri": "https://example.com"
      },
      "requestAdminRightsUri": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `google-business-posts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string)
- `pageSize` (integer; ≤ 100)
- `pageToken` (string)
- `topicType` (string; one of STANDARD, EVENT, OFFER, ALERT)
- `state` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "topicType": "STANDARD",
      "summary": "string",
      "languageCode": "string",
      "state": "LIVE",
      "searchUrl": "https://example.com",
      "createTime": "2026-10-13T09:00:00.000Z",
      "updateTime": "2026-10-13T09:00:00.000Z",
      "scheduledTime": "2026-10-13T09:00:00.000Z",
      "callToAction": {
        "actionType": "BOOK",
        "url": "https://example.com"
      },
      "event": {
        "title": "string",
        "schedule": {
          "startDate": {
            "year": null,
            "month": null,
            "day": null
          },
          "startTime": {
            "hours": null,
            "minutes": null
          },
          "endDate": {
            "year": null,
            "month": null,
            "day": null
          },
          "endTime": {
            "hours": null,
            "minutes": null
          }
        },
        "recurrenceInfo": {
          "seriesEndTime": "2026-10-13T09:00:00.000Z",
          "dailyPattern": {},
          "weeklyPattern": {
            "daysOfWeek": []
          },
          "monthlyPattern": {
            "dayOfMonth": null,
            "dayOfWeekOccurrence": "FIRST"
          }
        }
      },
      "offer": {
        "couponCode": "string",
        "redeemOnlineUrl": "https://example.com",
        "termsConditions": "string"
      },
      "media": [
        {
          "mediaFormat": "PHOTO",
          "sourceUrl": "https://example.com",
          "googleUrl": "https://example.com"
        }
      ],
      "alertType": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `google-business-posts-create` · Zernio: `POST /v1/posts`, `POST /v1/posts/{postId}/edit`, `POST /v1/posts/{postId}/unpublish`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `summary` (string; ≤ 1500 characters)
- `mediaUrl` (string (uri)): Public photo/video URL (sourceUrl)
- `mediaType` (string; one of image, video)
- `media` (string): Socialit media id (resolved to a public URL)
- `options` (object)
  - `options.topicType` (string; one of STANDARD, EVENT, OFFER): Post type. EVENT needs event; OFFER needs event (validity) and usually offer.
  - `options.locationId` (string): 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.
  - `options.googleAccountId` (string): "accounts/{id}" owning locationId, when it differs from the connection's account.
  - `options.languageCode` (string): BCP 47 language of the post (metadata only, no translation). Default: the location language or "en".
  - `options.callToAction` (object)
    - `options.callToAction.type` (string; one of BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP, CALL): Button type (Zernio name).
    - `options.callToAction.actionType` (string; one of BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP, CALL): Button type (Google name; alias of type).
    - `options.callToAction.url` (string (uri)): HTTPS destination. Required except for CALL (which dials the profile phone).
  - `options.event` (object)
    - `options.event.title` (string): Heading shown in Search/Maps.
    - `options.event.schedule` (object)
      - `options.event.schedule.startDate` (object | string; required): {year, month, day} or "YYYY-MM-DD" (an ISO datetime is also accepted; its time part fills the matching *Time)
        - one of: Option 1 (object)
        - `options.event.schedule.startDate.year` (integer; required)
        - `options.event.schedule.startDate.month` (integer; required; 1–12)
        - `options.event.schedule.startDate.day` (integer; required; 1–31)
        - one of: Option 2 (string)
      - `options.event.schedule.startTime` (object | string): {hours, minutes} (24 h) or "HH:MM"
        - one of: Option 1 (object)
        - `options.event.schedule.startTime.hours` (integer; 0–23)
        - `options.event.schedule.startTime.minutes` (integer; 0–59)
        - one of: Option 2 (string)
      - `options.event.schedule.endDate` (object | string; required): {year, month, day} or "YYYY-MM-DD" (an ISO datetime is also accepted; its time part fills the matching *Time)
        - one of: Option 1 (object)
        - `options.event.schedule.endDate.year` (integer; required)
        - `options.event.schedule.endDate.month` (integer; required; 1–12)
        - `options.event.schedule.endDate.day` (integer; required; 1–31)
        - one of: Option 2 (string)
      - `options.event.schedule.endTime` (object | string): {hours, minutes} (24 h) or "HH:MM"
        - one of: Option 1 (object)
        - `options.event.schedule.endTime.hours` (integer; 0–23)
        - `options.event.schedule.endTime.minutes` (integer; 0–59)
        - one of: Option 2 (string)
    - `options.event.startDateTime` (string (date-time)): Shorthand for schedule.startDate + startTime.
    - `options.event.endDateTime` (string (date-time)): Shorthand for schedule.endDate + endTime.
    - `options.event.recurrenceInfo` (object): Recurring post (2026-04). Exactly one pattern.
      - `options.event.recurrenceInfo.seriesEndTime` (string (date-time))
      - `options.event.recurrenceInfo.dailyPattern` (object)
      - `options.event.recurrenceInfo.weeklyPattern` (object)
        - `options.event.recurrenceInfo.weeklyPattern.daysOfWeek` (array of string)
      - `options.event.recurrenceInfo.monthlyPattern` (object)
        - `options.event.recurrenceInfo.monthlyPattern.dayOfMonth` (integer; 1–31)
        - `options.event.recurrenceInfo.monthlyPattern.dayOfWeekOccurrence` (string; one of FIRST, SECOND, THIRD, FOURTH, LAST)
  - `options.offer` (object)
    - `options.offer.couponCode` (string)
    - `options.offer.redeemOnlineUrl` (string (uri))
    - `options.offer.termsConditions` (string)
  - `options.scheduledTime` (string (date-time)): Google-native scheduling: the post stays SCHEDULED until this time. Socialit normally schedules itself; use this only to hand scheduling to Google.

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "topicType": "STANDARD",
  "summary": "string",
  "languageCode": "string",
  "state": "LIVE",
  "searchUrl": "https://example.com",
  "createTime": "2026-10-13T09:00:00.000Z",
  "updateTime": "2026-10-13T09:00:00.000Z",
  "scheduledTime": "2026-10-13T09:00:00.000Z",
  "callToAction": {
    "actionType": "BOOK",
    "url": "https://example.com"
  },
  "event": {
    "title": "string",
    "schedule": {
      "startDate": {
        "year": 1,
        "month": 1,
        "day": 1
      },
      "startTime": {
        "hours": 0,
        "minutes": 0
      },
      "endDate": {
        "year": 1,
        "month": 1,
        "day": 1
      },
      "endTime": {
        "hours": 0,
        "minutes": 0
      }
    },
    "recurrenceInfo": {
      "seriesEndTime": "2026-10-13T09:00:00.000Z",
      "dailyPattern": {},
      "weeklyPattern": {
        "daysOfWeek": [
          "MONDAY"
        ]
      },
      "monthlyPattern": {
        "dayOfMonth": 1,
        "dayOfWeekOccurrence": "FIRST"
      }
    }
  },
  "offer": {
    "couponCode": "string",
    "redeemOnlineUrl": "https://example.com",
    "termsConditions": "string"
  },
  "media": [
    {
      "mediaFormat": "PHOTO",
      "sourceUrl": "https://example.com",
      "googleUrl": "https://example.com"
    }
  ],
  "alertType": "string"
}
```

## 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` · MCP tool: `google-business-posts-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "topicType": "STANDARD",
  "summary": "string",
  "languageCode": "string",
  "state": "LIVE",
  "searchUrl": "https://example.com",
  "createTime": "2026-10-13T09:00:00.000Z",
  "updateTime": "2026-10-13T09:00:00.000Z",
  "scheduledTime": "2026-10-13T09:00:00.000Z",
  "callToAction": {
    "actionType": "BOOK",
    "url": "https://example.com"
  },
  "event": {
    "title": "string",
    "schedule": {
      "startDate": {
        "year": 1,
        "month": 1,
        "day": 1
      },
      "startTime": {
        "hours": 0,
        "minutes": 0
      },
      "endDate": {
        "year": 1,
        "month": 1,
        "day": 1
      },
      "endTime": {
        "hours": 0,
        "minutes": 0
      }
    },
    "recurrenceInfo": {
      "seriesEndTime": "2026-10-13T09:00:00.000Z",
      "dailyPattern": {},
      "weeklyPattern": {
        "daysOfWeek": [
          "MONDAY"
        ]
      },
      "monthlyPattern": {
        "dayOfMonth": 1,
        "dayOfWeekOccurrence": "FIRST"
      }
    }
  },
  "offer": {
    "couponCode": "string",
    "redeemOnlineUrl": "https://example.com",
    "termsConditions": "string"
  },
  "media": [
    {
      "mediaFormat": "PHOTO",
      "sourceUrl": "https://example.com",
      "googleUrl": "https://example.com"
    }
  ],
  "alertType": "string"
}
```

## 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` · MCP tool: `google-business-posts-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `summary` (string; ≤ 1500 characters)
- `mediaUrl` (string (uri)): Public photo/video URL (sourceUrl)
- `mediaType` (string; one of image, video)
- `media` (string): Socialit media id (resolved to a public URL)
- `options` (object)
  - `options.topicType` (string; one of STANDARD, EVENT, OFFER): Post type. EVENT needs event; OFFER needs event (validity) and usually offer.
  - `options.locationId` (string): 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.
  - `options.googleAccountId` (string): "accounts/{id}" owning locationId, when it differs from the connection's account.
  - `options.languageCode` (string): BCP 47 language of the post (metadata only, no translation). Default: the location language or "en".
  - `options.callToAction` (object)
    - `options.callToAction.type` (string; one of BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP, CALL): Button type (Zernio name).
    - `options.callToAction.actionType` (string; one of BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP, CALL): Button type (Google name; alias of type).
    - `options.callToAction.url` (string (uri)): HTTPS destination. Required except for CALL (which dials the profile phone).
  - `options.event` (object)
    - `options.event.title` (string): Heading shown in Search/Maps.
    - `options.event.schedule` (object)
      - `options.event.schedule.startDate` (object | string; required): {year, month, day} or "YYYY-MM-DD" (an ISO datetime is also accepted; its time part fills the matching *Time)
        - one of: Option 1 (object)
        - `options.event.schedule.startDate.year` (integer; required)
        - `options.event.schedule.startDate.month` (integer; required; 1–12)
        - `options.event.schedule.startDate.day` (integer; required; 1–31)
        - one of: Option 2 (string)
      - `options.event.schedule.startTime` (object | string): {hours, minutes} (24 h) or "HH:MM"
        - one of: Option 1 (object)
        - `options.event.schedule.startTime.hours` (integer; 0–23)
        - `options.event.schedule.startTime.minutes` (integer; 0–59)
        - one of: Option 2 (string)
      - `options.event.schedule.endDate` (object | string; required): {year, month, day} or "YYYY-MM-DD" (an ISO datetime is also accepted; its time part fills the matching *Time)
        - one of: Option 1 (object)
        - `options.event.schedule.endDate.year` (integer; required)
        - `options.event.schedule.endDate.month` (integer; required; 1–12)
        - `options.event.schedule.endDate.day` (integer; required; 1–31)
        - one of: Option 2 (string)
      - `options.event.schedule.endTime` (object | string): {hours, minutes} (24 h) or "HH:MM"
        - one of: Option 1 (object)
        - `options.event.schedule.endTime.hours` (integer; 0–23)
        - `options.event.schedule.endTime.minutes` (integer; 0–59)
        - one of: Option 2 (string)
    - `options.event.startDateTime` (string (date-time)): Shorthand for schedule.startDate + startTime.
    - `options.event.endDateTime` (string (date-time)): Shorthand for schedule.endDate + endTime.
    - `options.event.recurrenceInfo` (object): Recurring post (2026-04). Exactly one pattern.
      - `options.event.recurrenceInfo.seriesEndTime` (string (date-time))
      - `options.event.recurrenceInfo.dailyPattern` (object)
      - `options.event.recurrenceInfo.weeklyPattern` (object)
        - `options.event.recurrenceInfo.weeklyPattern.daysOfWeek` (array of string)
      - `options.event.recurrenceInfo.monthlyPattern` (object)
        - `options.event.recurrenceInfo.monthlyPattern.dayOfMonth` (integer; 1–31)
        - `options.event.recurrenceInfo.monthlyPattern.dayOfWeekOccurrence` (string; one of FIRST, SECOND, THIRD, FOURTH, LAST)
  - `options.offer` (object)
    - `options.offer.couponCode` (string)
    - `options.offer.redeemOnlineUrl` (string (uri))
    - `options.offer.termsConditions` (string)
  - `options.scheduledTime` (string (date-time)): Google-native scheduling: the post stays SCHEDULED until this time. Socialit normally schedules itself; use this only to hand scheduling to Google.

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "topicType": "STANDARD",
  "summary": "string",
  "languageCode": "string",
  "state": "LIVE",
  "searchUrl": "https://example.com",
  "createTime": "2026-10-13T09:00:00.000Z",
  "updateTime": "2026-10-13T09:00:00.000Z",
  "scheduledTime": "2026-10-13T09:00:00.000Z",
  "callToAction": {
    "actionType": "BOOK",
    "url": "https://example.com"
  },
  "event": {
    "title": "string",
    "schedule": {
      "startDate": {
        "year": 1,
        "month": 1,
        "day": 1
      },
      "startTime": {
        "hours": 0,
        "minutes": 0
      },
      "endDate": {
        "year": 1,
        "month": 1,
        "day": 1
      },
      "endTime": {
        "hours": 0,
        "minutes": 0
      }
    },
    "recurrenceInfo": {
      "seriesEndTime": "2026-10-13T09:00:00.000Z",
      "dailyPattern": {},
      "weeklyPattern": {
        "daysOfWeek": [
          "MONDAY"
        ]
      },
      "monthlyPattern": {
        "dayOfMonth": 1,
        "dayOfWeekOccurrence": "FIRST"
      }
    }
  },
  "offer": {
    "couponCode": "string",
    "redeemOnlineUrl": "https://example.com",
    "termsConditions": "string"
  },
  "media": [
    {
      "mediaFormat": "PHOTO",
      "sourceUrl": "https://example.com",
      "googleUrl": "https://example.com"
    }
  ],
  "alertType": "string"
}
```

## 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` · MCP tool: `google-business-posts-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `read` · MCP tool: `google-business-media-list` · Zernio: `GET /v1/accounts/{accountId}/gmb-media`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string)
- `pageSize` (integer; ≤ 2500)
- `pageToken` (string)
- `category` (string; one of COVER, PROFILE, LOGO, EXTERIOR, INTERIOR, PRODUCT, AT_WORK, FOOD_AND_DRINK, MENU, COMMON_AREA, ROOMS, TEAMS, …)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "mediaFormat": "PHOTO",
      "sourceUrl": "https://example.com",
      "googleUrl": "https://example.com",
      "thumbnailUrl": "https://example.com",
      "description": "string",
      "createTime": "2026-10-13T09:00:00.000Z",
      "locationAssociation": {
        "category": "COVER",
        "priceListItemId": "string"
      },
      "dimensions": {
        "widthPixels": 1,
        "heightPixels": 1
      },
      "attribution": {
        "profileName": "string",
        "profilePhotoUrl": "https://example.com",
        "profileUrl": "https://example.com",
        "takedownUrl": "https://example.com"
      }
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `google-business-media-create` · Zernio: `POST /v1/accounts/{accountId}/gmb-media`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `sourceUrl` (string (uri); required)
- `mediaFormat` (string; one of PHOTO, VIDEO)
- `category` (string; one of COVER, PROFILE, LOGO, EXTERIOR, INTERIOR, PRODUCT, AT_WORK, FOOD_AND_DRINK, MENU, COMMON_AREA, ROOMS, TEAMS, …)
- `description` (string)
- `locationId` (string)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "mediaFormat": "PHOTO",
  "sourceUrl": "https://example.com",
  "googleUrl": "https://example.com",
  "thumbnailUrl": "https://example.com",
  "description": "string",
  "createTime": "2026-10-13T09:00:00.000Z",
  "locationAssociation": {
    "category": "COVER",
    "priceListItemId": "string"
  },
  "dimensions": {
    "widthPixels": 1,
    "heightPixels": 1
  },
  "attribution": {
    "profileName": "string",
    "profilePhotoUrl": "https://example.com",
    "profileUrl": "https://example.com",
    "takedownUrl": "https://example.com"
  }
}
```

## 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` · MCP tool: `google-business-media-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/media/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "mediaFormat": "PHOTO",
  "sourceUrl": "https://example.com",
  "googleUrl": "https://example.com",
  "thumbnailUrl": "https://example.com",
  "description": "string",
  "createTime": "2026-10-13T09:00:00.000Z",
  "locationAssociation": {
    "category": "COVER",
    "priceListItemId": "string"
  },
  "dimensions": {
    "widthPixels": 1,
    "heightPixels": 1
  },
  "attribution": {
    "profileName": "string",
    "profilePhotoUrl": "https://example.com",
    "profileUrl": "https://example.com",
    "takedownUrl": "https://example.com"
  }
}
```

## 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` · MCP tool: `google-business-media-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `category` (string; one of COVER, PROFILE, LOGO, EXTERIOR, INTERIOR, PRODUCT, AT_WORK, FOOD_AND_DRINK, MENU, COMMON_AREA, ROOMS, TEAMS, …)
- `description` (string)
- `priceListItemId` (string)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "mediaFormat": "PHOTO",
  "sourceUrl": "https://example.com",
  "googleUrl": "https://example.com",
  "thumbnailUrl": "https://example.com",
  "description": "string",
  "createTime": "2026-10-13T09:00:00.000Z",
  "locationAssociation": {
    "category": "COVER",
    "priceListItemId": "string"
  },
  "dimensions": {
    "widthPixels": 1,
    "heightPixels": 1
  },
  "attribution": {
    "profileName": "string",
    "profilePhotoUrl": "https://example.com",
    "profileUrl": "https://example.com",
    "takedownUrl": "https://example.com"
  }
}
```

## 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: `write` · MCP tool: `google-business-media-delete` · Zernio: `DELETE /v1/accounts/{accountId}/gmb-media`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/media/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `google-business-media-upload-file`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `media` (string; required)
- `category` (string; one of COVER, PROFILE, LOGO, EXTERIOR, INTERIOR, PRODUCT, AT_WORK, FOOD_AND_DRINK, MENU, COMMON_AREA, ROOMS, TEAMS, …)
- `description` (string)
- `locationId` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `google-business-customer-media-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string)
- `pageSize` (integer)
- `pageToken` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/customer-media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "mediaFormat": "PHOTO",
      "sourceUrl": "https://example.com",
      "googleUrl": "https://example.com",
      "thumbnailUrl": "https://example.com",
      "description": "string",
      "createTime": "2026-10-13T09:00:00.000Z",
      "locationAssociation": {
        "category": "COVER",
        "priceListItemId": "string"
      },
      "dimensions": {
        "widthPixels": 1,
        "heightPixels": 1
      },
      "attribution": {
        "profileName": "string",
        "profilePhotoUrl": "https://example.com",
        "profileUrl": "https://example.com",
        "takedownUrl": "https://example.com"
      }
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `google-business-customer-media-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/customer-media/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "mediaFormat": "PHOTO",
  "sourceUrl": "https://example.com",
  "googleUrl": "https://example.com",
  "thumbnailUrl": "https://example.com",
  "description": "string",
  "createTime": "2026-10-13T09:00:00.000Z",
  "locationAssociation": {
    "category": "COVER",
    "priceListItemId": "string"
  },
  "dimensions": {
    "widthPixels": 1,
    "heightPixels": 1
  },
  "attribution": {
    "profileName": "string",
    "profilePhotoUrl": "https://example.com",
    "profileUrl": "https://example.com",
    "takedownUrl": "https://example.com"
  }
}
```

## 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: `read` · MCP tool: `google-business-reviews-list` · Zernio: `GET /v1/accounts/{accountId}/gmb-reviews`, `GET /v1/inbox/reviews`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string)
- `minRating` (integer; 1–5)
- `maxRating` (integer; 1–5)
- `hasReply` (boolean): false = unreplied only
- `sortBy` (string; one of date, rating)
- `sortOrder` (string; one of asc, desc)
- `limit` (integer; 1–200)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/reviews" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "rating": 1,
      "starRating": "ONE",
      "text": "string",
      "text_translated": "string",
      "text_original": "string",
      "author": "string",
      "author_avatar_url": "https://example.com",
      "author_is_anonymous": true,
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "reply": "string",
      "has_reply": true,
      "reply_updated_at": "2026-10-13T09:00:00.000Z",
      "reply_state": "PENDING",
      "reply_policy_violation": {},
      "reply_url": "https://example.com",
      "has_photos": true,
      "photo_count": 1,
      "media": [
        {
          "type": "image",
          "url": "https://example.com",
          "thumbnail_url": "https://example.com"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `google-business-reviews-get` · Zernio: `GET /v1/accounts/{accountId}/gmb-reviews/{reviewId}`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/reviews/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "rating": 1,
  "starRating": "ONE",
  "text": "string",
  "text_translated": "string",
  "text_original": "string",
  "author": "string",
  "author_avatar_url": "https://example.com",
  "author_is_anonymous": true,
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "reply": "string",
  "has_reply": true,
  "reply_updated_at": "2026-10-13T09:00:00.000Z",
  "reply_state": "PENDING",
  "reply_policy_violation": {},
  "reply_url": "https://example.com",
  "has_photos": true,
  "photo_count": 1,
  "media": [
    {
      "type": "image",
      "url": "https://example.com",
      "thumbnail_url": "https://example.com"
    }
  ]
}
```

## 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: `write` · MCP tool: `google-business-reviews-reply` · Zernio: `POST /v1/accounts/{accountId}/gmb-reviews/batch`, `POST /v1/accounts/{accountId}/gmb-reviews/{reviewId}/reply`, `DELETE /v1/accounts/{accountId}/gmb-reviews/{reviewId}/reply`, `POST /v1/inbox/reviews/{reviewId}/reply`, `DELETE /v1/inbox/reviews/{reviewId}/reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `comment` (string; required; ≤ 4096 characters)
- `automated` (boolean): Set by automation / AI flows
- `userOptIn` (boolean): The user opted in to automated replies for this location
- `locationId` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `google-business-reviews-delete-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `locationId` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `google-business-reviews-batch`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `locationNames` (array of string; required; 1–50 items)
- `googleAccountId` (string)
- `pageSize` (integer; ≤ 50)
- `pageToken` (string)
- `orderBy` (string; one of updateTime desc, rating, rating desc)
- `ignoreRatingOnlyReviews` (boolean)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `google-business-performance-list` · Zernio: `GET /v1/analytics/googlebusiness/performance`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string)
- `fromDate` (string (date)): Default: 30 days ago
- `toDate` (string (date)): Default: today (data lags 2-3 days)
- `metrics` (array of string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/performance" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "date": "2026-10-13",
      "BUSINESS_IMPRESSIONS_DESKTOP_MAPS": 1,
      "BUSINESS_IMPRESSIONS_DESKTOP_SEARCH": 1,
      "BUSINESS_IMPRESSIONS_MOBILE_MAPS": 1,
      "BUSINESS_IMPRESSIONS_MOBILE_SEARCH": 1,
      "BUSINESS_DIRECTION_REQUESTS": 1,
      "CALL_CLICKS": 1,
      "WEBSITE_CLICKS": 1,
      "BUSINESS_BOOKINGS": 1,
      "BUSINESS_FOOD_MENU_CLICKS": 1,
      "BUSINESS_CONVERSATIONS": 1,
      "BUSINESS_FOOD_ORDERS": 1,
      "impressions": 1,
      "interactions": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `google-business-search-keywords-list` · Zernio: `GET /v1/analytics/googlebusiness/search-keywords`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string)
- `startMonth` (string): YYYY-MM (default: 3 months ago)
- `endMonth` (string): YYYY-MM (default: last month)
- `pageToken` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/search-keywords" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "keyword": "string",
      "impressions": 1,
      "threshold": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `google-business-metric-breakdown-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string)
- `fromDate` (string (date)): Default: 30 days ago
- `toDate` (string (date)): Default: today (data lags 2-3 days)
- `metric` (string; required; one of 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, BUSINESS_CONVERSATIONS, BUSINESS_FOOD_ORDERS)
- `dayOfWeek` (string; one of MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY)
- `hour` (integer; 0–23)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/metric-breakdown?metric=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "date": "2026-10-13",
      "value": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `google-business-food-menus-get` · Zernio: `GET /v1/accounts/{accountId}/gmb-food-menus`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/food-menus" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "menus": [
    {
      "labels": [
        {
          "displayName": "string",
          "description": "string",
          "languageCode": "string"
        }
      ],
      "sourceUrl": "https://example.com",
      "cuisines": [
        "string"
      ],
      "sections": [
        {
          "labels": [],
          "items": []
        }
      ]
    }
  ]
}
```

## 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: `write` · MCP tool: `google-business-food-menus-update` · Zernio: `PUT /v1/accounts/{accountId}/gmb-food-menus`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `menus` (array of object; required)
  - `menus[].labels` (array of object)
    - `menus[].labels[].displayName` (string; ≤ 140 characters)
    - `menus[].labels[].description` (string; ≤ 1000 characters)
    - `menus[].labels[].languageCode` (string)
  - `menus[].sourceUrl` (string (uri))
  - `menus[].cuisines` (array of string)
  - `menus[].sections` (array of object)
    - `menus[].sections[].labels` (array of object)
      - `menus[].sections[].labels[].displayName` (string; ≤ 140 characters)
      - `menus[].sections[].labels[].description` (string; ≤ 1000 characters)
      - `menus[].sections[].labels[].languageCode` (string)
    - `menus[].sections[].items` (array of object)
      - `menus[].sections[].items[].labels` (array of object)
        - `menus[].sections[].items[].labels[].displayName` (string; ≤ 140 characters)
        - `menus[].sections[].items[].labels[].description` (string; ≤ 1000 characters)
        - `menus[].sections[].items[].labels[].languageCode` (string)
      - `menus[].sections[].items[].attributes` (object)
        - `menus[].sections[].items[].attributes.price` (object)
        - `menus[].sections[].items[].attributes.price.currencyCode` (string; ≤ 3 characters)
        - `menus[].sections[].items[].attributes.price.units` (string)
        - `menus[].sections[].items[].attributes.price.nanos` (integer)
        - `menus[].sections[].items[].attributes.spiciness` (string; one of MILD, MEDIUM, HOT)
        - `menus[].sections[].items[].attributes.allergen` (array of string)
        - `menus[].sections[].items[].attributes.dietaryRestriction` (array of string)
        - `menus[].sections[].items[].attributes.servesNumPeople` (integer; ≥ 1)
        - `menus[].sections[].items[].attributes.preparationMethods` (array of string)
        - `menus[].sections[].items[].attributes.mediaKeys` (array of string)
        - `menus[].sections[].items[].attributes.nutritionFacts` (object)
        - `menus[].sections[].items[].attributes.ingredients` (array of object)
        - `menus[].sections[].items[].attributes.portionSize` (object)
      - `menus[].sections[].items[].options` (array of object)
        - `menus[].sections[].items[].options[].labels` (array of object)
        - `menus[].sections[].items[].options[].labels[].displayName` (string; ≤ 140 characters)
        - `menus[].sections[].items[].options[].labels[].description` (string; ≤ 1000 characters)
        - `menus[].sections[].items[].options[].labels[].languageCode` (string)
        - `menus[].sections[].items[].options[].attributes` (object)
        - `menus[].sections[].items[].options[].attributes.price` (object)
        - `menus[].sections[].items[].options[].attributes.spiciness` (string; one of MILD, MEDIUM, HOT)
        - `menus[].sections[].items[].options[].attributes.allergen` (array of string)
        - `menus[].sections[].items[].options[].attributes.dietaryRestriction` (array of string)
        - `menus[].sections[].items[].options[].attributes.servesNumPeople` (integer; ≥ 1)
        - `menus[].sections[].items[].options[].attributes.preparationMethods` (array of string)
        - `menus[].sections[].items[].options[].attributes.mediaKeys` (array of string)
        - `menus[].sections[].items[].options[].attributes.nutritionFacts` (object)
        - `menus[].sections[].items[].options[].attributes.ingredients` (array of object)
        - `menus[].sections[].items[].options[].attributes.portionSize` (object)
- `updateMask` (string)
- `locationId` (string)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "menus": [
    {
      "labels": [
        {
          "displayName": "string",
          "description": "string",
          "languageCode": "string"
        }
      ],
      "sourceUrl": "https://example.com",
      "cuisines": [
        "string"
      ],
      "sections": [
        {
          "labels": [],
          "items": []
        }
      ]
    }
  ]
}
```

## 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: `read` · MCP tool: `google-business-services-list` · Zernio: `GET /v1/accounts/{accountId}/gmb-services`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/services" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "structuredServiceItem": {
        "serviceTypeId": "string",
        "description": "string"
      },
      "freeFormServiceItem": {
        "category": "string",
        "label": {
          "displayName": "string",
          "description": "string",
          "languageCode": "string"
        }
      },
      "price": {
        "currencyCode": "string",
        "units": "string",
        "nanos": 1
      }
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `google-business-services-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `structuredServiceItem` (object)
  - `structuredServiceItem.serviceTypeId` (string)
  - `structuredServiceItem.description` (string; ≤ 300 characters)
- `freeFormServiceItem` (object)
  - `freeFormServiceItem.category` (string): categories/gcid:…
  - `freeFormServiceItem.label` (object)
    - `freeFormServiceItem.label.displayName` (string; ≤ 140 characters)
    - `freeFormServiceItem.label.description` (string; ≤ 250 characters)
    - `freeFormServiceItem.label.languageCode` (string)
- `price` (object)
  - `price.currencyCode` (string; ≤ 3 characters)
  - `price.units` (string)
  - `price.nanos` (integer)

```bash
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:

```json
{
  "id": "string",
  "structuredServiceItem": {
    "serviceTypeId": "string",
    "description": "string"
  },
  "freeFormServiceItem": {
    "category": "string",
    "label": {
      "displayName": "string",
      "description": "string",
      "languageCode": "string"
    }
  },
  "price": {
    "currencyCode": "string",
    "units": "string",
    "nanos": 1
  }
}
```

## 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: `write` · MCP tool: `google-business-services-update` · Zernio: `PUT /v1/accounts/{accountId}/gmb-services`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `structuredServiceItem` (object)
  - `structuredServiceItem.serviceTypeId` (string)
  - `structuredServiceItem.description` (string; ≤ 300 characters)
- `freeFormServiceItem` (object)
  - `freeFormServiceItem.category` (string): categories/gcid:…
  - `freeFormServiceItem.label` (object)
    - `freeFormServiceItem.label.displayName` (string; ≤ 140 characters)
    - `freeFormServiceItem.label.description` (string; ≤ 250 characters)
    - `freeFormServiceItem.label.languageCode` (string)
- `price` (object)
  - `price.currencyCode` (string; ≤ 3 characters)
  - `price.units` (string)
  - `price.nanos` (integer)

```bash
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:

```json
{
  "id": "string",
  "structuredServiceItem": {
    "serviceTypeId": "string",
    "description": "string"
  },
  "freeFormServiceItem": {
    "category": "string",
    "label": {
      "displayName": "string",
      "description": "string",
      "languageCode": "string"
    }
  },
  "price": {
    "currencyCode": "string",
    "units": "string",
    "nanos": 1
  }
}
```

## 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` · MCP tool: `google-business-services-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/services/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `google-business-services-replace`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `serviceItems` (array of object; required)
  - `serviceItems[].structuredServiceItem` (object)
    - `serviceItems[].structuredServiceItem.serviceTypeId` (string)
    - `serviceItems[].structuredServiceItem.description` (string; ≤ 300 characters)
  - `serviceItems[].freeFormServiceItem` (object)
    - `serviceItems[].freeFormServiceItem.category` (string): categories/gcid:…
    - `serviceItems[].freeFormServiceItem.label` (object)
      - `serviceItems[].freeFormServiceItem.label.displayName` (string; ≤ 140 characters)
      - `serviceItems[].freeFormServiceItem.label.description` (string; ≤ 250 characters)
      - `serviceItems[].freeFormServiceItem.label.languageCode` (string)
  - `serviceItems[].price` (object)
    - `serviceItems[].price.currencyCode` (string; ≤ 3 characters)
    - `serviceItems[].price.units` (string)
    - `serviceItems[].price.nanos` (integer)
- `locationId` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Google Business Profile: List Action links

`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: `read` · MCP tool: `google-business-place-action-links-list` · Zernio: `GET /v1/accounts/{accountId}/gmb-place-actions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string)
- `placeActionType` (string; one of APPOINTMENT, ONLINE_APPOINTMENT, DINING_RESERVATION, FOOD_ORDERING, FOOD_DELIVERY, FOOD_TAKEOUT, SHOP_ONLINE, SOLOPRENEUR_APPOINTMENT)
- `pageSize` (integer)
- `pageToken` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/place-action-links" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "uri": "https://example.com",
      "placeActionType": "APPOINTMENT",
      "isPreferred": true,
      "isEditable": true,
      "providerType": "MERCHANT",
      "createTime": "2026-10-13T09:00:00.000Z",
      "updateTime": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Google Business Profile: Create a Action links item

`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: `write` · MCP tool: `google-business-place-action-links-create` · Zernio: `POST /v1/accounts/{accountId}/gmb-place-actions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `uri` (string (uri); required)
- `placeActionType` (string; required; one of APPOINTMENT, ONLINE_APPOINTMENT, DINING_RESERVATION, FOOD_ORDERING, FOOD_DELIVERY, FOOD_TAKEOUT, SHOP_ONLINE, SOLOPRENEUR_APPOINTMENT)
- `isPreferred` (boolean)
- `locationId` (string)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "uri": "https://example.com",
  "placeActionType": "APPOINTMENT",
  "isPreferred": true,
  "isEditable": true,
  "providerType": "MERCHANT",
  "createTime": "2026-10-13T09:00:00.000Z",
  "updateTime": "2026-10-13T09:00:00.000Z"
}
```

## Google Business Profile: Get a Action links item

`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` · MCP tool: `google-business-place-action-links-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/place-action-links/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "uri": "https://example.com",
  "placeActionType": "APPOINTMENT",
  "isPreferred": true,
  "isEditable": true,
  "providerType": "MERCHANT",
  "createTime": "2026-10-13T09:00:00.000Z",
  "updateTime": "2026-10-13T09:00:00.000Z"
}
```

## Google Business Profile: Update a Action links item

`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: `write` · MCP tool: `google-business-place-action-links-update` · Zernio: `PATCH /v1/accounts/{accountId}/gmb-place-actions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `uri` (string (uri))
- `placeActionType` (string; one of APPOINTMENT, ONLINE_APPOINTMENT, DINING_RESERVATION, FOOD_ORDERING, FOOD_DELIVERY, FOOD_TAKEOUT, SHOP_ONLINE, SOLOPRENEUR_APPOINTMENT)
- `isPreferred` (boolean)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "uri": "https://example.com",
  "placeActionType": "APPOINTMENT",
  "isPreferred": true,
  "isEditable": true,
  "providerType": "MERCHANT",
  "createTime": "2026-10-13T09:00:00.000Z",
  "updateTime": "2026-10-13T09:00:00.000Z"
}
```

## Google Business Profile: Delete a Action links item

`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: `write` · MCP tool: `google-business-place-action-links-delete` · Zernio: `DELETE /v1/accounts/{accountId}/gmb-place-actions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
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:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `google-business-place-action-types-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string)
- `regionCode` (string)
- `languageCode` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/place-action-types" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "placeActionType": "APPOINTMENT",
      "displayName": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `google-business-lodging-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string)
- `readMask` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/lodging" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "property": {},
  "services": {},
  "policies": {},
  "foodAndDrink": {},
  "pools": {},
  "wellness": {},
  "activities": {},
  "transportation": {},
  "families": {},
  "connectivity": {},
  "business": {},
  "accessibility": {},
  "housekeeping": {},
  "healthAndSafety": {},
  "parking": {},
  "pets": {},
  "sustainability": {},
  "commonLivingArea": {},
  "guestUnits": [
    {}
  ],
  "allUnits": {},
  "someUnits": {},
  "metadata": {
    "updateTime": "2026-10-13T09:00:00.000Z"
  },
  "name": "string",
  "id": "string"
}
```

## 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` · MCP tool: `google-business-lodging-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `lodging` (object; required)
- `updateMask` (string)
- `locationId` (string)

```bash
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:

```json
{
  "property": {},
  "services": {},
  "policies": {},
  "foodAndDrink": {},
  "pools": {},
  "wellness": {},
  "activities": {},
  "transportation": {},
  "families": {},
  "connectivity": {},
  "business": {},
  "accessibility": {},
  "housekeeping": {},
  "healthAndSafety": {},
  "parking": {},
  "pets": {},
  "sustainability": {},
  "commonLivingArea": {},
  "guestUnits": [
    {}
  ],
  "allUnits": {},
  "someUnits": {},
  "metadata": {
    "updateTime": "2026-10-13T09:00:00.000Z"
  },
  "name": "string",
  "id": "string"
}
```

## 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: `write` · MCP tool: `google-business-lodging-google-updated`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `locationId` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `google-business-verifications-list` · Zernio: `GET /v1/accounts/{accountId}/gmb-verifications`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string)
- `pageSize` (integer)
- `pageToken` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/verifications" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "method": "ADDRESS",
      "state": "PENDING",
      "createTime": "2026-10-13T09:00:00.000Z",
      "announcement": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `google-business-verifications-create` · Zernio: `POST /v1/accounts/{accountId}/gmb-verifications/options`, `POST /v1/accounts/{accountId}/gmb-verifications`, `POST /v1/accounts/{accountId}/gmb-verifications/{verificationId}/complete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `method` (string; required; one of ADDRESS, EMAIL, PHONE_CALL, SMS, AUTO, TRUSTED_PARTNER)
- `languageCode` (string)
- `phoneNumber` (string): PHONE_CALL / SMS
- `emailAddress` (string): EMAIL
- `mailerContact` (string): ADDRESS: name on the postcard
- `trustedPartnerToken` (string)
- `context` (object)
  - `context.address` (object)
    - `context.address.regionCode` (string; ≤ 2 characters): ISO 3166-1 alpha-2 country
    - `context.address.languageCode` (string)
    - `context.address.postalCode` (string)
    - `context.address.administrativeArea` (string): State / province
    - `context.address.locality` (string): City / town
    - `context.address.sublocality` (string)
    - `context.address.addressLines` (array of string; ≤ 5 items)
    - `context.address.recipients` (array of string)
    - `context.address.organization` (string)
- `locationId` (string)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "method": "ADDRESS",
  "state": "PENDING",
  "createTime": "2026-10-13T09:00:00.000Z",
  "announcement": "string"
}
```

## 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: `write` · MCP tool: `google-business-verifications-options`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `languageCode` (string)
- `context` (object)
  - `context.address` (object)
    - `context.address.regionCode` (string; ≤ 2 characters): ISO 3166-1 alpha-2 country
    - `context.address.languageCode` (string)
    - `context.address.postalCode` (string)
    - `context.address.administrativeArea` (string): State / province
    - `context.address.locality` (string): City / town
    - `context.address.sublocality` (string)
    - `context.address.addressLines` (array of string; ≤ 5 items)
    - `context.address.recipients` (array of string)
    - `context.address.organization` (string)
- `locationId` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `google-business-verifications-complete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `pin` (string; required)
- `locationId` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `google-business-voice-of-merchant-get` · Zernio: `GET /v1/accounts/{accountId}/gmb-verifications`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/voice-of-merchant" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "hasVoiceOfMerchant": true,
  "hasBusinessAuthority": true,
  "waitForVoiceOfMerchant": {},
  "verify": {
    "hasPendingVerification": true
  },
  "resolveOwnershipConflict": {},
  "complyWithGuidelines": {
    "recommendationReason": "BUSINESS_LOCATION_SUSPENDED"
  },
  "summary": {
    "status": "live",
    "canEdit": true,
    "message": "string"
  }
}
```

## 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` · MCP tool: `google-business-accounts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `type` (string; one of PERSONAL, LOCATION_GROUP, USER_GROUP, ORGANIZATION)
- `parentAccount` (string)
- `pageSize` (integer; ≤ 20)
- `pageToken` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "accountName": "string",
      "type": "PERSONAL",
      "role": "PRIMARY_OWNER",
      "verificationState": "VERIFIED",
      "vettedState": "NOT_VETTED",
      "permissionLevel": "OWNER_LEVEL",
      "accountNumber": "string",
      "primaryOwner": "string",
      "organizationInfo": {
        "registeredDomain": "string",
        "phoneNumber": "string",
        "address": {
          "regionCode": "string",
          "languageCode": "string",
          "postalCode": "string",
          "administrativeArea": "string",
          "locality": "string",
          "sublocality": "string"
        }
      }
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `google-business-accounts-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `accountName` (string; required)
- `primaryOwner` (string): accounts/{id} of the owner

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "accountName": "string",
  "type": "PERSONAL",
  "role": "PRIMARY_OWNER",
  "verificationState": "VERIFIED",
  "vettedState": "NOT_VETTED",
  "permissionLevel": "OWNER_LEVEL",
  "accountNumber": "string",
  "primaryOwner": "string",
  "organizationInfo": {
    "registeredDomain": "string",
    "phoneNumber": "string",
    "address": {
      "regionCode": "string",
      "languageCode": "string",
      "postalCode": "string",
      "administrativeArea": "string",
      "locality": "string",
      "sublocality": "string",
      "addressLines": [
        "string"
      ],
      "recipients": [
        "string"
      ],
      "organization": "string"
    }
  }
}
```

## 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` · MCP tool: `google-business-accounts-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/accounts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "accountName": "string",
  "type": "PERSONAL",
  "role": "PRIMARY_OWNER",
  "verificationState": "VERIFIED",
  "vettedState": "NOT_VETTED",
  "permissionLevel": "OWNER_LEVEL",
  "accountNumber": "string",
  "primaryOwner": "string",
  "organizationInfo": {
    "registeredDomain": "string",
    "phoneNumber": "string",
    "address": {
      "regionCode": "string",
      "languageCode": "string",
      "postalCode": "string",
      "administrativeArea": "string",
      "locality": "string",
      "sublocality": "string",
      "addressLines": [
        "string"
      ],
      "recipients": [
        "string"
      ],
      "organization": "string"
    }
  }
}
```

## 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` · MCP tool: `google-business-accounts-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `accountName` (string; required)
- `validateOnly` (boolean)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "accountName": "string",
  "type": "PERSONAL",
  "role": "PRIMARY_OWNER",
  "verificationState": "VERIFIED",
  "vettedState": "NOT_VETTED",
  "permissionLevel": "OWNER_LEVEL",
  "accountNumber": "string",
  "primaryOwner": "string",
  "organizationInfo": {
    "registeredDomain": "string",
    "phoneNumber": "string",
    "address": {
      "regionCode": "string",
      "languageCode": "string",
      "postalCode": "string",
      "administrativeArea": "string",
      "locality": "string",
      "sublocality": "string",
      "addressLines": [
        "string"
      ],
      "recipients": [
        "string"
      ],
      "organization": "string"
    }
  }
}
```

## 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` · MCP tool: `google-business-account-admins-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `googleAccountId` (string): Default: the connection's account

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/account-admins" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "admin": "string",
      "account": "string",
      "role": "PRIMARY_OWNER",
      "pendingInvitation": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `google-business-account-admins-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `email` (string (email); required)
- `role` (string; required; one of OWNER, MANAGER)
- `googleAccountId` (string)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "admin": "string",
  "account": "string",
  "role": "PRIMARY_OWNER",
  "pendingInvitation": true
}
```

## 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` · MCP tool: `google-business-account-admins-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `role` (string; required; one of PRIMARY_OWNER, OWNER, MANAGER, SITE_MANAGER)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "admin": "string",
  "account": "string",
  "role": "PRIMARY_OWNER",
  "pendingInvitation": true
}
```

## 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` · MCP tool: `google-business-account-admins-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
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:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `google-business-location-admins-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `locationId` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/location-admins" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "admin": "string",
      "account": "string",
      "role": "PRIMARY_OWNER",
      "pendingInvitation": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `google-business-location-admins-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `email` (string (email); required)
- `role` (string; required; one of OWNER, MANAGER, SITE_MANAGER)
- `locationId` (string)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "admin": "string",
  "account": "string",
  "role": "PRIMARY_OWNER",
  "pendingInvitation": true
}
```

## 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` · MCP tool: `google-business-location-admins-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `role` (string; required; one of PRIMARY_OWNER, OWNER, MANAGER, SITE_MANAGER)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "admin": "string",
  "account": "string",
  "role": "PRIMARY_OWNER",
  "pendingInvitation": true
}
```

## 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` · MCP tool: `google-business-location-admins-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
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:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `google-business-invitations-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `googleAccountId` (string)
- `targetType` (string; one of ACCOUNTS_ONLY, LOCATIONS_ONLY)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/invitations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "role": "PRIMARY_OWNER",
      "targetType": "ACCOUNTS_ONLY",
      "targetAccount": {
        "id": "string",
        "name": "string",
        "accountName": "string",
        "type": "PERSONAL",
        "role": "PRIMARY_OWNER",
        "verificationState": "VERIFIED"
      },
      "targetLocation": {
        "locationName": "string",
        "address": "string",
        "placeId": "string"
      }
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `google-business-invitations-accept`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `google-business-invitations-decline`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `google-business-notification-settings-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `googleAccountId` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/google-business/notification-settings" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "name": "string",
  "pubsubTopic": "string",
  "notificationTypes": [
    "GOOGLE_UPDATE"
  ]
}
```

## 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` · MCP tool: `google-business-notification-settings-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `pubsubTopic` (string)
- `notificationTypes` (array of string)
- `googleAccountId` (string)

```bash
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:

```json
{
  "name": "string",
  "pubsubTopic": "string",
  "notificationTypes": [
    "GOOGLE_UPDATE"
  ]
}
```

## 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: `write` · MCP tool: `google-business-notification-settings-subscribe`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `googleAccountId` (string)
- `pubsubTopic` (string)
- `notificationTypes` (array of string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `google-business-notification-settings-disable`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `googleAccountId` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```


---

Source: https://socialit.com/docs/api-reference/focus-google-business-profile/
