Skip to main content
PATCH
/
leads
/
{id}
Update Lead
curl --request PATCH \
  --url https://api.partner.dit.myperch.io/v1/leads/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "email": "[email protected]",
  "firstName": "Ambrose",
  "lastName": "Barton",
  "phone": {
    "number": "8265822123",
    "extension": "903"
  },
  "clientData": {
    "sin": "047470723",
    "prefix": "Ms.",
    "citizenship": "Permanent Legal Resident (PR)",
    "dateOfBirth": "1975-04-10",
    "maritalStatus": "Separated",
    "creditScoreEstimation": "899"
  }
}
'
{
  "data": {
    "id": "3fvStz1j",
    "createdAt": "2026-01-13T21:34:54.135Z",
    "updatedAt": "2026-01-13T21:34:54.135Z",
    "deletedAt": null,
    "email": "[email protected]",
    "firstName": "Ambrose",
    "lastName": "Barton",
    "phone": {
      "number": "8265822123",
      "extension": "903"
    },
    "clientData": {
      "sin": "047470723",
      "prefix": "Ms.",
      "citizenship": "Permanent Legal Resident (PR)",
      "dateOfBirth": "1975-04-10",
      "maritalStatus": "Separated",
      "creditScoreEstimation": "899"
    },
    "resourceType": "Firm",
    "resourceId": "gk3Fhfi6",
    "referredByReferralCodeId": null,
    "convertedAt": null
  }
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
id
string
required

The id of the record to update.

Body

application/json

The data to update the record with.

​
email
string<email>
required

The client's email address

Example:

"[email protected]"

​
firstName
string
required

The client's first name

Example:

"Ambrose"

​
lastName
string
required

The client's last name

Example:

"Barton"

​
resourceType
enum<string>
required

The resource type of the lead owner

Available options:
ClientProfile,
Firm,
FirmMember
Example:

"Firm"

​
resourceId
string
required

The resource ID of the lead owner

Example:

"gk3Fhfi6"

​
phone
object

The client's phone number

​
clientData
object

The user data for the lead

​
referredByReferralCodeId
string | null

Support only: The referral source of the lead. This referral source takes priority over the lead owner during lead conversion.

Response

Successful response

​
data
object