# Create Voicemail Box

## GET or POST Request

{% hint style="info" %}
<https://v1.api19.com/voicemail/inbox/create>
{% endhint %}

Create a new voicemail box to route numbers to

## HTTP Post Variables Supported

<table data-header-hidden><thead><tr><th width="123.9090576171875"></th><th width="108.54547119140625"></th><th></th></tr></thead><tbody><tr><td>Argument</td><td>Required</td><td>Type</td></tr><tr><td>box_id</td><td>yes</td><td>2-12 digits</td></tr><tr><td>name</td><td>yes</td><td>2-100 characters</td></tr><tr><td>password</td><td>yes</td><td>4 digits</td></tr><tr><td>emails</td><td>yes</td><td>emails separated by a comma</td></tr><tr><td>key</td><td>yes</td><td>api key</td></tr></tbody></table>

{% tabs %}
{% tab title="Curl Post" %}

```php
curl https://v1.api19.com/voicemail/inbox/create \
 -d 'key=api_token' \
 -d 'box_id=2233' \
 -d 'name=my+box' \
 -d 'password=8833' \
 -d 'emails=me@example.com,you@example.com'
```

{% endtab %}

{% tab title="Curl Get" %}

```
curl "https://v1.api19.com/voicemail/inbox/create?key=api_token&box_id=2233&name=my+box&password=8833&emails=me@example.com,you@example.com"
```

{% endtab %}

{% tab title="JSON Response" %}

```json
{"status":"ok","message":"ok"}
OR
{"status":"error","error":"Password is not 4 characters"}
OR
{"status":"error","error":"Box id cannot start with 0"}
OR
{"status":"error","error":"Box id is not 2-12 digits"}
OR
{"status":"error","error":"Invalid Email: moo@moo"}
OR
{"status":"error","error":"box id exists, try another"}



```

{% endtab %}
{% endtabs %}