---
title: "Request SMS login code"
method: POST
path: "/auth/sms/request"
tags: ["auth"]
---

# Request SMS login code

`POST /auth/sms/request`

## Request

- Base URL: `https://api.instruxi.dev/api/v1/enforcer`
- URL: `https://api.instruxi.dev/api/v1/enforcer/auth/sms/request`
- Auth: none declared

Public: starts a Twilio Verify SMS login challenge to `phone`, scoped by `tenant_code`. 400 if SMS verification isn't configured for the tenant (no Verify client wired or no active Twilio connection) or if rate-limited. An expired workspace code gets 404 `tenant_code_expired`.

## Request body

- InternalDeliveryHttpHandlerRequestSMSRequest
  - `phone` string
  - `tenant_code` string

## Response `200`

OK

- InternalDeliveryHttpHandlerMessageResponse
  - `message` string
  - `success` boolean

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/instruxi/apis/enforcer-api.md) · [All operations](https://skmtc.dev/instruxi/apis/enforcer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/instruxi/apis/enforcer-api/revisions/fa82bc1becc0?raw)
