API Reference
Managed Users
Managed Users groups customer-owned social accounts by your own `external_user_id`. This is the bridge between your product's user model and the accounts that UniPost manages on their behalf.
Overview
When you use Connect sessions, UniPost stores the resulting social accounts and associates them with the `external_user_id` you passed in. Managed Users gives you a way to inspect that grouping directly.
List users
Use the users list when you want to know which of your end users have connected accounts, how many platforms they have connected, and whether any reconnect work is required.
curl https://api.unipost.dev/v1/users \
-H "Authorization: Bearer up_live_xxxx"What you get back
| Field | Meaning |
|---|---|
| external_user_id | Your own stable end-user identifier |
| external_user_email | Optional email captured during onboarding |
| account_count | Total number of connected accounts for that user |
| platform_counts | Breakdown by social platform |
| reconnect_count | How many accounts need reconnect attention |
User detail
The detail endpoint returns the actual social account rows for one end user. That is the right endpoint for rendering a “connected accounts” page in your own product.