SceniqDevelopers

set_profile_socials

Replace the social links on the profile.

PUT/v1/profile/socials
MCP tool set_profile_socialsScope: writeStableSince 2026-09-17
Markdown

Full replacement: [{ platform: instagram|tiktok|youtube, handle, url, followerCount? }], at most 6.

curl -X PUT "https://sceniq.earth/api/v1/profile/socials" \
  -H "Authorization: Bearer $SCENIQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "socials": [
    {
      "platform": "instagram",
      "handle": "mara.firstlight",
      "url": "https://www.instagram.com/mara.firstlight/",
      "followerCount": 184000
    },
    {
      "platform": "youtube",
      "handle": "marafirstlight",
      "url": "https://www.youtube.com/@marafirstlight",
      "followerCount": 52300
    },
    {
      "platform": "tiktok",
      "handle": "mara.firstlight",
      "url": "https://www.tiktok.com/@mara.firstlight"
    }
  ]
}'

Body parameters

  • socialsarray of SocialLinkrequired

    The complete list of social links.

    Show 4 fieldsof SocialLink
    • platformstringrequired

      instagram, tiktok or youtube.

      instagramtiktokyoutube
    • handlestringrequired

      The account name (@name). Required on the profile; the link pill shows it when there is no follower count.

    • urlstringrequired

      The profile page (https; set_profile_socials refuses other links). An empty url on a sales page falls back to the link built from platform and handle.

    • followerCountnumberoptional

      Followers as the creator states them, a whole number from 0, shown on the pill (12K) instead of the handle.

Returns

200 OK with Profile: The creator's public profile.

  • creatorIdstring · creator idrequired

    The creator's id.

  • slugstringrequired

    The creator's URL slug (read-only).

  • displayNamestringrequired

    The public brand name.

  • realNamestring or nullrequired

    The legal name on the studio profile.

  • biostring or nullrequired

    The bio.

  • emailstringrequired

    The login email (read-only).

  • avatarUrlstring or nullrequired

    The avatar.

  • socialsarray of SocialLinkrequired

    Social links.

    Show 4 fieldsof SocialLink
    • platformstringrequired

      instagram, tiktok or youtube.

      instagramtiktokyoutube
    • handlestringrequired

      The account name (@name). Required on the profile; the link pill shows it when there is no follower count.

    • urlstringrequired

      The profile page (https; set_profile_socials refuses other links). An empty url on a sales page falls back to the link built from platform and handle.

    • followerCountnumberoptional

      Followers as the creator states them, a whole number from 0, shown on the pill (12K) instead of the handle.

  • rolestringrequired

    The key owner's role on the creator account.

    ownereditor
Response 200
{
  "creatorId": "k97c2m4vx8r1q0d6s5t3n9p2w7y4h8b1",
  "slug": "mara-lindgren",
  "displayName": "Mara Lindgren",
  "realName": null,
  "bio": "Landscape photographer. I plan every trip around the light and share the exact spots, times and parking so you can do the same.",
  "email": "mara@example.com",
  "avatarUrl": "https://quiet-heron-512.convex.cloud/api/storage/mara-lindgren-avatar.webp",
  "socials": [
    {
      "platform": "instagram",
      "handle": "mara.firstlight",
      "url": "https://www.instagram.com/mara.firstlight/",
      "followerCount": 184000
    },
    {
      "platform": "youtube",
      "handle": "marafirstlight",
      "url": "https://www.youtube.com/@marafirstlight",
      "followerCount": 52300
    },
    {
      "platform": "tiktok",
      "handle": "mara.firstlight",
      "url": "https://www.tiktok.com/@mara.firstlight"
    }
  ],
  "role": "owner"
}

Errors

Every error is { error: { code, message } }. Act on the code.

  • 400invalid_argumentA required field is missing, a field is unknown, or a value does not match its type (the Convex validator's path and value are in the message).
  • 400invalid_requestA writer refused a value: a map link on a host that is not allowed, a title that is too long, a date that does not exist, too many items in a list. The message is the writer's own sentence.
  • 401unauthenticatedThe request carries no key. Send it as Authorization: Bearer sk_sceniq_... (or X-Api-Key).
  • 401invalid_api_keyThe key is unknown, revoked or expired.
  • 403api_scope_requiredA read-only key called a write operation, or a key without the publish option called publish_changes.
  • 403forbiddenThe key belongs to a creator account that is no longer active.
  • 413payload_too_largeA JSON body over 2 MB, an image over 6 MB, a batch upload over 19 MB, or an MCP message over 2 MB.
  • 429rate_limitedOver a limit: requests per key per minute, per creator per hour, uploads per key per minute, or check_links per guide per hour.
  • 500internal_errorAn unexpected failure. The message is hidden on purpose.