Skip to main content
POST
/
users
Create User
curl --request POST \
  --url https://api.example.com/users \
  --header 'Content-Type: application/json' \
  --data '
{
  "githubId": "<string>",
  "email": "<string>",
  "username": "<string>",
  "name": "<string>",
  "avatarUrl": "<string>",
  "githubAccessToken": "<string>",
  "githubRefreshToken": "<string>"
}
'
{
  "id": 123,
  "githubId": "<string>",
  "email": "<string>",
  "username": "<string>",
  "name": "<string>",
  "avatarUrl": "<string>",
  "githubAccessToken": "<string>",
  "githubRefreshToken": "<string>",
  "installationId": 123,
  "createdAt": "<string>",
  "updatedAt": "<string>"
}
Create a new user in the system.

​
Request

​
Headers

No authentication required.

​
Body

​
githubId
string
required
GitHub ID of the user
​
email
string
Email address of the user (must be a valid email format)
​
username
string
GitHub username
​
name
string
Display name of the user
​
avatarUrl
string
URL to the user’s avatar image
​
githubAccessToken
string
required
GitHub OAuth access token
​
githubRefreshToken
string
required
GitHub OAuth refresh token

​
Response

Returns the created user object.
​
id
integer
required
Unique identifier for the user
​
githubId
string
required
GitHub ID of the user
​
email
string
Email address of the user
​
username
string
GitHub username
​
name
string
Display name of the user
​
avatarUrl
string
URL to the user’s avatar image
​
githubAccessToken
string
required
GitHub OAuth access token
​
githubRefreshToken
string
required
GitHub OAuth refresh token
​
installationId
integer
GitHub App installation ID
​
createdAt
string
required
ISO 8601 timestamp of when the user was created
​
updatedAt
string
required
ISO 8601 timestamp of when the user was last updated

​
Example

cURL
curl -X POST https://api.diffy.com/users \
  -H "Content-Type: application/json" \
  -d '{
    "githubId": "12345678",
    "email": "[email protected]",
    "username": "johndoe",
    "name": "John Doe",
    "avatarUrl": "https://avatars.githubusercontent.com/u/12345678",
    "githubAccessToken": "gho_xxxxxxxxxxxxx",
    "githubRefreshToken": "ghr_xxxxxxxxxxxxx"
  }'
Response
{
  "id": 1,
  "githubId": "12345678",
  "email": "[email protected]",
  "username": "johndoe",
  "name": "John Doe",
  "avatarUrl": "https://avatars.githubusercontent.com/u/12345678",
  "githubAccessToken": "gho_xxxxxxxxxxxxx",
  "githubRefreshToken": "ghr_xxxxxxxxxxxxx",
  "installationId": null,
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us