> 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 Engagement Type Object

### Description

The `Engagement Type` object is used to represent an interaction activity. A given `Engagement` typically has an `Engagement Type` object represented in the engagement\_type field.

### The EngagementType Object

```json
{
  "id": "string",
  "remote_id": "string",
  "created_at": "2023-01-01T00:00:00Z",
  "modified_at": "2023-01-01T00:00:00Z",
  "activity_type": "CALL",
  "name": "string",
  "remote_fields": [
    {
      "remote_field_class": {
        "id": "string",
        "display_name": "string",
        "remote_key_name": "string",
        "description": "string",
        "is_custom": true,
        "is_common_model_field": true,
        "is_required": true,
        "field_type": "string",
        "field_format": "string",
        "field_choices": [
          "string"
        ],
        "item_schema": {
          "item_type": "string",
          "item_format": "string",
          "item_choices": [
            "string"
          ]
        }
      },
      "value": {
        "string": {}
      }
    }
  ]
}
```

### Schema (`EngagementType`)

```yaml
components:
  schemas:
    ActivityTypeEnum:
      type: string
      enum:
        - CALL
        - MEETING
        - EMAIL
      title: ActivityTypeEnum
    FieldTypeEnum:
      type: string
      enum:
        - string
        - number
        - date
        - datetime
        - bool
        - list
      title: FieldTypeEnum
    FieldFormatEnum:
      type: string
      enum:
        - string
        - number
        - date
        - datetime
        - bool
        - list
      title: FieldFormatEnum
    ItemTypeEnum:
      type: string
      enum:
        - string
        - number
        - date
        - datetime
        - bool
        - list
      title: ItemTypeEnum
    ItemFormatEnum:
      type: string
      enum:
        - string
        - number
        - date
        - datetime
        - bool
        - list
      title: ItemFormatEnum
    ItemSchema:
      type: object
      properties:
        item_type:
          $ref: '#/components/schemas/ItemTypeEnum'
        item_format:
          $ref: '#/components/schemas/ItemFormatEnum'
        item_choices:
          type: array
          items:
            type: string
      title: ItemSchema
    RemoteFieldClass:
      type: object
      properties:
        id:
          type: string
        display_name:
          type: string
        remote_key_name:
          type: string
        description:
          type: string
        is_custom:
          type: boolean
        is_common_model_field:
          type: boolean
        is_required:
          type: boolean
        field_type:
          $ref: '#/components/schemas/FieldTypeEnum'
        field_format:
          $ref: '#/components/schemas/FieldFormatEnum'
        field_choices:
          type: array
          items:
            type: string
        item_schema:
          $ref: '#/components/schemas/ItemSchema'
      title: RemoteFieldClass
    RemoteField:
      type: object
      properties:
        remote_field_class:
          $ref: '#/components/schemas/RemoteFieldClass'
        value:
          type: object
          additionalProperties:
            description: Any type
      required:
        - remote_field_class
      title: RemoteField
    EngagementType:
      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.
        activity_type:
          oneOf:
            - $ref: '#/components/schemas/ActivityTypeEnum'
            - type: 'null'
          description: The engagement type's activity type.
        name:
          type:
            - string
            - 'null'
          description: The engagement type's name.
        remote_fields:
          type: array
          items:
            $ref: '#/components/schemas/RemoteField'
      title: EngagementType
```