Upsert one social account
Accepts exactly one handle or profile URL at the top level. Changes the shared user, so all memberships see the edit. The existing lifecycle invalidates MySite caches; an actual change publishes profiles.updated with changed_fields=[socials] after commit. Unchanged values are a no-op. Only writable member tokens may write; member and portal JWTs return 403.
x accepts x.com and twitter.com URLs; LinkedIn URLs must use /in/handle. YouTube normalizes bare handle input to @handle and supports channel/, c/, or user/ profile paths. Full YouTube URLs must already use one of these profile forms, including the @ prefix for a handle URL. WhatsApp uses an international number or wa.me URL. WeChat accepts a handle only and returns a null URL. For other platforms use a single profile handle, not a post URL. URLs may include www and a trailing slash. Query strings, fragments, custom ports and credentials are unsupported. Unknown or read-only fields return 422. Writes do not use the read cache policy.
Authorizations
A member credential in the Authorization: Bearer header: a member
session JWT, a portal JWT whose login is linked to a membership in
that company, or a member token. The credential alone
identifies the member and company.
Path Parameters
Supported social platform; unknown keys return 422.
facebook, instagram, x, linkedin, whatsapp, wechat, youtube, tiktok, pinterest "x"
Body
- Option 1
- Option 2
Exactly one handle or full HTTP(S) profile URL for the selected platform.
Account handle; WhatsApp uses international digits with an optional leading plus. YouTube also accepts channel/, c/, and user/ paths.
1 - 255\S"rae_kim"
Full profile URL on the selected platform. Unsupported paths, query strings, fragments, credentials and custom ports are refused.
1 - 2048"https://x.com/rae_kim"