Get user

GET https://api.gumroad.com/v2/user

Returns information about the currently authenticated user (the seller/creator account associated with the access token).

Authentication

Requires OAuth scope: view_public or any public scope

Response

boolean

required

Whether the request was successful

object

required

The user object

Show User object properties

string

The user’s unique identifier

string

The user’s email address

string

The user’s display name

string

The user’s Gumroad profile URL

string

The user’s Twitter handle (if connected)

string

The user’s Facebook profile URL (if connected)

Example request

curl "https://api.gumroad.com/v2/user" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch('https://api.gumroad.com/v2/user', {
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
  }
});
const data = await response.json();

import requests

response = requests.get(
    'https://api.gumroad.com/v2/user',
    headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://api.gumroad.com/v2/user')
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_ACCESS_TOKEN'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

data = JSON.parse(response.body)

Example response

Success

{
  "success": true,
  "user": {
    "id": "abc123",
    "email": "creator@example.com",
    "name": "Jane Creator",
    "url": "https://gumroad.com/janecreator",
    "twitter_handle": "janecreator",
    "facebook_profile": "https://facebook.com/janecreator"
  }
}

Unauthorized

{
  "success": false,
  "message": "Unauthorized"
}

Use cases

Account verification

Verify the authenticated user’s identity before performing operations

Profile display

Display the creator’s information in your application

Multi-account management

Identify which Gumroad account is currently connected

OAuth flow completion

Retrieve user details after OAuth authorization

Notes

This endpoint is often used immediately after OAuth authentication to get the user’s profile information.

The fields returned may vary based on what the user has configured in their profile settings.

Authentication

Learn how to authenticate API requests

Products API

List products owned by the user

Getting Started

Products

Sales

Licenses

Subscribers

Other Resources

Authentication

Response

Example request

Example response

Use cases

Account verification

Profile display

Multi-account management

OAuth flow completion

Notes

See also

Authentication

Products API

​Authentication

​Response

​Example request

​Example response

​Use cases

Account verification

Profile display

Multi-account management

OAuth flow completion

​Notes

​See also

Authentication

Products API

Authentication

Response

Example request

Example response

Use cases

Notes

See also