Profile data model
View field support, webhooks, and list parameters for each integration on the Supported Integrations page.
| Field | Type | Required | Description |
|---|---|---|---|
id | string | No | Unique identifier for the profile |
created_at | string (date-time) | No | When the profile was created (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) |
updated_at | string (date-time) | No | When the profile was last updated (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) |
name | string | No | Display name of the profile |
username | string | No | Handle/username/store code |
parent_id | string | No | Parent profile id when profiles are nested (e.g. account → location) |
description | string | No | Bio or description of the profile |
url | string | No | Public URL of the profile |
website_url | string | No | External website linked from the profile |
avatar_url | string | No | Profile image URL |
phone | string | No | Contact phone number |
location | string | No | Free-text location/locale string |
address | object | No | Structured postal address |
address.address1 | string | No | |
address.address2 | string | No | |
address.city | string | No | |
address.region | string | No | |
address.postal_code | string | No | |
address.country | string | No | |
category | string | No | Primary category of the profile |
is_verified | boolean | No | Whether the profile is verified |
is_private | boolean | No | Whether the profile is private/protected |
metrics | object | No | Audience metrics for the profile |
metrics.follower_count | number | No | Number of followers |
metrics.following_count | number | No | Number of accounts this profile follows |
metrics.post_count | number | No | Total number of posts published by this profile |
Are we missing anything? Let us know