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)

  • lastName
    Type: string
    max length:  
    100
  • phoneNumber
    Type: string
    max length:  
    50
Responses
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/api/people
curl https://beta-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",
  "customFields": {
    "cf_favorite_color": "blue",
    "cf_budget": 50000
  }
}'

{
  "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,
    "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",
      "customFields": {}
    },
    "createdAt": "2026-05-20T14:22:03.111Z",
    "updatedAt": "2026-05-20T14:22:03.111Z"
  },
  "message": "Person created successfully"
}

Person created

Introzy API Documentation