> This page is for Unified.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

The `Group` object is used to represent any subset of employees across, for example, `DEPARTMENT` or `TEAM`. Employees can be in multiple Groups.

### The Group Object

```json
{
  "id": "string",
  "remote_id": "string",
  "created_at": "2023-01-01T00:00:00Z",
  "modified_at": "2023-01-01T00:00:00Z",
  "parent_group": "string",
  "name": "string",
  "type": "TEAM",
  "is_commonly_used_as_team": true,
  "group_url": "string",
  "remote_was_deleted": true,
  "field_mappings": {
    "organization_defined_targets": {
      "string": {}
    },
    "linked_account_defined_targets": {
      "string": {}
    }
  },
  "remote_data": [
    {
      "path": "string",
      "data": {}
    }
  ]
}
```

### Schema (`Group`)

```yaml
components:
  schemas:
    GroupTypeEnum:
      type: string
      enum:
        - TEAM
        - DEPARTMENT
        - COST_CENTER
        - BUSINESS_UNIT
        - GROUP
      title: GroupTypeEnum
    GroupFieldMappings:
      type: object
      properties:
        organization_defined_targets:
          type: object
          additionalProperties:
            description: Any type
        linked_account_defined_targets:
          type: object
          additionalProperties:
            description: Any type
      title: GroupFieldMappings
    RemoteData:
      type: object
      properties:
        path:
          type: string
          description: The third-party API path that is being called.
        data:
          description: >-
            The data returned from the third-party for this object in its
            original, unnormalized format.
      required:
        - path
      description: >-
        # The RemoteData Object

        ### Description

        The `RemoteData` object is used to represent the full data pulled from
        the third-party API for an object.


        ### Usage Example

        TODO
      title: RemoteData
    Group:
      type: object
      properties:
        id:
          type: string
          format: uuid
        remote_id:
          type:
            - string
            - 'null'
          description: The third-party API ID of the matching object.
        created_at:
          type: string
          format: date-time
          description: The datetime that this object was created by Merge.
        modified_at:
          type: string
          format: date-time
          description: The datetime that this object was modified by Merge.
        parent_group:
          type:
            - string
            - 'null'
          format: uuid
          description: The parent group for this group.
        name:
          type:
            - string
            - 'null'
          description: The group name.
        type:
          oneOf:
            - $ref: '#/components/schemas/GroupTypeEnum'
            - type: 'null'
          description: >-
            The Group type returned directly from the third-party. This field is
            an open enum: Merge can return a value outside this list when an
            integration provides one it does not map. Pass
            `show_enum_origins=type` to receive the integration's own value
            instead.
        is_commonly_used_as_team:
          type:
            - boolean
            - 'null'
          description: >-
            Indicates whether the Group refers to a team in the third party
            platform. Note that this is an opinionated view based on how Merge
            observes most organizations representing teams in each third party
            platform. If your customer uses a platform different from most,
            there is a chance this will not be correct.
        group_url:
          type:
            - string
            - 'null'
          format: uri
          maxLength: 2000
          description: The 3rd party URL of the group.
        remote_was_deleted:
          type: boolean
          description: >-
            Indicates whether or not this object has been deleted in the third
            party platform. Full coverage deletion detection is a premium
            add-on. Native deletion detection is offered for free with limited
            coverage. [Learn
            more](https://docs.merge.dev/integrations/hris/supported-features/).
        field_mappings:
          oneOf:
            - $ref: '#/components/schemas/GroupFieldMappings'
            - type: 'null'
        remote_data:
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/RemoteData'
      title: Group
```