Sign in

v46

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-211591,0051.4 MB
Users

Add or update a user linked account

Adds or updates a linked account for a user. This endpoint is not yet available to all users.

post/v1/users/{user_id}/accounts

Path parameters

user_idstring required

ID of the user.

Headers

privy-app-idstring required

ID of your Privy app.

Request body

OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR

Response

User with updated linked account.

created_atnumber required

Unix timestamp of when the user was created in seconds.

custom_metadataCustomMetadata

Custom metadata associated with the user.

has_accepted_termsboolean required

Indicates if the user has accepted the terms of service.

idstring required
is_guestboolean required

Indicates if the user is a guest account user.

Example response

{
  "created_at": 1731974895,
  "has_accepted_terms": true,
  "id": "did:privy:cm3np4u9j001rc8b73seqmqqk",
  "is_guest": false,
  "linked_accounts": [
    {
      "address": "tom.bombadill@privy.io",
      "first_verified_at": 1674788927,
      "latest_verified_at": 1674788927,
      "type": "email",
      "verified_at": 1674788927
    },
    {
      "bio": "engineering at /privy. building pixelpool.xyz, the first Farcaster video client. nyc. 👨‍💻🍎🏳️‍🌈  nf.td/payton",
      "display_name": "payton ↑",
      "fid": 4423,
      "first_verified_at": 1740678402,
      "latest_verified_at": 1741194370,
      "owner_address": "0xE6bFb4137F3A8C069F98cc775f324A84FE45FdFF",
      "profile_picture": "https://supercast.mypinata.cloud/ipfs/QmNexfCxdnFzWdJqKVgrjd27UGLMexNaw5FXu1XKR3cQF7?filename=IMG_2799.png",
      "profile_picture_url": "https://supercast.mypinata.cloud/ipfs/QmNexfCxdnFzWdJqKVgrjd27UGLMexNaw5FXu1XKR3cQF7?filename=IMG_2799.png",
      "type": "farcaster",
      "username": "payton",
      "verified_at": 1740678402
    },
    {
      "authenticator_name": "1Password",
      "created_with_browser": "Chrome",
      "created_with_device": "Macintosh",
      "created_with_os": "Mac OS",
      "credential_id": "Il5vP-3Tm3hNmDVBmDlREgXzIOJnZEaiVnT-XMliXe-BufP9GL1-d3qhozk9IkZwQ_",
      "enrolled_in_mfa": true,
      "first_verified_at": 1741194420,
      "latest_verified_at": 1741194420,
      "public_key": "pQECAyYgASFYIKdGwx5XxZ/7CJJzT8d5L6jyLNQdTH7X+rSZdPJ9Ux/QIlggRm4OcJ8F3aB5zYz3T9LxLdDfGpWvYkHgS4A8tPz9CqE=",
      "type": "passkey",
      "verified_at": 1741194420
    }
  ],
  "mfa_methods": [
    {
      "type": "passkey",
      "verified_at": 1741194420
    }
  ]
}