Create a CRM Person - Zeeg Developer Hub

POST

crm

people

Create a CRM person

curl --request POST \
  --url https://api.zeeg.me/v2/crm/people \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "Jane",
  "lastName": "Doe",
  "salutation": "Ms",
  "emails": [
    "jane.doe@acme.com"
  ],
  "jobTitle": "Head of Product",
  "description": "<string>",
  "phoneNumber": "+4930123456789",
  "primaryLocation": "Berlin, Germany",
  "avatarUrl": "<string>",
  "companyId": "<string>",
  "socials": {
    "linkedin": "<string>",
    "twitter": "<string>",
    "facebook": "<string>",
    "instagram": "<string>"
  }
}
'

{
  "success": true,
  "status": 201,
  "person": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
    "firstName": "Jane",
    "lastName": "Doe",
    "salutation": "Ms",
    "emails": [
      "jane.doe@acme.com"
    ],
    "jobTitle": "Head of Product",
    "description": "Key decision-maker at Acme Corp.",
    "phoneNumber": "+4930123456789",
    "primaryLocation": "Berlin, Germany",
    "avatarUrl": null,
    "company": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "domain": "<string>"
    },
    "socials": {
      "linkedin": "https://linkedin.com/in/janedoe",
      "twitter": null,
      "facebook": null,
      "instagram": null
    },
    "customAttributes": {},
    "createdAt": "2025-01-15T09:00:00+00:00",
    "updatedAt": "2025-06-01T12:00:00+00:00"
  }
}

Creates a new CRM person record.

Name requirement

At least one of firstName or lastName must be provided.

Associating with a company

Pass companyId with the UUID of an existing CRM company to link the person to that company. Pass social profile URLs as a nested socials object:

{
  "firstName": "Jane",
  "lastName": "Doe",
  "socials": {
    "linkedin": "https://linkedin.com/in/janedoe",
    "twitter": "https://twitter.com/janedoe"
  }
}

Authorizations

Authorization

string

header

required

Body

application/json

firstName

string | null

First name. Required if lastName is not provided.

Example:

"Jane"

lastName

string | null

Last name. Required if firstName is not provided.

Example:

"Doe"

salutation

string | null

Salutation or title.

Example:

"Ms"

emails

string<email>[] | null

List of email addresses. The first entry becomes the primary email.

Example:

["jane.doe@acme.com"]

jobTitle

string | null

Job title or role.

Example:

"Head of Product"

description

string | null

Free-text description or notes.

phoneNumber

string | null

Primary phone number.

Example:

"+4930123456789"

primaryLocation

string | null

Primary location or city.

Example:

"Berlin, Germany"

avatarUrl

string | null

URL of the person's avatar image.

companyId

string | null

UUID of the CRM company to associate this person with.

socials

object

Social profile links.

Hide child attributes

socials.linkedin

string | null

socials.twitter

string | null

socials.facebook

string | null

socials.instagram

string | null

Response

Created

success

boolean

Example:

true

status

integer

Example:

201

person

object

A CRM person record.

Hide child attributes

person.id

string<uuid>

required

Unique identifier for the person record.

Example:

"b2c3d4e5-f6a7-8901-bcde-f23456789012"

person.firstName

string | null

required

First name.

Example:

"Jane"

person.lastName

string | null

required

Last name.

Example:

"Doe"

person.salutation

string | null

required

Salutation or title (e.g. Mr, Ms, Dr).

Example:

"Ms"

person.emails

string<email>[]

required

List of email addresses. The first entry is the primary email.

Example:

["jane.doe@acme.com"]

person.jobTitle

string | null

required

Job title or role.

Example:

"Head of Product"

person.description

string | null

required

Free-text description or notes about the person.

Example:

"Key decision-maker at Acme Corp."

person.phoneNumber

string | null

required

Primary phone number.

Example:

"+4930123456789"

person.primaryLocation

string | null

required

Primary location or city.

Example:

"Berlin, Germany"

person.avatarUrl

string | null

required

URL of the person's avatar image.

Example:

null

person.company

object

required

The company this person is associated with, if any.

Hide child attributes

person.company.id

string<uuid>

person.company.name

string | null

person.company.domain

string | null

person.socials

object

required

Social profile links.

Hide child attributes

person.socials.linkedin

string | null

Example:

"https://linkedin.com/in/janedoe"

person.socials.twitter

string | null

Example:

null

person.socials.facebook

string | null

Example:

null

person.socials.instagram

string | null

Example:

null

person.customAttributes

object

required

Key/value pairs for custom attributes defined on the people object.

Example:

{}

person.createdAt

string<date-time>

required

ISO 8601 timestamp when the record was created.

Example:

"2025-01-15T09:00:00+00:00"

person.updatedAt

string<date-time>

required

ISO 8601 timestamp when the record was last updated.

Example:

"2025-06-01T12:00:00+00:00"

Last modified on May 7, 2026

Get a CRM Person

Assert a CRM Person

Create a CRM person

curl --request POST \
  --url https://api.zeeg.me/v2/crm/people \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "Jane",
  "lastName": "Doe",
  "salutation": "Ms",
  "emails": [
    "jane.doe@acme.com"
  ],
  "jobTitle": "Head of Product",
  "description": "<string>",
  "phoneNumber": "+4930123456789",
  "primaryLocation": "Berlin, Germany",
  "avatarUrl": "<string>",
  "companyId": "<string>",
  "socials": {
    "linkedin": "<string>",
    "twitter": "<string>",
    "facebook": "<string>",
    "instagram": "<string>"
  }
}
'

{
  "success": true,
  "status": 201,
  "person": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
    "firstName": "Jane",
    "lastName": "Doe",
    "salutation": "Ms",
    "emails": [
      "jane.doe@acme.com"
    ],
    "jobTitle": "Head of Product",
    "description": "Key decision-maker at Acme Corp.",
    "phoneNumber": "+4930123456789",
    "primaryLocation": "Berlin, Germany",
    "avatarUrl": null,
    "company": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "domain": "<string>"
    },
    "socials": {
      "linkedin": "https://linkedin.com/in/janedoe",
      "twitter": null,
      "facebook": null,
      "instagram": null
    },
    "customAttributes": {},
    "createdAt": "2025-01-15T09:00:00+00:00",
    "updatedAt": "2025-06-01T12:00:00+00:00"
  }
}

Documentation Index

​Name requirement

​Associating with a company

​Social links

Authorizations

Body

Response

Name requirement

Associating with a company

Social links