PUT api/people/{id}/addaddress

Add an Address to a Person Processes this people API request. The parameter and response sections describe the data exchanged with the API.

Request Information

URI Parameters

Name	Description	Type	Additional information
id	The unique identifier of the requested resource.	integer	Required

Body Parameters

The add person address command data contract supplied with the request.

AddPersonAddressCommandDataContract

Name	Description	Type	Additional information
ContactOrder	The contact order value.	integer	None.
AddressType	The address type value.	EnumDataContract	None.
Latitude	The latitude value.	decimal number	None.
Longitude	The longitude value.	decimal number	None.
AddressSource	The address source value.	EnumDataContract	None.
SourceId	The unique identifier of the related source resource.	string	None.
OrganizationName	The organization name value.	string	None.
Number	The number value.	string	None.
BuildingName	The building name value.	string	None.
Street	The street value.	string	None.
Town	The town value.	string	None.
Locality	The locality value.	string	None.
County	The county value.	string	None.
Country	The country value.	string	None.
Postcode	The postcode value.	string	None.
Uprn	The uprn value.	string	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.

Request Formats

application/x-www-form-urlencoded

Sample:

Sample not available.

application/json, text/json

Sample:

{
  "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-23T04:06:30.9252847Z",
  "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
}

Response Information

Resource Description

The Address

ContactAddressDataContract

Name	Description	Type	Additional information
AddressType	The address type value.	EnumDataContract	None.
ContactOrder	The contact order value.	integer	None.
Location	The location value.	LocationDataContract	None.
AddressSource	The address source value.	EnumDataContract	None.
SourceId	The unique identifier of the related source resource.	string	None.
OrganizationName	The organization name value.	string	None.
Number	The number value.	string	None.
BuildingName	The building name value.	string	None.
Street	The street value.	string	None.
Town	The town value.	string	None.
Locality	The locality value.	string	None.
County	The county value.	string	None.
Country	The country value.	string	None.
Postcode	The postcode value.	string	None.
Uprn	The uprn value.	string	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, text/json

Sample:

{
  "AddressType": {
    "Id": 1,
    "Name": "sample string 2",
    "SystemName": "sample string 3"
  },
  "ContactOrder": 1,
  "Location": {
    "CenterPoint": {
      "Latitude": 1.1,
      "Longitude": 2.1,
      "Altitude": 3.1,
      "Order": 4,
      "Id": 5
    },
    "Extent": [
      {
        "Latitude": 1.1,
        "Longitude": 2.1,
        "Altitude": 3.1,
        "Order": 4,
        "Id": 5
      },
      {
        "Latitude": 1.1,
        "Longitude": 2.1,
        "Altitude": 3.1,
        "Order": 4,
        "Id": 5
      }
    ],
    "ViewPoints": [
      {
        "Point": {
          "Latitude": 1.1,
          "Longitude": 2.1,
          "Altitude": 3.1,
          "Order": 4,
          "Id": 5
        },
        "Pitch": 1.1,
        "Heading": 2.1,
        "FieldOfVision": 3.1,
        "Zoom": 4.1,
        "Label": "sample string 5",
        "Id": 6
      },
      {
        "Point": {
          "Latitude": 1.1,
          "Longitude": 2.1,
          "Altitude": 3.1,
          "Order": 4,
          "Id": 5
        },
        "Pitch": 1.1,
        "Heading": 2.1,
        "FieldOfVision": 3.1,
        "Zoom": 4.1,
        "Label": "sample string 5",
        "Id": 6
      }
    ],
    "Id": 1
  },
  "AddressSource": {
    "Id": 1,
    "Name": "sample string 2",
    "SystemName": "sample string 3"
  },
  "SourceId": "sample string 2",
  "OrganizationName": "sample string 3",
  "Number": "sample string 4",
  "BuildingName": "sample string 5",
  "Street": "sample string 6",
  "Town": "sample string 7",
  "Locality": "sample string 8",
  "County": "sample string 9",
  "Country": "sample string 10",
  "Postcode": "sample string 11",
  "Uprn": "sample string 12",
  "CreatedDate": "2026-07-23T04:06:30.9252847Z",
  "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": 14
}