Profile Management

Manage professional profiles programmatically. Every PingRep user can have multiple profiles, each representing a different professional identity (realtor, consultant, speaker, etc.).

Authentication required

All profile management endpoints require a valid JWT or API key. See Authentication for setup.

Create a profile

POST

/api/v1/profiles

API Key

Create a new professional profile. Accepts multipart form data for photo upload.

Request body (multipart/form-data)

namestringRequired

Full professional name.

titlestringRequired

Job title or professional role.

companystringOptional

Company or organization name.

biostringOptional

Professional biography. Supports plain text.

locationstringOptional

City, state, or country.

photoFileOptional

Profile photo. Accepts JPEG or PNG, max 5 MB.

verticalstringOptional

Professional vertical (e.g. real-estate, consulting, tech).

List all profiles

GET

/api/v1/profiles/all

API Key

List all profiles belonging to the authenticated user.

Returns an array of profile objects. Useful for account management dashboards or profile switchers.

Get primary profile

GET

/api/v1/profiles/me

API Key

Get the authenticated user's primary profile.

Get a specific profile

GET

/api/v1/profiles/{profile_id}

API Key

Get a profile by its unique ID.

Update a profile

PATCH

/api/v1/profiles/{profile_id}

API Key

Update one or more fields on an existing profile.

Send only the fields you want to change. All fields are optional in a PATCH request.

Delete a profile

DELETE

/api/v1/profiles/{profile_id}

API Key

Permanently delete a profile. This action cannot be undone.

Destructive action

Deleting a profile removes all associated data including social links, work experience, and education entries. Contacts who saved this profile will see a "Profile removed" notice.

Profile response schema

idstring (uuid)Required

Unique profile identifier.

slugstringRequired

URL-safe profile slug.

namestringRequired

Full professional name.

titlestringRequired

Job title or role.

companystringRequired

Company or organization.

biostringRequired

Professional biography.

locationstringRequired

Geographic location.

photoUrlstringRequired

URL to profile photo.

isPublicbooleanRequired

Whether the profile is published and visible in the directory.

headlinestringRequired

Auto-generated or custom one-line headline.

skillsstring[]Required

List of professional skills.

workExperiencesobject[]Required

Array of work experience entries.

educationobject[]Required

Array of education entries.

socialLinksobject[]Required

Array of social link objects (platform, url).

createdAtstring (ISO 8601)Required

When the profile was created.

updatedAtstring (ISO 8601)Required

When the profile was last modified.