Skip to main content
POST
Add a person

Authorizations

Authorization
string
header
required

Bearer token created in ClearPolicy API settings with the api:use scope.

Body

application/json
last_name
string
required

The person's last name. Required.

Maximum string length: 255
email
string<email>
required

The email address. Must be unique within your organization.

Maximum string length: 255
first_name
string | null

The person's first name. Optional.

Maximum string length: 255
phone
string | null

Phone number in international format (e.g. +12025550147).

Response

The created person.

id
string
required

The ULID of the person.

organization_id
string
required

The ULID of the organization.

first_name
string | null
required

The person's first name, if provided.

last_name
string
required

The person's last name.

name
string
required

The full name assembled from first_name and last_name.

email
string<email>
required

The email address of the person.

source
enum<string>
required

How the person was created.

Available options:
oauth,
web,
system,
planning_center
created_at
string<date-time>
required

When the person was created.

updated_at
string<date-time>
required

When the person was last updated.

phone
string | null

The phone number in international format, or null.

source_id
string | null

An external identifier from the originating system, or null.

archived_at
string<date-time> | null

When the person was archived, or null if active.

Last modified on September 26, 2026