Sign in

v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
profiles

Add social link

Add a social link to the authenticated user's profile.

Supported platforms: x, github, discord, farcaster, lens, telegram, youtube, substack, website, instagram, linkedin, medium, reddit, soundcloud, tiktok, custom

  • "twitter" is accepted and normalized to "x"
  • Platform names are case-insensitive
  • Only one link per platform per account is allowed (except "custom" — multiple allowed)
  • Each social link URL is globally unique (first-come-first-serve)
  • YouTube: accepts @handle or full channel URL, normalized to canonical URL
  • Website: accepts domain or full URL, normalized to https://domain
  • GitHub: accepts username or full URL, normalized to https://github.com/username

Note: Links are unverified by default. Verification support coming in a future release.

Authentication: Authorization: Bearer <CLIENT_JWT>

post/v1/account/social-links

Headers

authorizationstring nullable

Bearer JWT issued by Grove that identifies the account.

Bearer JWT issued by Grove that identifies the account.

Request body

platformstring required

Platform name (x, twitter, github, youtube, website, etc.)

urlstring required

URL, handle, or identifier for the social profile

display_namestring nullable

Optional display label for this link (e.g., 'Shop', 'Blog'). Useful for custom links.

Response

Successful Response

idstring required

Identity ID for the social link

platformstring required

Platform name

urlstring required

Full URL to the social profile

verifiedboolean

Whether ownership has been verified

verified_atstring nullable

When ownership was verified (ISO 8601)

verification_methodstring nullable

How ownership was verified (e.g., oauth_youtube)

created_atstring required

When the link was added (ISO 8601)

display_namestring nullable

Display name from the platform profile