​
Endpoint

POST https://sms.phones.inc/v1/keys

​
Overview

Create a new API key on your account. The key secret is returned exactly once, in this response — store it securely.

​
Request Body

​
name
string
default:"API key"
Human-readable label for the key.

​
Response

Returns 201 Created.
​
ok
boolean
true on success.
​
key
object
The created key.
curl -X POST https://sms.phones.inc/v1/keys \
  -H "API-KEY: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "Production"}'

{
  "ok": true,
  "key": {
    "id": "3f2e1d0c-9b8a-7654-3210-fedcba987654",
    "name": "Production",
    "secret": "sk_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9z8x",
    "key_preview": "sk_a1b…9z8x"
  }
}