Skip to main content
PATCH
/
clients
/
contacts
/
{id}
Update client contact
curl --request PATCH \
  --url https://api.gospott.com/clients/contacts/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "role": "<string>",
  "department": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "emails": [
    {
      "email": "jsmith@example.com",
      "isPrimary": true
    }
  ],
  "phoneNumbers": [
    {
      "phoneNumber": "<string>",
      "isPrimary": true
    }
  ],
  "mainContactId": "<string>",
  "stageId": "<string>",
  "startDate": "2023-11-07T05:31:56Z",
  "endDate": "2023-11-07T05:31:56Z"
}
'
{
  "status": 0,
  "message": "ONLY_ONE_PRIMARY_EMAIL_ALLOWED",
  "requestId": "<string>",
  "statusCode": 400,
  "error": "Bad Request"
}

Documentation Index

Fetch the complete documentation index at: https://api-docs.spott.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

x-api-key
string
header
required

API key for authentication. Get your API key from Settings → API Keys in your Spott dashboard.

Path Parameters

id
string
required

Body

application/json
role
string | null

Role of the client contact

department
string | null

Department of the client contact

firstName
string

First name of the client contact

Minimum string length: 1
lastName
string

Last name of the client contact

Minimum string length: 1
emails
object[]

Email addresses of the client contact

phoneNumbers
object[]

Phone numbers of the client contact

mainContactId
string

ID of the main contact (user) for this client contact

stageId
string

ID of the pipeline stage

startDate

Start date of the client contact

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
endDate

End date of the client contact

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

Response

Client contact updated successfully