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:

  1. Fetch the contact: GET /contacts/789 (receives ETag in response)
  2. Modify the data locally
  3. Send update with If-Match: {etag} header
  4. If another client modified the contact in the meantime, you'll receive 412 Precondition Failed
  5. 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 OK with 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

  • The unique identifier of the contact to update

Headers

  • ETag value from a previous GET or PATCH response for optimistic concurrency control

Body·

required

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.

  • List of company connections (employments).

    Properties: 3
  • Email address.

  • External references to this contact in other systems (e.g. CRM IDs).

    Properties: 2
  • First name.

  • Last name.

  • LinkedIn profile URL in the format https://www.linkedin.com/in/{slug}.

  • Phone number.

  • 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.

  • The contact's photo: an image id from POST /api/v1/images, or one already shown in your organisation. Null removes the photo.

  • Investment strategy or description.

  • 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
Request Example for patch/api/v1/network/contacts/{id}
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"
    }
  ]
}