Skip to main content
PUT
/
people
Upsert a person
curl --request PUT \
  --url https://api.klipy.ai/api/v1/people \
  --header 'Content-Type: application/json' \
  --header 'X-Klipy-Api-Key: <api-key>' \
  --data '
{
  "email": "jsmith@example.com",
  "firstName": "<string>",
  "lastName": "<string>",
  "title": "<string>",
  "phone": "<string>",
  "personalPhone": "<string>",
  "linkedin": "<string>",
  "twitter": "<string>",
  "facebook": "<string>",
  "instagram": "<string>",
  "whatsapp": "<string>",
  "altEmails": [
    "jsmith@example.com"
  ],
  "remarks": "<string>"
}
'
{
  "object": "success",
  "data": {
    "id": "<string>",
    "email": "jsmith@example.com",
    "firstName": "<string>",
    "lastName": "<string>",
    "title": "<string>",
    "phone": "<string>",
    "personalPhone": "<string>",
    "linkedin": "<string>",
    "twitter": "<string>",
    "facebook": "<string>",
    "instagram": "<string>",
    "whatsapp": "<string>",
    "altEmails": [
      "jsmith@example.com"
    ],
    "remarks": "<string>",
    "companyId": "<string>",
    "owner": "<string>",
    "createdBy": "<string>",
    "creationTime": "2023-11-07T05:31:56Z",
    "lastInteraction": "2023-11-07T05:31:56Z"
  },
  "meta": {
    "request_id": "req_abc123",
    "api_version": "1",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Authorizations

X-Klipy-Api-Key
string
header
required

API key passed as a header

Body

application/json
email
string<email>
required
firstName
string
lastName
string
title
string
phone
string
personalPhone
string
linkedin
string
twitter
string
facebook
string
instagram
string
whatsapp
string
altEmails
string<email>[]
remarks
string

Response

Person upserted

object
string
required
Example:

"success"

data
object
required

The returned resource

meta
object
required
Last modified on April 5, 2026