Update an existing estate agent. This will fully overwrite the estate agent with the data from the request.
Update an EstateAgent
Replaces the stored data of an existing estate agent relation with the data supplied in the request.
This operation fully overwrites the estate agent. Any field not included in the request will be cleared, not left unchanged. To update only specific fields, first retrieve the estate agent's current data and include all existing values in the request together with the changes.
Request Fields
Field | Type | Required | Description |
|---|---|---|---|
reference | string, max 100, nullable | Required (at least one of reference or externalIdentifier must be given) | The internal identifier (Reference/Code) of the estate agent to update. |
externalIdentifier | string, max 100, nullable | Required (at least one of reference or externalIdentifier must be given) | The external API identifier of the estate agent to update. The value supplied here also becomes the stored external identifier going forward. |
name | string, max 256 | Required | The estate agent's registered or trading name. |
website | string, nullable | Optional | The estate agent's website URL. |
correspondenceMethod | integer (enum) | Required | How correspondence should be delivered to this estate agent. Allowed values: 1 = Email, 2 = Post. When set to Email, primaryEmailAddresses is mandatory. When set to Post, address is mandatory. |
languageISOCode | string, max 2, nullable | Optional | ISO 639-1 two-letter language code (for example "nl" or "en") determining the language used in correspondence. |
address.street | string, max 200 | Conditionally required | Street name of the estate agent's main address. Required when correspondenceMethod is set to Post (2). |
address.houseNumber | string, max 40, nullable | Optional | House number of the estate agent's main address, including any suffix (for example "12A"). |
address.postalCode | string, max 20 | Conditionally required | Postal code of the estate agent's main address. Required when correspondenceMethod is set to Post (2). |
address.city | string, max 200 | Conditionally required | City of the estate agent's main address. Required when correspondenceMethod is set to Post (2). |
address.countryISOCode | string, max 2 | Conditionally required | ISO 3166-1 alpha-2 country code of the estate agent's main address, for example "NL". Required when correspondenceMethod is set to Post (2). |
invoiceAddress.street | string, max 200 | Required (if invoiceAddress is set) | Street name of the address to use for invoicing this estate agent, if different from the main address. |
invoiceAddress.houseNumber | string, max 40, nullable | Optional | House number of the invoice address, including any suffix. |
invoiceAddress.postalCode | string, max 20 | Required (if invoiceAddress is set) | Postal code of the invoice address. |
invoiceAddress.city | string, max 200 | Required (if invoiceAddress is set) | City of the invoice address. |
invoiceAddress.countryISOCode | string, max 2 | Required (if invoiceAddress is set) | ISO 3166-1 alpha-2 country code of the invoice address. |
postalAddress.street | string, max 200 | Required (if postalAddress is set) | Street name of the postal correspondence address, if different from the main address. |
postalAddress.houseNumber | string, max 40, nullable | Optional | House number of the postal address, including any suffix. |
postalAddress.postalCode | string, max 20 | Required (if postalAddress is set) | Postal code of the postal address. |
postalAddress.city | string, max 200 | Required (if postalAddress is set) | City of the postal address. |
postalAddress.countryISOCode | string, max 2 | Required (if postalAddress is set) | ISO 3166-1 alpha-2 country code of the postal address. |
phoneNumber | string, nullable | Optional | The estate agent's landline phone number. |
mobileNumber | string, nullable | Optional | The estate agent's mobile phone number. |
primaryEmailAddresses | array of string, nullable | Conditionally required | The estate agent's primary email address(es), used for general correspondence. Required when correspondenceMethod is set to Email (1). |
invoicesEmailAddresses | array of string, nullable | Optional | Email address(es) that should receive invoices for this estate agent. |
paymentRemindersEmailAddresses | array of string, nullable | Optional | Email address(es) that should receive payment reminder correspondence. |
indexationsEmailAddresses | array of string, nullable | Optional | Email address(es) that should receive rent or fee indexation notices. |
serviceTicketsEmailAddresses | array of string, nullable | Optional | Email address(es) that should receive service or maintenance ticket correspondence. |
purchaseOrdersEmailAddresses | array of string, nullable | Optional | Email address(es) that should receive purchase order correspondence. |
portalsEmailAddresses | array of string, nullable | Optional | Email address(es) used for portal-related notifications. |
otherEmailAddresses | array of string, nullable | Optional | Any additional email address(es) not covered by the categories above. |
cocNumber | string, max 256, nullable | Optional | Chamber of Commerce (KVK-style) registration number for the estate agent. |
cocDescription | string, nullable | Optional | Free-text description associated with the Chamber of Commerce registration. |
vatNumber | string, max 256, nullable | Optional | The estate agent's VAT identification number, used for invoicing and determining VAT/reverse-charge treatment where applicable. |
remarks | string, nullable | Optional | Free-text internal remarks about the estate agent. |
Response Fields
Field | Type | Required | Description |
|---|---|---|---|
reference | string, max 100 | Optional | The internal identifier (Reference/Code) of the updated estate agent. |
externalIdentifier | string, max 100 | Optional | The external API identifier stored for this estate agent, if any. |
displayName | string | Optional | The formatted display name of the estate agent. |
name | string, max 256 | Required | The estate agent's registered or trading name. |
website | string, nullable | Optional | The estate agent's website URL. |
correspondenceMethod | integer (enum) | Required | How correspondence is delivered to this estate agent. Allowed values: 1 = Email, 2 = Post. |
languageISOCode | string, max 2, nullable | Optional | ISO 639-1 two-letter language code determining the correspondence language. |
address.street | string, max 200 | Conditionally required | Street name of the estate agent's main address. |
address.houseNumber | string, max 40, nullable | Optional | House number of the estate agent's main address, including any suffix. |
address.postalCode | string, max 20 | Conditionally required | Postal code of the estate agent's main address. |
address.city | string, max 200 | Conditionally required | City of the estate agent's main address. |
address.countryISOCode | string, max 2 | Conditionally required | ISO 3166-1 alpha-2 country code of the estate agent's main address. |
invoiceAddress.street | string, max 200 | Required (if invoiceAddress is set) | Street name of the invoice address. |
invoiceAddress.houseNumber | string, max 40, nullable | Optional | House number of the invoice address. |
invoiceAddress.postalCode | string, max 20 | Required (if invoiceAddress is set) | Postal code of the invoice address. |
invoiceAddress.city | string, max 200 | Required (if invoiceAddress is set) | City of the invoice address. |
invoiceAddress.countryISOCode | string, max 2 | Required (if invoiceAddress is set) | ISO 3166-1 alpha-2 country code of the invoice address. |
postalAddress.street | string, max 200 | Required (if postalAddress is set) | Street name of the postal address. |
postalAddress.houseNumber | string, max 40, nullable | Optional | House number of the postal address. |
postalAddress.postalCode | string, max 20 | Required (if postalAddress is set) | Postal code of the postal address. |
postalAddress.city | string, max 200 | Required (if postalAddress is set) | City of the postal address. |
postalAddress.countryISOCode | string, max 2 | Required (if postalAddress is set) | ISO 3166-1 alpha-2 country code of the postal address. |
phoneNumber | string, nullable | Optional | The estate agent's landline phone number. |
mobileNumber | string, nullable | Optional | The estate agent's mobile phone number. |
primaryEmailAddresses | array of string, nullable | Conditionally required | The estate agent's primary email address(es). |
invoicesEmailAddresses | array of string, nullable | Optional | Email address(es) that receive invoices for this estate agent. |
paymentRemindersEmailAddresses | array of string, nullable | Optional | Email address(es) that receive payment reminder correspondence. |
indexationsEmailAddresses | array of string, nullable | Optional | Email address(es) that receive rent or fee indexation notices. |
serviceTicketsEmailAddresses | array of string, nullable | Optional | Email address(es) that receive service or maintenance ticket correspondence. |
purchaseOrdersEmailAddresses | array of string, nullable | Optional | Email address(es) that receive purchase order correspondence. |
portalsEmailAddresses | array of string, nullable | Optional | Email address(es) used for portal-related notifications. |
otherEmailAddresses | array of string, nullable | Optional | Any additional email address(es) not covered by the categories above. |
cocNumber | string, max 256, nullable | Optional | Chamber of Commerce (KVK-style) registration number, where applicable. |
cocDescription | string, nullable | Optional | Free-text description associated with the Chamber of Commerce registration. |
vatNumber | string, max 256, nullable | Optional | The estate agent's VAT identification number. |
remarks | string, nullable | Optional | Free-text internal remarks about the estate agent. |
archiveDate | string (date), nullable | Optional | The date from which the estate agent is archived, formatted as an ISO 8601 date (YYYY-MM-DD). Null if the estate agent is not archived. |
Email = 1 Post = 2
The estate agent was updated
Email = 1 Post = 2
The estate agent data has validation issues