---
title: "Create a Secret Key"
method: POST
path: "/webhooks/secret_key"
tags: ["Webhooks"]
---

# Create a Secret Key

`POST /webhooks/secret_key`

## Request

- Base URL: `https://sandbox.au-0000.api.assemblypay.com`
- URL: `https://sandbox.au-0000.api.assemblypay.com/webhooks/secret_key`
- Auth: HTTP bearer

Create a **Secret Key** to authenticate the identity of webhooks received

## Request body

- SecretKeyRequestBody
  - `secret_key` string, required: unique key value to be used for authenticating webhooks events.

## Response `201`

Created

- RequestResponses
  - `response_code` string
  - `Message` string
  - `created_at` string, date-time

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `422`: Unprocessable entity
- `500`: Internal Server error

---

[API](https://skmtc.dev/hellozai/apis/webhooks-api.md) - [All operations](https://skmtc.dev/hellozai/apis/webhooks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hellozai/apis/webhooks-api/revisions/94791cdd7a23?raw)