---
title: "POST /_system/security/methods/sms - System Security · RUAL Documentation"
description: "Create SMS-based 2FA authentication method"
canonical: https://docs.rual.nl/cluster/api/system-security/system-security-methods-sms-post
language: en
---

# POST /_system/security/methods/sms

Create SMS-based 2FA authentication method

| Key | Type | Example | Description |
| --- | --- | --- | --- |
| **[authorization](https://docs.rual.nl/cluster/api#token-providing)** required | `string` | `"Bearer access_token"` | Access token |

| Key | Type | Example | Description |
| --- | --- | --- | --- |
| **name** optional | `string` | `"My Phone"` |  |
| **phone_number** required | `string` | `"+1234567890"` |  |

```
{
  "sms_send": true
}
```

```
{
  "error": "ERROR_KEY"
}
```

| Permission | Description |
| --- | --- |
| `Bearer token` | Access token required via Authorization header, x-authtoken, x-token, query param, or cookie |
| `users_twofactorauth_create` | Required scope: users_twofactorauth_create |