Skip to main content
POST
/
v1
/
people
Create or upsert a person
curl --request POST \
  --url https://thanos.notealy.com/v1/people \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "channel": "WHATSAPP",
  "phone": "<string>",
  "email": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "jobTitle": "<string>",
  "companyId": "<string>",
  "companyName": "<string>",
  "city": "<string>",
  "description": "<string>",
  "externalId": "<string>",
  "customFields": {},
  "tagIds": [
    "<string>"
  ]
}
'
{
  "statusCode": 400,
  "message": "Validation failed",
  "error": "Bad Request"
}

Documentation Index

Fetch the complete documentation index at: https://docs.notealy.com/llms.txt

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

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
required

Display name (required). Used for attribution and UX.

Required string length: 1 - 500
channel
enum<string>

Contact channel; defaults to WEB (typical web lead). When WHATSAPP, phone is required.

Available options:
WHATSAPP,
EMAIL,
INSTAGRAM,
FACEBOOK,
TIKTOK,
TELEGRAM,
PHONE,
WEB,
OTHER
phone
string

10–15 digits, optional +

email
string

Required when channel is not WHATSAPP if phone is empty (validated in service)

firstName
string
lastName
string
jobTitle
string
companyId
string
companyName
string
city
string
description
string
externalId
string
customFields
object
tagIds
string[]

Tag IDs to attach. Tags must already exist in the org. Only newly attached tags emit tag_added (idempotent on retry).

Response

The created or updated person