---
title: "Create Consumer Key"
method: POST
path: "/user/consumerKeys"
tags: ["consumerkey"]
---

# Create Consumer Key

`POST /user/consumerKeys`

Create new Consumer Key

Note: Consumer Key creation is not allwed when authenticated via Consumer Key.

## Request body

- ConsumerKeyCreateRequestBody
  - `label` string — Consumer Key label.
  - `permissions` string[], required — Permissions granted to this consumer key. At least one value is required.
  - `ips` string[] — IP addresses allowed to use this consumer key. Empty array or omitted means no restriction.

## Response `201`

Sucess

Consumer Key Created Sucessfully.

- ConsumerKeyCreateResponseBody
  - `consumerKey` string — Consumer Key
  - `consumerSecret` string — Consumer Secret

## Other responses

- `401` — Unauthorized This API requires a valid API Key to be provided. (Use [/authentication/authorize](#/authentication/AuthenticationLogin) to obtain an API Key) Produces: * missing_authorization_key * invalid_authorization_key * account_is_inactive

---

[API](https://skmtc.net/serversmtp/apis/turbosmtp-public-apis.md) · [All operations](https://skmtc.net/serversmtp/apis/turbosmtp-public-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/serversmtp/turbosmtp-public-apis/versions/8503e099b215/schema)