Skip to main content

Login

Sign in with your email and password to receive a Bearer token. Use this token in the Authorization header for all other API requests.

POST https://api.ravenwits.com/api/v0/auth/login/

No authentication required.


Request body

FieldTypeRequiredDescription
emailstringYesYour account email
passwordstringYesYour account password

Request

curl --request POST \
--url https://api.ravenwits.com/api/v0/auth/login/ \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{"email": "your-email@example.com", "password": "your-password"}'

Replace the JSON body with your credentials.


Responses

200 OK — Success

Returns your token and account info.

FieldTypeDescription
tokenstringBearer token for authenticated requests
expires_atstringISO 8601 datetime when the token expires
customer_namestringYour display name
customer_emailstringYour email

Example response body:

{
"token": "abc123...",
"expires_at": "2025-03-15T12:00:00Z",
"customer_name": "Your Name",
"customer_email": "your-email@example.com"
}

400 Bad Request

Missing email or password.

{"error": "Both 'email' and 'password' are required."}

401 Unauthorized

Invalid credentials or account not configured.

{"error": "Invalid credentials; email not found."}
{"error": "Invalid credentials; incorrect password."}
{"error": "Account not configured. Please contact support."}