Skip to content

Create an authentication session.

POST
/xrpc/com.atproto.server.createSession
object
password
required
string
identifier
required

Handle or other identifier supported by the server for the authenticating user.

string
allowTakendown

When true, instead of throwing error for takendown accounts, a valid response with a narrow scoped token will be returned

boolean
authFactorToken
string

Success

object
did
required
string format: did
email
string
active
boolean
didDoc
handle
required
string format: handle
status

If active=false, this optional field indicates a possible reason for why the account is not active. If active=false and no status is supplied, then the host makes no claim for why the repository is no longer being hosted.

string
accessJwt
required
string
refreshJwt
required
string
emailConfirmed
boolean
emailAuthFactor
boolean

Bad Request

object
error
required
One of:
string
message
required
string