---
title: "Create API key"
method: POST
path: "/api-key/create"
tags: ["API Keys"]
---

# Create API key

`POST /api-key/create`

Create a service-to-service API key for a merchant.

## Request body

- CreateApiKeyRequest
  - `merchant_id` string, required
  - `description` string, nullable

## Response `200`

Created API key

- CreateApiKeyResponse
  - `key_id` string
  - `api_key` string
  - `key_prefix` string
  - `merchant_id` string
  - `description` string, nullable
  - `created_at` string

## Changes

> 13 revisions in range; 1 could not be searched.

- **2026-08-04** `36e7a0972ee6` — 1 breaking
  - the request property `description` became not nullable
- **2026-04-25** `986e537b0455` — 1 info
  - endpoint added
- **2026-04-10** `9618544de91a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/juspay/apis/decision-engine/changes/api-key/create/post.md)

---

[API](https://skmtc.dev/juspay/apis/decision-engine.md) · [All operations](https://skmtc.dev/juspay/apis/decision-engine/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/juspay/decision-engine/revisions/a35ceeb59faf/schema)