Create a person

Creates a new person in your organization. Optionally auto-creates a company if companyName is provided. Custom fields can be set on creation.

Body

required

application/json

email
Type: stringFormat: email
required
firstName
Type: string
min length:
1
max length:
100
required
address
Type: string
max length:
500
companyId
Type: stringFormat: uuid

Link to existing company
companyName
Type: string
max length:
200

Auto-create company with this name (ignored if companyId provided)
customFields
Type: object

Custom field values keyed by field key (e.g. cf_favorite_color)
isConnector
Type: boolean

Mark this person as a connector
isSolutionProvider
Type: boolean

Mark this person as a solution provider
lastName
Type: string
max length:
100
phoneNumber
Type: string
max length:
50

Responses

application/json
application/json
application/json
application/json

post/api/people

curl https://api.introzy.com/api/people \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "email": "john@acme.com",
  "firstName": "John",
  "lastName": "Doe",
  "phoneNumber": "+1 555-123-4567",
  "address": "123 Main St, San Francisco, CA 94102",
  "companyId": "",
  "companyName": "Acme Inc",
  "isSolutionProvider": false,
  "isConnector": false,
  "customFields": {
    "cf_favorite_color": "blue",
    "cf_budget": 50000
  }
}'

Show Schema

{
  "success": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "email": "john@acme.com",
    "firstName": "John",
    "lastName": "Doe",
    "phoneNumber": "+1 555-123-4567",
    "address": "123 Main St, San Francisco, CA 94102",
    "latitude": 1,
    "longitude": 1,
    "jobTitle": "Head of Platform",
    "bio": "string",
    "skills": [
      "PostgreSQL",
      "Kubernetes"
    ],
    "linkedinUrl": "https://linkedin.com/in/johndoe",
    "avatarUrl": "string",
    "companyId": "123e4567-e89b-12d3-a456-426614174000",
    "isConnector": true,
    "isSolutionProvider": true,
    "isFullUser": true,
    "customFields": {
      "cf_favorite_color": "blue",
      "cf_budget": 50000
    },
    "company": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Acme Inc",
      "industry": "string",
      "website": "string",
      "isSolutionProvider": true,
      "isConnector": true,
      "customFields": {}
    },
    "createdAt": "2026-10-28T00:33:51.465Z",
    "updatedAt": "2026-10-28T00:33:51.465Z"
  },
  "message": "Person created successfully"
}

Person created

List people

Get a person