Skip to main content
POST
/
v1
/
api
/
auth
/
sessions
Create an API auth session
curl --request POST \
  --url https://public.api.paragraph.com/api/v1/api/auth/sessions \
  --header 'Content-Type: application/json' \
  --data '
{
  "deviceName": "<string>",
  "callbackUrl": "<string>"
}
'
{
  "sessionId": "<string>",
  "verificationUrl": "<string>",
  "expiresAt": "<string>"
}

Body

application/json

Body

deviceName
string

Name of the device requesting access (e.g. user@MacBook-Pro.local)

Maximum string length: 100
callbackUrl
string<uri>

HTTPS callback URL to redirect the user to after approving the session

Maximum string length: 2048

Response

Session created successfully

sessionId
string
required

Unique session identifier

verificationUrl
string
required

URL to open in the browser to approve the session

expiresAt
string
required

ISO 8601 timestamp when the session expires