# Create Verification Code

<table data-header-hidden><thead><tr><th width="74.8046875" align="center"></th><th></th></tr></thead><tbody><tr><td align="center"><mark style="color:blue;"><strong>POST</strong></mark> </td><td>https://api.sfox.com/v1/enterprise/users/send-verification/:user_id</td></tr></tbody></table>

Create an email or sms verification code for your user.

***

Creating a verification code will send a 6-digit numerical OTP code directly to the end user via email or SMS, according to the specified `type`. Collect this code from the end user and verify it by executing a [Confirm Verification Code](https://docs.sfox.com/connect/rest-api/end-users/confirm-verification-code) request.

{% hint style="info" %}
Business accounts only need to verify email.&#x20;

Individual accounts are required to verify email and sms. Email **must** be verified before requesting an sms code.
{% endhint %}

## Request

### Path Parameters

<table><thead><tr><th width="227">Name</th><th>Description</th></tr></thead><tbody><tr><td><code>user_id</code> <br><mark style="color:red;">required</mark>, string</td><td>Unique ID defined by you for this user that will serve as the shared identifier for this account between you and sFOX</td></tr></tbody></table>

### Body Parameters

<table><thead><tr><th width="228">Name</th><th>Description</th></tr></thead><tbody><tr><td><code>type</code> <br><mark style="color:red;">required</mark>, string</td><td>Verification method. <br><em>Possible values: <code>email</code> , <code>sms</code></em></td></tr></tbody></table>

### Example Requests

{% tabs %}
{% tab title="Shell" %}
{% code lineNumbers="true" %}

```shell
curl -X POST \
-H "Authorization: Bearer ${ENTERPRISE_API_KEY}" \
--data '{ "type": "email" }'  \
'https://api.sfox.com/v1/enterprise/users/send-verification/${user_id}'
```

{% endcode %}
{% endtab %}

{% tab title="NodeJS" %}

<pre class="language-javascript"><code class="lang-javascript">const axios = require('axios');

const user_id = "user_id"
const data = JSON.stringify({ type: 'email'})
const config = {
  method: 'post',
  url: `https://api.sfox.com/v1/enterprise/users/send-verification/${user_id}`,
  headers: {
    'Content-Type': 'application/json',
    Authorization: `Bearer ${process.env.ENTERPRISE_API_KEY}`
  },
  data: data
}
  
axios(config)
  .then((response) => {
  console.log(response.status)
  console.log(response.data)
  })
  .catch((err) => {
  console.error(err.response.status)
  console.error(err.response.data)
<strong>  });
</strong></code></pre>

{% endtab %}

{% tab title="Python" %}

```python
import requests
import os

data = requests.post(
  "https://api.sfox.com/v1/enterprise/users/send-verification/${user_id}",
  headers={
    "Authorization": f"Bearer {os.environ['ENTERPRISE_API_KEY']}"
  },
  json={
    "type": "email"
  }
)
print(data.status_code)
print(data.json())
```

{% endtab %}
{% endtabs %}

## Response

### Response Fields

<table><thead><tr><th width="191.47265625">Name</th><th>Description</th></tr></thead><tbody><tr><td><code>data</code><br>object</td><td>Verification code information.</td></tr><tr><td>    <code>user_id</code><br>    string</td><td>The ID of the end user the code was sent to.</td></tr><tr><td>    <code>type</code><br>    string</td><td>The verification method for the code. <br><em>Possible values: <code>email</code> , <code>sms</code></em></td></tr><tr><td>    <code>email</code><br>    string</td><td>The email address the verification code was sent to, if <code>type</code> = <code>email</code></td></tr><tr><td>    <code>phone_number</code><br>    string</td><td>The phone number the verification code was sent to, if <code>type</code> = <code>sms</code></td></tr></tbody></table>

### Responses

<details>

<summary><mark style="color:green;">200</mark>: OK</summary>

{% code title="Email verification code sent to email specified" lineNumbers="true" %}

```json
{
    "data": {
        "user_id": "client_account_1",
        "type": "email",
        "email": "sfox_connect@email.com"
    }
}
```

{% endcode %}

{% code title="SMS verification code sent to the phone number specified" lineNumbers="true" %}

```json
{
    "data": {
        "user_id": "client_account_1",
        "type": "sms",
        "phone_number": "+12223334444"
    }
}
```

{% endcode %}

</details>

<details>

<summary><mark style="color:red;">422</mark>: Unprocessable Entity</summary>

{% code title="Email has already been verified" lineNumbers="true" %}

```json
{
    "error": "Email already verified"
}
```

{% endcode %}

{% code title="Phone number has already been verified" lineNumbers="true" %}

```json
{
    "error": "Phone already verified"
}
```

{% endcode %}

</details>