Social accounts

Connected social profiles (TikTok, YouTube, Twitter, etc.) belonging to the authenticated user.

Resource shape

{
  "id": 17,
  "platform_id": "tiktok",
  "account_url": "https://tiktok.com/@example",
  "uid": "1234567890",
  "status": "verified",
  "subscriber_count": 12345,
  "view_count": 9876543,
  "video_count": 42,
  "likes_count": 100000,
  "engagement_rate": "5.2",
  "last_synced_at": "2026-05-05T07:55:00Z",
  "created_at": "2026-04-01T10:00:00Z",
  "updated_at": "2026-05-05T07:55:00Z",
  "url": "https://hypemarket.ai/me/social_accounts/17.json"
}

status is one of pending, verified, failed. Metric fields (subscriber_count etc.) read from the latest snapshot and may be null for newly connected accounts that haven’t been synced yet.

List

GET /me/social_accounts.json

Returns an array of social accounts belonging to the authenticated user. Paginated — see response headers Total-Count, Total-Pages.

Show

GET /me/social_accounts/:id.json

Returns one. Sets an ETag — supply If-None-Match for 304 Not Modified.

Create

POST /me/social_accounts.json

{ "social_account": { "platform_id": "twitter", "account_url": "https://x.com/example" } }

Requires a write-scoped token. Returns 201 Created with the new resource.

Delete

DELETE /me/social_accounts/:id.json

Requires a write-scoped token. Returns 204 No Content.

Errors

Code	When
`401`	Missing token, or read token attempting `POST`/`DELETE`
`404`	Account does not exist or doesn’t belong to you
`422`	Validation failed (e.g. duplicate `account_url`)