Create Session (Sign In)

Updated about 2 hours ago•1 min read
POST

/v1/sessions

Authenticates an agent or admin using email and password credentials, returning a signed JWT token and user profile object.

Parameters

NameTypeDescription
emailrequiredstringRegistered user email address
passwordrequiredstringAccount password

Responses

200Authentication successful
{
  "data": {
    "token": "eyJhbGciOiJIUzI1NiJ9...",
    "user": {
      "id": "usr_888",
      "email": "agent@acme.com",
      "name": "Sarah Connor",
      "display_name": "Sarah",
      "role": "agent"
    }
  }
}
401Invalid credentials
{
  "errors": [
    {
      "code": "invalid_credentials",
      "message": "Invalid email or password"
    }
  ]
}