POST api/progressionchain/{id}/addchainnode
Add node to progression chain Processes this progression chain API request. The parameter and response sections describe the data exchanged with the API.
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| id |
PurchasingRoleId |
integer |
Required |
Body Parameters
The add chain nodes data contract supplied with the request.
AddChainNodesDataContract| Name | Description | Type | Additional information |
|---|---|---|---|
| NodeIds |
The unique identifiers of the related node resources. |
Collection of integer |
None. |
| NodeType |
The node type classification. |
NodeType |
None. |
| Property |
The property value. |
AddPropertyCommandDataContract |
None. |
| Group |
The group value. |
AddGroupCommandDataContract |
None. |
| Links |
The collection of links. |
Collection of AddChainLinkDataContract |
None. |
| Reference |
The reference value. |
string |
None. |
| EstateAgent |
The estate agent value. |
string |
None. |
| Solicitor |
The solicitor value. |
string |
None. |
| Notes |
The notes value. |
string |
None. |
| IsDown |
Indicates whether this item is down. |
boolean |
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:
{
"NodeIds": [
1,
2
],
"NodeType": 1,
"Property": {
"Property": {
"Address": {
"Latitude": 1.1,
"Longitude": 2.1,
"AddressSource": {
"Id": 1,
"Name": "sample string 2",
"SystemName": "sample string 3"
},
"SourceId": "sample string 3",
"OrganizationName": "sample string 4",
"Number": "sample string 5",
"BuildingName": "sample string 6",
"Street": "sample string 7",
"Town": "sample string 8",
"Locality": "sample string 9",
"County": "sample string 10",
"Country": "sample string 11",
"Postcode": "sample string 12",
"Uprn": "sample string 13",
"CreatedDate": "2026-08-05T00:17:28.7669083Z",
"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": 15
},
"Id": 1
},
"AmenityDescription": {
"Gardens": 1,
"ParkingSpaces": 2,
"ParkingTypes": [
{
"Id": 1,
"Name": "sample string 2",
"SystemName": "sample string 3"
},
{
"Id": 1,
"Name": "sample string 2",
"SystemName": "sample string 3"
}
],
"Garages": 3,
"FixturesFittings": "sample string 4",
"Acreage": 5.1,
"AcreageMeasurementUnitType": {
"Id": 1,
"Name": "sample string 2",
"SystemName": "sample string 3"
},
"AccessibilityTypes": [
{
"Id": 1,
"Name": "sample string 2",
"SystemName": "sample string 3"
},
{
"Id": 1,
"Name": "sample string 2",
"SystemName": "sample string 3"
}
],
"HeatingSources": [
{
"Id": 1,
"Name": "sample string 2",
"SystemName": "sample string 3"
},
{
"Id": 1,
"Name": "sample string 2",
"SystemName": "sample string 3"
}
],
"ElectricitySupply": [
{
"Id": 1,
"Name": "sample string 2",
"SystemName": "sample string 3"
},
{
"Id": 1,
"Name": "sample string 2",
"SystemName": "sample string 3"
}
],
"WaterSupply": {
"Id": 1,
"Name": "sample string 2",
"SystemName": "sample string 3"
},
"Sewerage": {
"Id": 1,
"Name": "sample string 2",
"SystemName": "sample string 3"
},
"BroadbandConnectionTypes": [
{
"Id": 1,
"Name": "sample string 2",
"SystemName": "sample string 3"
},
{
"Id": 1,
"Name": "sample string 2",
"SystemName": "sample string 3"
}
],
"Name": "sample string 6",
"Id": 7
},
"RoomCountDescription": {
"Bedrooms": 1,
"Bathrooms": 2,
"Receptions": 3,
"Others": 4,
"Conservatories": 5,
"Extensions": 6,
"Name": "sample string 7",
"Id": 8
},
"StyleAgeDescription": {
"PropertyType": {
"Id": 1,
"Name": "sample string 2",
"SystemName": "sample string 3"
},
"StyleType": {
"Id": 1,
"Name": "sample string 2",
"SystemName": "sample string 3"
},
"LeaseType": {
"Id": 1,
"Name": "sample string 2",
"SystemName": "sample string 3"
},
"AgeType": {
"Id": 1,
"Name": "sample string 2",
"SystemName": "sample string 3"
},
"Name": "sample string 1",
"Id": 2
}
},
"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-08-05T00:17:28.7669083Z",
"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-08-05T00:17:28.7669083Z",
"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-08-05T00:17:28.7669083Z",
"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-08-05T00:17:28.7669083Z",
"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-08-05T00:17:28.7669083Z",
"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
},
"Links": [
{
"Source": 1,
"Target": 2,
"Circular": true,
"Id": 4
},
{
"Source": 1,
"Target": 2,
"Circular": true,
"Id": 4
}
],
"Reference": "sample string 1",
"EstateAgent": "sample string 2",
"Solicitor": "sample string 3",
"Notes": "sample string 4",
"IsDown": true,
"Id": 6
}
Response Information
Resource Description
The response returned after the operation completes.
ProgressionChainDataContract| Name | Description | Type | Additional information |
|---|---|---|---|
| Nodes |
The collection of nodes. |
Collection of ChainItemDataContract |
None. |
| Links |
The collection of links. |
Collection of ChainLinkDataContract |
None. |
| Property |
The property value. |
PropertyDataContract |
None. |
| Id |
The unique identifier of this resource. |
integer |
None. |
Response Formats
application/json
Sample:
Sample not available.
text/json
Sample:
Sample not available.