Updates an existing contact (partial update using PATCH semantics).
Usage Examples
Update email address with concurrency control:
PATCH /api/v1/network/contacts/789
If-Match: "AAAAAAAAK0Q="
Content-Type: application/json
{
"email": "newemail@example.com"
}
Update multiple fields:
{
"firstName": "Jane",
"tags": ["vip", "enterprise", "decision-maker"]
}
Clear a field (set to null):
{
"phone": null,
"primaryLanguage": null
}
Concurrency Control with ETags
The If-Match header enables optimistic concurrency control:
- Fetch the contact:
GET /contacts/789(receives ETag in response) - Modify the data locally
- Send update with
If-Match: {etag}header - If another client modified the contact in the meantime, you'll receive
412 Precondition Failed - Re-fetch the contact, merge changes, and retry
Best practice: Always include the If-Match header when updating from external CRM systems
to prevent overwriting concurrent changes from users.
Partial Update Semantics
This endpoint implements true HTTP PATCH semantics:
- Only fields present in the request body are updated
- Omitted fields retain their current values
- To clear a field, explicitly set it to
null - If no fields actually change, returns
200 OKwith unchanged data
Possible duplicates
A new company named in connections (kind: "new") is created with the update even when
it looks like a company already in your network: nothing is refused. The response then
lists those existing companies in possibleDuplicates, strongest first, each with why —
the same shape a create returns. An update that creates no company lists nothing.
Validation Rules
Same validation rules as POST /contacts apply to updated fields.
Path Parameters
- Type: stringidrequired
The unique identifier of the contact to update
Headers
- Type: stringIf
- Match ETag value from a previous GET or PATCH response for optimistic concurrency control
Body·
Fields to update. Only include fields you want to change. Omitted fields are left unchanged.
Request body for updating an existing contact. Only include fields you want to change. Omitted fields are left unchanged; fields set to null are cleared.
- Type:connectionsProperties: 3
List of company connections (employments).
- Type: null | stringemail
Email address.
- Type:external
Refs Properties: 2External references to this contact in other systems (e.g. CRM IDs).
- Type: null | stringfirst
Name First name.
- Type: null | stringlast
Name Last name.
- Type: null | stringlinked
In Url LinkedIn profile URL in the format https://www.linkedin.com/in/{slug}.
- Type: null | stringphone
Phone number.
- Type: null | stringprimary
Language Two-letter ISO 639-1 language code, e.g. "en" or "sv". Case and a region subtag are ignored ("sv-SE" is "sv"); Norwegian is "nb" ("no" is accepted). An unknown code is refused with a validation error that lists the accepted codes. Null or an empty string clears the language.
- Type: null | stringprofile
Picture Id The contact's photo: an image id from
POST /api/v1/images, or one already shown in your organisation. Null removes the photo. - Type: null | stringstrategy
Investment strategy or description.
- Type: null | array of string
List of tags or labels. A tag cannot contain a comma.
Responses
- application/json
- application/problem+json
- application/problem+json
- application/problem+json
- application/problem+json
- application/problem+json
curl 'https://app.propstreet.com/api/v1/network/contacts/{id}' \
--request PATCH \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"externalRefs": [
{
"namespace": "",
"id": ""
}
],
"firstName": null,
"lastName": null,
"email": null,
"phone": null,
"linkedInUrl": null,
"primaryLanguage": null,
"tags": [
""
],
"strategy": null,
"connections": [
{
"company": {
"kind": "existing",
"id": ""
},
"jobTitle": null,
"primary": true
}
],
"profilePictureId": null
}'
{
"id": "string",
"uri": null,
"externalRefs": [
{
"namespace": "string",
"id": "string"
}
],
"firstName": null,
"lastName": null,
"email": null,
"phone": null,
"linkedInUrl": null,
"emails": [
{
"address": "string",
"type": null,
"isPrimary": true
}
],
"phones": [
{
"number": "string",
"type": null,
"isPrimary": true
}
],
"primaryLanguage": null,
"tags": [
"string"
],
"strategy": null,
"primaryCompanyId": null,
"companies": [
{
"id": "string",
"uri": null,
"name": "string",
"jobTitle": null,
"isPrimary": true
}
],
"profilePictureUrl": null,
"createdUtc": "2026-11-11T23:30:58.076Z",
"updatedUtc": "2026-11-11T23:30:58.076Z",
"deletedUtc": null,
"etag": "string",
"changeType": null,
"changeOrigin": null,
"possibleDuplicates": [
{
"id": "string",
"kind": "contact",
"name": "string",
"companyName": null,
"phone": null,
"tier": "identity",
"reasons": [
{
"reason": "email",
"tier": "identity",
"matched": null
}
],
"prospectId": null,
"prospectRemoved": null,
"inRequest": null
}
],
"warnings": [
{
"code": "invalid_phone",
"value": "string"
}
]
}