---
title: "Create a new accesskey."
method: POST
path: "/accesskeys"
tags: ["Accesskey"]
---

# Create a new accesskey.

`POST /accesskeys`

Create a new accesskey.

## Request body

- object
  - `name` string
  - `detail` string
  - `expire` integer

## Response `200`

Successful response

- CustomerManagerAccesskey
  - `id` string, uuid — The unique identifier of the access key.
  - `customer_id` string, uuid — The unique identifier of the customer. Returned from the `GET /customers` response.
  - `name` string — Name of the access key.
  - `detail` string — Additional details about the access key.
  - `token` string — The access key token. Only returned once at creation time via `POST /accesskeys`. Subsequent `GET` requests will not include this field. Store it securely immediately after creation.
  - `token_prefix` string — A short prefix of the access key token for identification purposes. Always returned in `GET` responses.
  - `tm_expire` string, date-time — Timestamp when the access key expires.
  - `tm_create` string, date-time — Timestamp when the access key was created.
  - `tm_update` string, date-time — Timestamp when the access key was last updated.
  - `tm_delete` string, date-time — Timestamp when the access key was deleted.

## Other responses

- `400` — Invalid request (INVALID_ARGUMENT).
- `401` — Authentication required (UNAUTHENTICATED).
- `500` — Internal error (INTERNAL).

---

[API](https://skmtc.net/voipbin/apis/voipbin-api.md) · [All operations](https://skmtc.net/voipbin/apis/voipbin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voipbin/voipbin-api/revisions/79e779080bcc/schema)