---
title: "ContractAssignmentChangeUpdatedData"
url: "https://developer.agentsync.io/apis/contracting-hierarchies-api/versions/40f58935-396e-4da4-8f47-1587041e1b16/schemas/ContractAssignmentChangeUpdatedData"
---

> Full API specification: https://developer.agentsync.io/apis/contracting-hierarchies-api/versions/40f58935-396e-4da4-8f47-1587041e1b16.md

# ContractAssignmentChangeUpdatedData

Payload for the `contract.assignment_change.updated` event.

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: AgentSync Contracting & Hierarchies API
  version: v1.7.6
servers:
  - url: https://api.sandbox.agentsync.io/contracting
    description: Sandbox
  - url: https://api.agentsync.io/contracting
    description: Production
components:
  schemas:
    UplineContractAssignmentChangeEventData:
      title: UplineContractAssignmentChangeEventData
      type: object
      description: Curated, single-level identity of a contract assignment change's
        upline change. The upline is part of the recipient's own hierarchy;
        firmName/personName may be null.
      properties:
        id:
          type: string
          format: uuid
          description: The unique identifier of the upline contract assignment change.
          example: cc0e8400-e29b-41d4-a716-446655440008
        displayNumber:
          type:
            - string
            - "null"
          description: The display number of the upline contract assignment change.
          example: CAC-00009
        firmName:
          type:
            - string
            - "null"
          description: The firm name of the upline contract assignment change.
          example: Upline Agency LLC
        personName:
          type:
            - string
            - "null"
          description: The person name of the upline contract assignment change.
          example: Jane Doe
    ContractAssignmentChangeUpdatedData:
      title: ContractAssignmentChangeUpdatedData
      type: object
      description: Payload for the `contract.assignment_change.updated` event.
      required:
        - contractAssignmentChangeId
        - contractAssignmentId
        - agencyOrganizationId
        - agencyOrganizationName
        - carrierOrganizationId
        - carrierOrganizationName
        - productId
        - productName
        - personId
        - states
        - contractPacketId
        - taskTypeName
        - referralCodes
        - contractAssignmentChangeDisplayNumber
      properties:
        contractAssignmentChangeId:
          type: string
          format: uuid
          description: The unique identifier of the contract assignment change.
          example: 550e8400-e29b-41d4-a716-446655440000
        contractAssignmentId:
          type: string
          format: uuid
          description: The unique identifier of the contract assignment associated with
            this change.
          example: 660e8400-e29b-41d4-a716-446655440001
        contractId:
          type:
            - string
            - "null"
          format: uuid
          description: The unique identifier of the contract the assignment belongs to.
          example: 110e8400-e29b-41d4-a716-446655440009
        agencyOrganizationId:
          type: string
          format: uuid
          description: The unique identifier of the agency organization which the contract
            is sent from.
          example: 770e8400-e29b-41d4-a716-446655440002
        agencyOrganizationName:
          type: string
          description: The name of the agency organization which the contract is sent from.
          example: Acme Insurance Agency
        carrierOrganizationId:
          type: string
          format: uuid
          description: The unique identifier of the carrier organization which the
            contract is sent to.
          example: 880e8400-e29b-41d4-a716-446655440003
        carrierOrganizationName:
          type: string
          description: The name of the carrier organization which the contract is sent to.
          example: Big Carrier Inc.
        productId:
          type: string
          format: uuid
          description: The unique identifier of the carrier product assigned to this
            contract change with the agency.
          example: aa0e8400-e29b-41d4-a716-446655440005
        productName:
          type: string
          description: The name of the carrier product assigned to this contract change
            with the agency.
          example: Term Life
        personId:
          type: string
          format: uuid
          description: The unique identifier of the individual producer which the contract
            assignment change is for.
          example: 990e8400-e29b-41d4-a716-446655440004
        personNpn:
          type:
            - string
            - "null"
          description: The National Producer Number of the individual producer.
          example: "1234567"
        firmId:
          type:
            - string
            - "null"
          format: uuid
          description: The unique identifier of the firm which the contract assignment
            change is for.
          example: null
        firmNpn:
          type:
            - string
            - "null"
          description: The National Producer Number of the firm.
          example: null
        states:
          type: array
          items:
            type: string
          description: The list of states associated with the contract assignment change.
          example:
            - CA
        newAnnualization:
          type:
            - number
            - "null"
          description: The decimal value of the new annualization associated with this
            change.
          example: null
        newAssignmentStatusName:
          type:
            - string
            - "null"
          description: The name of the new assignment status associated with this change.
          example: Active
        newCommissionLevelId:
          type:
            - string
            - "null"
          format: uuid
          description: The unique identifier of the new commission level associated with
            this change.
          example: null
        newCommissionLevelName:
          type:
            - string
            - "null"
          description: The name of the new commission level associated with this change.
          example: null
        newUplineContractAssignmentId:
          type:
            - string
            - "null"
          format: uuid
          description: The unique identifier of the new upline contract assignment
            associated with this change.
          example: null
        newUplineNpn:
          type:
            - string
            - "null"
          description: The National Producer Number of the new upline producer associated
            with this change.
          example: null
        uplineContractAssignmentChangeId:
          type:
            - string
            - "null"
          format: uuid
          description: The unique identifier of the upline contract assignment change
            associated with this change.
          example: null
        uplineContractAssignmentChangeDisplayNumber:
          type:
            - string
            - "null"
          description: The display number of the upline contract assignment associated
            with this change.
          example: null
        responsibleUplineFirmNpn:
          type:
            - string
            - "null"
          description: The National Producer Number of the upline firm responsible for
            this contract assignment.
          example: null
        uplineContractAssignmentChange:
          oneOf:
            - $ref: "#/components/schemas/UplineContractAssignmentChangeEventData"
            - type: "null"
          description: The upline contract assignment change for this change, if any.
        contractPacketId:
          type: string
          format: uuid
          description: The unique identifier of the contract packet associated with this
            change.
          example: bb0e8400-e29b-41d4-a716-446655440006
        taskTypeName:
          type: string
          description: The name of the task type intended by this change.
          example: New Business
        referralCodes:
          type: array
          items:
            type: string
          description: The list of referral codes used by the agency admin to assign the
            contract assignment change if it is for portal/carrier website
            submission.
          example: []
        title:
          type:
            - string
            - "null"
          description: The title/name of the contract assignment change.
          example: null
        effectiveDate:
          type:
            - string
            - "null"
          format: date
          description: "The effective date of the contract assignment change. Format:
            yyyy-MM-dd"
          example: null
        expirationDate:
          type:
            - string
            - "null"
          format: date
          description: "The expiration date of the contract assignment change. Format:
            yyyy-MM-dd"
          example: null
        contractAssignmentChangeDisplayNumber:
          type: string
          description: The display number of the contract assignment change.
          example: CAC-00001
        writingNumber:
          type:
            - string
            - "null"
          description: The writing number of the contract assignment associated with this
            change.
          example: WN-12345
        createdAt:
          type:
            - string
            - "null"
          format: date-time
          description: "The date and time the contract assignment change was created.
            Format: RFC3339 UTC."
          example: 2024-06-18T09:15:00Z
        updatedAt:
          type:
            - string
            - "null"
          format: date-time
          description: "The date and time the contract assignment change was last updated.
            Format: RFC3339 UTC."
          example: 2024-06-20T14:45:00Z
        externalNotes:
          type:
            - string
            - "null"
          description: The external notes of the contract assignment change.
          example: null
        uplineFirmId:
          type:
            - string
            - "null"
          format: uuid
          description: The unique identifier of the upline firm associated with this change.
          example: null
        uplineFirmNpn:
          type:
            - string
            - "null"
          description: The National Producer Number of the upline firm associated with
            this change.
          example: null
        uplineWritingNumber:
          type:
            - string
            - "null"
          description: The writing number of the upline contract assignment associated
            with this change.
          example: null
        userDefined1:
          type:
            - string
            - "null"
          description: A user defined field of the contract assignment change.
        userDefined2:
          type:
            - string
            - "null"
          description: A user defined field of the contract assignment change.
        userDefined3:
          type:
            - string
            - "null"
          description: A user defined field of the contract assignment change.
        userDefined4:
          type:
            - string
            - "null"
          description: A user defined field of the contract assignment change.
        userDefined5:
          type:
            - string
            - "null"
          description: A user defined field of the contract assignment change.
        userDefined6:
          type:
            - string
            - "null"
          description: A user defined field of the contract assignment change.
        userDefined7:
          type:
            - string
            - "null"
          description: A user defined field of the contract assignment change.
        userDefined8:
          type:
            - string
            - "null"
          description: A user defined field of the contract assignment change.
        userDefined9:
          type:
            - string
            - "null"
          description: A user defined field of the contract assignment change.
        userDefined10:
          type:
            - string
            - "null"
          description: A user defined field of the contract assignment change.
```