ETERA API Documentation

curl -X POST https://api.etera.dev/auth/phone-number/change \
     -H "Content-Type: application/json" \
     -d '{
  "phoneNumber": "589595029",
  "countryCode": "+971",
  "code": "123456"
}'

{
  "user": {
    "id": "user_123456",
    "email": "user@example.com",
    "phoneNumberVerified": true,
    "emailVerified": true,
    "createdAt": "2023-01-01T00:00:00.000Z",
    "updatedAt": "2023-01-01T12:00:00.000Z",
    "name": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "image": "https://example.com/avatar.jpg",
    "phoneNumber": "+1234567890",
    "language": "en",
    "deviceTokens": [
      "fGzQ9k4FmkE:APA91bH...",
      "eXjP8l2AmcN:APA91bK..."
    ]
  },
  "session": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "expiresAt": "2023-01-08T00:00:00.000Z"
  },
  "isNewUser": true
}

Changes the user's phone number after verifying the OTP. Requires Authorization header. Optionally sets user's preferred language.

Request

This endpoint expects an object.

phoneNumberstringRequired

New phone number without country code (e.g., 589595029)

countryCodestringRequired

Country calling code with + prefix (e.g., +971, +1, +44)

codestringRequired

The OTP code received via SMS

languagestringOptional

Optional: User’s preferred language (e.g., ‘en’, ‘ar’, ‘fr’)

Response

Phone number changed successfully

userobject

sessionobject

isNewUserboolean

Whether this is a new user registration

Change phone number

Request

Response

Errors