PUT api/auction/saveauction

Save or update an auction. Processes this auction API request. The parameter and response sections describe the data exchanged with the API.

Request Information

URI Parameters

None.

Body Parameters

The save auction command data contract supplied with the request.

SaveAuctionCommandDataContract
NameDescriptionTypeAdditional information
CutOffDate

The cut off date, expressed as a date and time.

date

None.

Name

The name value.

string

None.

Description

The description value.

string

None.

PropertyId

The unique identifier of the related property resource.

integer

None.

RoleId

The unique identifier of the related role resource.

integer

None.

AppointmentDetail

The appointment detail value.

AppointmentDetailCommandDataContract

None.

EventType

The event type value.

string

None.

ReasonOfCancellation

The reason of cancellation value.

string

None.

OriginalDate

The original date, expressed as a date and time.

date

None.

ExternalAppointmentReference

The external appointment reference value.

string

None.

EditingRecurringOption

The editing recurring option value.

integer

None.

Id

The unique identifier of this resource.

integer

None.

Request Formats

application/x-www-form-urlencoded

Sample:

Sample not available.

application/json, text/json

Sample:
{
  "CutOffDate": "2026-07-23T08:16:27.8465773Z",
  "Name": "sample string 2",
  "Description": "sample string 3",
  "PropertyId": 4,
  "RoleId": 5,
  "AppointmentDetail": {
    "Name": "sample string 1",
    "Description": "sample string 2",
    "AllDayEvent": true,
    "StartDate": "2026-07-23T08:16:27.8465773Z",
    "EndDate": "2026-07-23T08:16:27.8465773Z",
    "EventStatus": {
      "Id": 1,
      "Name": "sample string 2",
      "SystemName": "sample string 3"
    },
    "MeetingPlaceId": 5,
    "TeamId": 6,
    "EventCategory": {
      "Id": 1,
      "Name": "sample string 2",
      "SystemName": "sample string 3"
    },
    "EventType": {
      "Id": 1,
      "Name": "sample string 2",
      "SystemName": "sample string 3"
    },
    "NegotiatorIds": [
      1,
      2
    ],
    "AttendingGroups": [
      {
        "Type": {
          "Id": 1,
          "Name": "sample string 2",
          "SystemName": "sample string 3"
        },
        "Group": {
          "Name": "sample string 1",
          "Description": "sample string 2",
          "Members": [
            {
              "Person": {
                "PersonId": 1,
                "Gender": {
                  "Id": 1,
                  "Name": "sample string 2",
                  "SystemName": "sample string 3"
                },
                "Title": "sample string 1",
                "FirstName": "sample string 2",
                "LastName": "sample string 3",
                "Addresses": [
                  {
                    "ContactOrder": 1,
                    "AddressType": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Latitude": 2.1,
                    "Longitude": 3.1,
                    "AddressSource": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "SourceId": "sample string 4",
                    "OrganizationName": "sample string 5",
                    "Number": "sample string 6",
                    "BuildingName": "sample string 7",
                    "Street": "sample string 8",
                    "Town": "sample string 9",
                    "Locality": "sample string 10",
                    "County": "sample string 11",
                    "Country": "sample string 12",
                    "Postcode": "sample string 13",
                    "Uprn": "sample string 14",
                    "CreatedDate": "2026-07-23T08:16:27.8622009Z",
                    "CreatedBy": {
                      "Initials": "sample string 1",
                      "ContactName": "sample string 2",
                      "Gender": {
                        "Id": 1,
                        "Name": "sample string 2",
                        "SystemName": "sample string 3"
                      },
                      "Title": "sample string 3",
                      "FirstName": "sample string 4",
                      "LastName": "sample string 5",
                      "PrimaryTelephone": {
                        "Type": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Value": "sample string 1",
                        "Notes": "sample string 2",
                        "ContactOrder": 3,
                        "AllowContact": true,
                        "MarketingContactStatus": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Name": "sample string 5",
                        "Id": 6
                      },
                      "PrimaryEmail": {
                        "Type": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Value": "sample string 1",
                        "Notes": "sample string 2",
                        "ContactOrder": 3,
                        "AllowContact": true,
                        "MarketingContactStatus": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Name": "sample string 5",
                        "Id": 6
                      },
                      "JobTitle": "sample string 6",
                      "Id": 7
                    },
                    "Id": 16
                  },
                  {
                    "ContactOrder": 1,
                    "AddressType": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Latitude": 2.1,
                    "Longitude": 3.1,
                    "AddressSource": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "SourceId": "sample string 4",
                    "OrganizationName": "sample string 5",
                    "Number": "sample string 6",
                    "BuildingName": "sample string 7",
                    "Street": "sample string 8",
                    "Town": "sample string 9",
                    "Locality": "sample string 10",
                    "County": "sample string 11",
                    "Country": "sample string 12",
                    "Postcode": "sample string 13",
                    "Uprn": "sample string 14",
                    "CreatedDate": "2026-07-23T08:16:27.8622009Z",
                    "CreatedBy": {
                      "Initials": "sample string 1",
                      "ContactName": "sample string 2",
                      "Gender": {
                        "Id": 1,
                        "Name": "sample string 2",
                        "SystemName": "sample string 3"
                      },
                      "Title": "sample string 3",
                      "FirstName": "sample string 4",
                      "LastName": "sample string 5",
                      "PrimaryTelephone": {
                        "Type": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Value": "sample string 1",
                        "Notes": "sample string 2",
                        "ContactOrder": 3,
                        "AllowContact": true,
                        "MarketingContactStatus": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Name": "sample string 5",
                        "Id": 6
                      },
                      "PrimaryEmail": {
                        "Type": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Value": "sample string 1",
                        "Notes": "sample string 2",
                        "ContactOrder": 3,
                        "AllowContact": true,
                        "MarketingContactStatus": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Name": "sample string 5",
                        "Id": 6
                      },
                      "JobTitle": "sample string 6",
                      "Id": 7
                    },
                    "Id": 16
                  }
                ],
                "ContactItems": [
                  {
                    "Id": 1,
                    "Type": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Value": "sample string 2",
                    "Notes": "sample string 3",
                    "ContactOrder": 4,
                    "AllowContact": true,
                    "MarketingContactStatus": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "NormalisedRegionCode": "sample string 5"
                  },
                  {
                    "Id": 1,
                    "Type": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Value": "sample string 2",
                    "Notes": "sample string 3",
                    "ContactOrder": 4,
                    "AllowContact": true,
                    "MarketingContactStatus": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "NormalisedRegionCode": "sample string 5"
                  }
                ],
                "ServiceTypes": [
                  {
                    "Service": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Referral": true
                  },
                  {
                    "Service": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Referral": true
                  }
                ],
                "ExternalApplicantReference": "sample string 4",
                "Id": 5
              },
              "RelationshipType": {
                "Id": 1,
                "Name": "sample string 2",
                "SystemName": "sample string 3"
              },
              "Id": 1
            },
            {
              "Person": {
                "PersonId": 1,
                "Gender": {
                  "Id": 1,
                  "Name": "sample string 2",
                  "SystemName": "sample string 3"
                },
                "Title": "sample string 1",
                "FirstName": "sample string 2",
                "LastName": "sample string 3",
                "Addresses": [
                  {
                    "ContactOrder": 1,
                    "AddressType": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Latitude": 2.1,
                    "Longitude": 3.1,
                    "AddressSource": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "SourceId": "sample string 4",
                    "OrganizationName": "sample string 5",
                    "Number": "sample string 6",
                    "BuildingName": "sample string 7",
                    "Street": "sample string 8",
                    "Town": "sample string 9",
                    "Locality": "sample string 10",
                    "County": "sample string 11",
                    "Country": "sample string 12",
                    "Postcode": "sample string 13",
                    "Uprn": "sample string 14",
                    "CreatedDate": "2026-07-23T08:16:27.8622009Z",
                    "CreatedBy": {
                      "Initials": "sample string 1",
                      "ContactName": "sample string 2",
                      "Gender": {
                        "Id": 1,
                        "Name": "sample string 2",
                        "SystemName": "sample string 3"
                      },
                      "Title": "sample string 3",
                      "FirstName": "sample string 4",
                      "LastName": "sample string 5",
                      "PrimaryTelephone": {
                        "Type": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Value": "sample string 1",
                        "Notes": "sample string 2",
                        "ContactOrder": 3,
                        "AllowContact": true,
                        "MarketingContactStatus": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Name": "sample string 5",
                        "Id": 6
                      },
                      "PrimaryEmail": {
                        "Type": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Value": "sample string 1",
                        "Notes": "sample string 2",
                        "ContactOrder": 3,
                        "AllowContact": true,
                        "MarketingContactStatus": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Name": "sample string 5",
                        "Id": 6
                      },
                      "JobTitle": "sample string 6",
                      "Id": 7
                    },
                    "Id": 16
                  },
                  {
                    "ContactOrder": 1,
                    "AddressType": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Latitude": 2.1,
                    "Longitude": 3.1,
                    "AddressSource": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "SourceId": "sample string 4",
                    "OrganizationName": "sample string 5",
                    "Number": "sample string 6",
                    "BuildingName": "sample string 7",
                    "Street": "sample string 8",
                    "Town": "sample string 9",
                    "Locality": "sample string 10",
                    "County": "sample string 11",
                    "Country": "sample string 12",
                    "Postcode": "sample string 13",
                    "Uprn": "sample string 14",
                    "CreatedDate": "2026-07-23T08:16:27.8622009Z",
                    "CreatedBy": {
                      "Initials": "sample string 1",
                      "ContactName": "sample string 2",
                      "Gender": {
                        "Id": 1,
                        "Name": "sample string 2",
                        "SystemName": "sample string 3"
                      },
                      "Title": "sample string 3",
                      "FirstName": "sample string 4",
                      "LastName": "sample string 5",
                      "PrimaryTelephone": {
                        "Type": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Value": "sample string 1",
                        "Notes": "sample string 2",
                        "ContactOrder": 3,
                        "AllowContact": true,
                        "MarketingContactStatus": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Name": "sample string 5",
                        "Id": 6
                      },
                      "PrimaryEmail": {
                        "Type": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Value": "sample string 1",
                        "Notes": "sample string 2",
                        "ContactOrder": 3,
                        "AllowContact": true,
                        "MarketingContactStatus": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Name": "sample string 5",
                        "Id": 6
                      },
                      "JobTitle": "sample string 6",
                      "Id": 7
                    },
                    "Id": 16
                  }
                ],
                "ContactItems": [
                  {
                    "Id": 1,
                    "Type": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Value": "sample string 2",
                    "Notes": "sample string 3",
                    "ContactOrder": 4,
                    "AllowContact": true,
                    "MarketingContactStatus": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "NormalisedRegionCode": "sample string 5"
                  },
                  {
                    "Id": 1,
                    "Type": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Value": "sample string 2",
                    "Notes": "sample string 3",
                    "ContactOrder": 4,
                    "AllowContact": true,
                    "MarketingContactStatus": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "NormalisedRegionCode": "sample string 5"
                  }
                ],
                "ServiceTypes": [
                  {
                    "Service": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Referral": true
                  },
                  {
                    "Service": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Referral": true
                  }
                ],
                "ExternalApplicantReference": "sample string 4",
                "Id": 5
              },
              "RelationshipType": {
                "Id": 1,
                "Name": "sample string 2",
                "SystemName": "sample string 3"
              },
              "Id": 1
            }
          ],
          "GroupType": {
            "Id": 1,
            "Name": "sample string 2",
            "SystemName": "sample string 3"
          },
          "Origin": {
            "Id": 1,
            "Name": "sample string 2",
            "SystemName": "sample string 3"
          },
          "Grade": {
            "Id": 1,
            "Name": "sample string 2",
            "SystemName": "sample string 3"
          },
          "ExternalProviderTypes": [
            {
              "Id": 1,
              "Name": "sample string 2",
              "SystemName": "sample string 3"
            },
            {
              "Id": 1,
              "Name": "sample string 2",
              "SystemName": "sample string 3"
            }
          ],
          "VATNumber": "sample string 3",
          "AdditionalQuestions": {
            "ArrangedMortgage": true,
            "MortgageProvider": "sample string 1",
            "HowLongToMove": "sample string 2",
            "ReasonForMoving": "sample string 3",
            "HowHeard": "sample string 4",
            "EnquiryMethod": "sample string 5",
            "BestTimeToCall": "sample string 6",
            "WhenCanView": "sample string 7",
            "HappyToReceivePropertyEmails": true,
            "ViewedAnyProperties": true,
            "LocalOwnToSell": true,
            "AskingPrice": "sample string 8",
            "Bedrooms": 1,
            "CurrentlyOnMarket": true,
            "SellingWith": "sample string 9",
            "OnMarketSince": "2026-07-23T08:16:27.8622009Z",
            "ReasonForSale": "sample string 10",
            "OfferedMA": true,
            "CurrentStatus": {
              "Id": 1,
              "Name": "sample string 2",
              "SystemName": "sample string 3"
            },
            "Financial": {
              "Id": 1,
              "Name": "sample string 2",
              "SystemName": "sample string 3"
            },
            "Reason": {
              "Id": 1,
              "Name": "sample string 2",
              "SystemName": "sample string 3"
            }
          },
          "BranchId": 1,
          "Id": 4
        },
        "AttendingPeopleIds": [
          1,
          2
        ]
      },
      {
        "Type": {
          "Id": 1,
          "Name": "sample string 2",
          "SystemName": "sample string 3"
        },
        "Group": {
          "Name": "sample string 1",
          "Description": "sample string 2",
          "Members": [
            {
              "Person": {
                "PersonId": 1,
                "Gender": {
                  "Id": 1,
                  "Name": "sample string 2",
                  "SystemName": "sample string 3"
                },
                "Title": "sample string 1",
                "FirstName": "sample string 2",
                "LastName": "sample string 3",
                "Addresses": [
                  {
                    "ContactOrder": 1,
                    "AddressType": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Latitude": 2.1,
                    "Longitude": 3.1,
                    "AddressSource": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "SourceId": "sample string 4",
                    "OrganizationName": "sample string 5",
                    "Number": "sample string 6",
                    "BuildingName": "sample string 7",
                    "Street": "sample string 8",
                    "Town": "sample string 9",
                    "Locality": "sample string 10",
                    "County": "sample string 11",
                    "Country": "sample string 12",
                    "Postcode": "sample string 13",
                    "Uprn": "sample string 14",
                    "CreatedDate": "2026-07-23T08:16:27.8622009Z",
                    "CreatedBy": {
                      "Initials": "sample string 1",
                      "ContactName": "sample string 2",
                      "Gender": {
                        "Id": 1,
                        "Name": "sample string 2",
                        "SystemName": "sample string 3"
                      },
                      "Title": "sample string 3",
                      "FirstName": "sample string 4",
                      "LastName": "sample string 5",
                      "PrimaryTelephone": {
                        "Type": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Value": "sample string 1",
                        "Notes": "sample string 2",
                        "ContactOrder": 3,
                        "AllowContact": true,
                        "MarketingContactStatus": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Name": "sample string 5",
                        "Id": 6
                      },
                      "PrimaryEmail": {
                        "Type": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Value": "sample string 1",
                        "Notes": "sample string 2",
                        "ContactOrder": 3,
                        "AllowContact": true,
                        "MarketingContactStatus": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Name": "sample string 5",
                        "Id": 6
                      },
                      "JobTitle": "sample string 6",
                      "Id": 7
                    },
                    "Id": 16
                  },
                  {
                    "ContactOrder": 1,
                    "AddressType": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Latitude": 2.1,
                    "Longitude": 3.1,
                    "AddressSource": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "SourceId": "sample string 4",
                    "OrganizationName": "sample string 5",
                    "Number": "sample string 6",
                    "BuildingName": "sample string 7",
                    "Street": "sample string 8",
                    "Town": "sample string 9",
                    "Locality": "sample string 10",
                    "County": "sample string 11",
                    "Country": "sample string 12",
                    "Postcode": "sample string 13",
                    "Uprn": "sample string 14",
                    "CreatedDate": "2026-07-23T08:16:27.8622009Z",
                    "CreatedBy": {
                      "Initials": "sample string 1",
                      "ContactName": "sample string 2",
                      "Gender": {
                        "Id": 1,
                        "Name": "sample string 2",
                        "SystemName": "sample string 3"
                      },
                      "Title": "sample string 3",
                      "FirstName": "sample string 4",
                      "LastName": "sample string 5",
                      "PrimaryTelephone": {
                        "Type": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Value": "sample string 1",
                        "Notes": "sample string 2",
                        "ContactOrder": 3,
                        "AllowContact": true,
                        "MarketingContactStatus": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Name": "sample string 5",
                        "Id": 6
                      },
                      "PrimaryEmail": {
                        "Type": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Value": "sample string 1",
                        "Notes": "sample string 2",
                        "ContactOrder": 3,
                        "AllowContact": true,
                        "MarketingContactStatus": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Name": "sample string 5",
                        "Id": 6
                      },
                      "JobTitle": "sample string 6",
                      "Id": 7
                    },
                    "Id": 16
                  }
                ],
                "ContactItems": [
                  {
                    "Id": 1,
                    "Type": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Value": "sample string 2",
                    "Notes": "sample string 3",
                    "ContactOrder": 4,
                    "AllowContact": true,
                    "MarketingContactStatus": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "NormalisedRegionCode": "sample string 5"
                  },
                  {
                    "Id": 1,
                    "Type": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Value": "sample string 2",
                    "Notes": "sample string 3",
                    "ContactOrder": 4,
                    "AllowContact": true,
                    "MarketingContactStatus": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "NormalisedRegionCode": "sample string 5"
                  }
                ],
                "ServiceTypes": [
                  {
                    "Service": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Referral": true
                  },
                  {
                    "Service": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Referral": true
                  }
                ],
                "ExternalApplicantReference": "sample string 4",
                "Id": 5
              },
              "RelationshipType": {
                "Id": 1,
                "Name": "sample string 2",
                "SystemName": "sample string 3"
              },
              "Id": 1
            },
            {
              "Person": {
                "PersonId": 1,
                "Gender": {
                  "Id": 1,
                  "Name": "sample string 2",
                  "SystemName": "sample string 3"
                },
                "Title": "sample string 1",
                "FirstName": "sample string 2",
                "LastName": "sample string 3",
                "Addresses": [
                  {
                    "ContactOrder": 1,
                    "AddressType": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Latitude": 2.1,
                    "Longitude": 3.1,
                    "AddressSource": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "SourceId": "sample string 4",
                    "OrganizationName": "sample string 5",
                    "Number": "sample string 6",
                    "BuildingName": "sample string 7",
                    "Street": "sample string 8",
                    "Town": "sample string 9",
                    "Locality": "sample string 10",
                    "County": "sample string 11",
                    "Country": "sample string 12",
                    "Postcode": "sample string 13",
                    "Uprn": "sample string 14",
                    "CreatedDate": "2026-07-23T08:16:27.8622009Z",
                    "CreatedBy": {
                      "Initials": "sample string 1",
                      "ContactName": "sample string 2",
                      "Gender": {
                        "Id": 1,
                        "Name": "sample string 2",
                        "SystemName": "sample string 3"
                      },
                      "Title": "sample string 3",
                      "FirstName": "sample string 4",
                      "LastName": "sample string 5",
                      "PrimaryTelephone": {
                        "Type": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Value": "sample string 1",
                        "Notes": "sample string 2",
                        "ContactOrder": 3,
                        "AllowContact": true,
                        "MarketingContactStatus": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Name": "sample string 5",
                        "Id": 6
                      },
                      "PrimaryEmail": {
                        "Type": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Value": "sample string 1",
                        "Notes": "sample string 2",
                        "ContactOrder": 3,
                        "AllowContact": true,
                        "MarketingContactStatus": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Name": "sample string 5",
                        "Id": 6
                      },
                      "JobTitle": "sample string 6",
                      "Id": 7
                    },
                    "Id": 16
                  },
                  {
                    "ContactOrder": 1,
                    "AddressType": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Latitude": 2.1,
                    "Longitude": 3.1,
                    "AddressSource": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "SourceId": "sample string 4",
                    "OrganizationName": "sample string 5",
                    "Number": "sample string 6",
                    "BuildingName": "sample string 7",
                    "Street": "sample string 8",
                    "Town": "sample string 9",
                    "Locality": "sample string 10",
                    "County": "sample string 11",
                    "Country": "sample string 12",
                    "Postcode": "sample string 13",
                    "Uprn": "sample string 14",
                    "CreatedDate": "2026-07-23T08:16:27.8622009Z",
                    "CreatedBy": {
                      "Initials": "sample string 1",
                      "ContactName": "sample string 2",
                      "Gender": {
                        "Id": 1,
                        "Name": "sample string 2",
                        "SystemName": "sample string 3"
                      },
                      "Title": "sample string 3",
                      "FirstName": "sample string 4",
                      "LastName": "sample string 5",
                      "PrimaryTelephone": {
                        "Type": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Value": "sample string 1",
                        "Notes": "sample string 2",
                        "ContactOrder": 3,
                        "AllowContact": true,
                        "MarketingContactStatus": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Name": "sample string 5",
                        "Id": 6
                      },
                      "PrimaryEmail": {
                        "Type": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Value": "sample string 1",
                        "Notes": "sample string 2",
                        "ContactOrder": 3,
                        "AllowContact": true,
                        "MarketingContactStatus": {
                          "Id": 1,
                          "Name": "sample string 2",
                          "SystemName": "sample string 3"
                        },
                        "Name": "sample string 5",
                        "Id": 6
                      },
                      "JobTitle": "sample string 6",
                      "Id": 7
                    },
                    "Id": 16
                  }
                ],
                "ContactItems": [
                  {
                    "Id": 1,
                    "Type": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Value": "sample string 2",
                    "Notes": "sample string 3",
                    "ContactOrder": 4,
                    "AllowContact": true,
                    "MarketingContactStatus": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "NormalisedRegionCode": "sample string 5"
                  },
                  {
                    "Id": 1,
                    "Type": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Value": "sample string 2",
                    "Notes": "sample string 3",
                    "ContactOrder": 4,
                    "AllowContact": true,
                    "MarketingContactStatus": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "NormalisedRegionCode": "sample string 5"
                  }
                ],
                "ServiceTypes": [
                  {
                    "Service": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Referral": true
                  },
                  {
                    "Service": {
                      "Id": 1,
                      "Name": "sample string 2",
                      "SystemName": "sample string 3"
                    },
                    "Referral": true
                  }
                ],
                "ExternalApplicantReference": "sample string 4",
                "Id": 5
              },
              "RelationshipType": {
                "Id": 1,
                "Name": "sample string 2",
                "SystemName": "sample string 3"
              },
              "Id": 1
            }
          ],
          "GroupType": {
            "Id": 1,
            "Name": "sample string 2",
            "SystemName": "sample string 3"
          },
          "Origin": {
            "Id": 1,
            "Name": "sample string 2",
            "SystemName": "sample string 3"
          },
          "Grade": {
            "Id": 1,
            "Name": "sample string 2",
            "SystemName": "sample string 3"
          },
          "ExternalProviderTypes": [
            {
              "Id": 1,
              "Name": "sample string 2",
              "SystemName": "sample string 3"
            },
            {
              "Id": 1,
              "Name": "sample string 2",
              "SystemName": "sample string 3"
            }
          ],
          "VATNumber": "sample string 3",
          "AdditionalQuestions": {
            "ArrangedMortgage": true,
            "MortgageProvider": "sample string 1",
            "HowLongToMove": "sample string 2",
            "ReasonForMoving": "sample string 3",
            "HowHeard": "sample string 4",
            "EnquiryMethod": "sample string 5",
            "BestTimeToCall": "sample string 6",
            "WhenCanView": "sample string 7",
            "HappyToReceivePropertyEmails": true,
            "ViewedAnyProperties": true,
            "LocalOwnToSell": true,
            "AskingPrice": "sample string 8",
            "Bedrooms": 1,
            "CurrentlyOnMarket": true,
            "SellingWith": "sample string 9",
            "OnMarketSince": "2026-07-23T08:16:27.8622009Z",
            "ReasonForSale": "sample string 10",
            "OfferedMA": true,
            "CurrentStatus": {
              "Id": 1,
              "Name": "sample string 2",
              "SystemName": "sample string 3"
            },
            "Financial": {
              "Id": 1,
              "Name": "sample string 2",
              "SystemName": "sample string 3"
            },
            "Reason": {
              "Id": 1,
              "Name": "sample string 2",
              "SystemName": "sample string 3"
            }
          },
          "BranchId": 1,
          "Id": 4
        },
        "AttendingPeopleIds": [
          1,
          2
        ]
      }
    ],
    "SpecialArrangements": [
      {
        "Text": "sample string 1",
        "SpecialArrangementType": {
          "Id": 1,
          "Name": "sample string 2",
          "SystemName": "sample string 3"
        },
        "ApplicableToGroupIds": [
          1,
          2
        ],
        "Id": 2
      },
      {
        "Text": "sample string 1",
        "SpecialArrangementType": {
          "Id": 1,
          "Name": "sample string 2",
          "SystemName": "sample string 3"
        },
        "ApplicableToGroupIds": [
          1,
          2
        ],
        "Id": 2
      }
    ],
    "FollowUpNegotiatorId": 7,
    "AppointmentRecurringSchedule": {
      "Id": 1,
      "Frequency": 0,
      "Occurrences": 2,
      "Interval": 3,
      "DaysOfTheWeek": [
        1,
        2
      ],
      "RecurringStartDate": "2026-07-23T08:16:27.8622009Z",
      "RecurringEndDate": "2026-07-23T08:16:27.8622009Z"
    },
    "ExternalAppointmentReference": "sample string 8",
    "Id": 9
  },
  "EventType": "sample string 6",
  "ReasonOfCancellation": "sample string 7",
  "OriginalDate": "2026-07-23T08:16:27.8622009Z",
  "ExternalAppointmentReference": "sample string 8",
  "EditingRecurringOption": 9,
  "Id": 10
}

Response Information

Resource Description

The response returned after the operation completes.

AppointmentDataContract
NameDescriptionTypeAdditional information
AllDayEvent

Indicates whether all day event is true.

boolean

None.

StartDate

The start date, expressed as a date and time.

date

None.

EndDate

The end date, expressed as a date and time.

date

None.

Address

The address value.

AddressDataContract

None.

MeetingPlace

The meeting place value.

MeetingPlaceDataContract

None.

AttendingGroups

The collection of attending groups.

Collection of AppointmentAttendeeCollectionDataContract

None.

SpecialArrangements

The collection of special arrangements.

Collection of SpecialArrangementDataContract

None.

Roles

The collection of roles.

Collection of RoleDataContract

None.

MarketingRoleId

The unique identifier of the related marketing role resource.

integer

None.

PropertyId

The unique identifier of the related property resource.

integer

None.

AppointmentRecurringSchedule

The appointment recurring schedule value.

AppointmentRecurringScheduleDataContract

None.

ExternalAppointmentReference

The external appointment reference value.

string

None.

AppointmentRecurringScheduleId

The unique identifier of the related appointment recurring schedule resource.

integer

None.

AppointmentRecurringFirstInstanceId

The unique identifier of the related appointment recurring first instance resource.

integer

None.

Team

The team value.

EventTeamDataContract

None.

Notes

The collection of notes.

Collection of EventNoteCommandDataContract

None.

Documents

The collection of documents.

Collection of DocumentDataContract

None.

Name

The name value.

string

None.

Description

The description value.

string

None.

DateTime

The date time, expressed as a date and time.

date

None.

EventCategory

The event category value.

EnumDataContract

None.

EventType

The event type value.

EnumDataContract

None.

EventStatus

The event status value.

EnumDataContract

None.

Negotiators

The collection of negotiators.

Collection of ListNegotiatorDataContract

None.

BranchId

The unique identifier of the related branch resource.

integer

None.

OwningTeamId

The unique identifier of the related owning team resource.

integer

None.

TeamAccessType

The team access type value.

string

None.

CustomFields

The collection of custom fields.

Collection of CustomFieldGroupWithValuesDataContract

None.

CreatedDate

The created date, expressed as a date and time.

date

None.

CreatedBy

The created by value.

CreatedByDataContract

None.

Id

The unique identifier of this resource.

integer

None.

Response Formats

application/json

Sample:

Sample not available.

text/json

Sample:

Sample not available.