---
title: "UpdateGroupBlock"
method: POST
path: "/UpdateGroupBlock"
tags: ["Groups"]
---

# UpdateGroupBlock

`POST /UpdateGroupBlock`

This call is used to update an inventory block for a group on your OTA based on the latest details that we have in Cloudbeds
(eg. related group block name, status, group block inventory, rates, restrictions, notes, release schedule).
This call needs to be activated explicitly from our side before you can use it. Please talk to your Cloudbeds contact before
implementing this call!

## Request body

- object
  - `mya_property_id` integer, required — Property ID on the Cloudbeds channel manager
  - `ota_property_id` string, required — Username, login or property ID on the OTA
  - `ota_property_password` string, required — Password for property on your OTA. In case the OTA does not use passwords this will be an empty string.
  - `ota_property_sub_id` string, required — Property ID on the OTA, if OTA supports multiple properties under one `ota_property_id`/`ota_property_password` combination. See `GetSubProperties` for more details.
  - `guid` string, required — Request reference ID, used for debugging and support requests.
  - `shared_secret` string, required — Authentication between the OTA and the channel. Identical for all requests. Not to be shared with customers.
  - `ota_cid` string, required — OTA ID as given by Cloudbeds
  - `verb` 'UpdateGroupBlock', required
  - `group_block_data` object, required
    - `group_code` string — Group code that was previously passed in CreateGroup call
    - `group_data` Group
      - `group_code` string
      - `group_name` string
      - `group_legal_name` string
      - `group_status` 'open' | 'close'
      - `group_notes` object[]
        - `text` string
        - `created_at` string
        - `updated_at` string
      - `address` object
        - `city` string
        - `zip` string
        - `state` string
        - `address_line1` string
        - `address_line2` string
        - `country_code` string
      - `contacts` object[]
        - `first_name` string
        - `last_name` string
        - `emails` object[]
          - `type` 'personal' | 'business'
          - `value` string
        - `phones` object[]
          - `type` 'home' | 'work' | 'mobile' | 'fax'
          - `value` string
        - `role` string
        - `legal_name` string
        - `city` string
        - `zip` string
        - `state` string
        - `address_line1` string
        - `address_line2` string
        - `country_code` string
    - `group_block_code` string
    - `group_block_name` string
    - `group_block_status` 'tentative' | 'lead' | 'definite'
    - `group_block_notes` object[]
      - `text` string
      - `created_at` string
      - `updated_at` string
    - `group_block_auto_release` object
      - `release_type` 'all_dates' | 'by_day' | 'by_interval'
      - `release_days` integer
      - `release_time` string — HH:MM
    - `group_block_ari` object — Object keyed by OTA room type IDs. Each key is a room type ID on your system.

## Response `200`

UpdateGroupBlock

- ResponseSimple
  - `errors` object[] — Array of error objects. Required when `success` is `false`.
    - `id` integer, required — Error code. Check the "Error Codes" section of the specification for valid codes.
    - `msg` string — Optional error string to give more details about the error. Myallocator localises errors into different languages, so this field is generally ignored and only useful for debugging.
  - `success` true | false, required

---

[API](https://skmtc.net/cloudbeds/apis/cloudbeds-api.md) · [All operations](https://skmtc.net/cloudbeds/apis/cloudbeds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbeds/cloudbeds-api/versions/2faa857793e8/schema)