/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog

Log In

Sign in with email and password and start a browser session.

POST/v1/auth/loginTry it
Session token

Signs in with email and password and starts a browser session: a 1-hour access token and a 30-day refresh token.

Note

Public — no credential needed. Any plan.

Request Body

NameDescription
email:stringbodyRequired
The account's email address.
password:stringbodyRequired
The account's password.
timezone:stringbody
The browser's IANA timezone, e.g. America/New_York. Replaces the one stored on the account. An invalid value is ignored, not rejected.
country:stringbody
The browser's ISO 3166-1 alpha-2 country code, e.g. US. Replaces the one stored on the account. An invalid value is ignored, not rejected.

timezone and country are hints for when and how Syntext emails you. They're never used for access decisions.

Response — 200 OK

NameDescription
orgId:string | nullbody
The workspace the access token is issued for — the first of your memberships — or null when you belong to none.
orgs:arraybody
Every workspace you belong to, with your role in each, so a client can offer a workspace switcher.

Error Responses

401 Unauthorized

unauthorized — the email or password is wrong. The message is the same for both, so it doesn't reveal whether an account exists.

json
{
"error": {
"code": "unauthorized",
"message": "Invalid email or password",
"details": { "traceId": "6f1c2a9e-3b7d-4c11-9a0e-2d5f8b4c7e10" }
}
}

400 Bad Request

validation_error — email or password is missing, or email isn't an email address.

Was this page helpful? Yes No
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl -X POST https://api.syntext.dev/v1/auth/login \
-H "Content-Type: application/json" \
-d '{
"email": "alex@example.com",
"password": "a much longer passphrase",
"timezone": "America/New_York",
"country": "US"
}'
Responseapplication/json
200OK
{
"data": {
"user": { "id": "0b7e4c2d-9a1f-4d3e-8c56-2f1a7b9e0d48", "email": "alex@example.com", "name": "Alex Rivera" },
"orgId": "9c2e7a14-5b3d-4f86-a1e0-7d4b2c9f6e31",
"orgs": [
{ "id": "9c2e7a14-5b3d-4f86-a1e0-7d4b2c9f6e31", "role": "owner" }
],
"accessToken": "eyJhbGciOiJIUzI1NiIs...",
"refreshToken": "2f8c1e9a7b...",
"expiresIn": 3600
}
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext