Log in user with password
POST
/auth/login
How to use it: Send a POST request to
/auth/login with the request body, query parameters, or multipart fields shown below. Authentication endpoint. It does not use the broker integration API key in the same way as /v1/... endpoints.Successful response: HTTP 200. The body follows the endpoint schema; many integration endpoints wrap the useful payload under
data with status and message.Common error states:
400 invalid request body, query, ObjectId, pagination, file format, or missing required field.401 missing, invalid, expired, or insufficient API key/token.403 key is valid but cannot access this community/channel/user/resource, where supported by the service.404 target resource, route, or community-scoped record was not found.409 duplicate or conflicting state for create/update operations, where applicable.500 unexpected Returning.AI service error.Request
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.returning.ai/auth/login' \
--header 'Content-Type: application/json' \
--data-raw '{
"email": "savade@koletter.com",
"password": "@Password123",
"host": "ic.genesiv.com"
}'Response Response Example
200 - Success Example
{
"meta": {
"success": true,
"message": "Login success",
"devMessage": "Login success"
},
"body": {
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjE0NTA3NSIsImlhdCI6MTc0NjAwMTY1MywiZXhwIjoxNzQ2MDg4MDUzfQ.a-ee52XuvMtnV4tGgapFDNOh8kvGxswvzMJujSUFLxU",
"refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjE0NTA3NSIsImlhdCI6MTc0NjAwMTY1MywiZXhwIjoxNzQ2NjA2NDUzfQ.Vuy6Va2QdkwPpsLpx1rurIkv9EcxM1zJapXz0Vj9f_U"
}
}Modified at 2026-05-18 17:03:37