place.wisp.v2.secret.create Documentation (EN)

main procedure

Create a named webhook signing secret. The server generates a short random token returned once in the response. Reference the secret by name via secretId in place.wisp.v2.wh.

Input

Encodingapplication/json

name stringrecord-key Required

Unique name for this secret, scoped to the caller DID.

Output

Encodingapplication/json

createdAt stringdatetime Required

An RFC 3339 formatted timestamp.

name string Required

No description available.

token string Required

The signing token. Only returned at creation time — store it now.

Errors

AuthenticationRequired

InvalidRequest

AlreadyExists

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://bsky.social)

Request Body (JSON) Enter valid JSON for the request body

View raw schema

{
  "type": "procedure",
  "input": {
    "schema": {
      "type": "object",
      "required": [
        "name"
      ],
      "properties": {
        "name": {
          "type": "string",
          "format": "record-key",
          "description": "Unique name for this secret, scoped to the caller DID."
        }
      }
    },
    "encoding": "application/json"
  },
  "errors": [
    {
      "name": "AuthenticationRequired"
    },
    {
      "name": "InvalidRequest"
    },
    {
      "name": "AlreadyExists"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "name",
        "token",
        "createdAt"
      ],
      "properties": {
        "name": {
          "type": "string"
        },
        "token": {
          "type": "string",
          "description": "The signing token. Only returned at creation time — store it now."
        },
        "createdAt": {
          "type": "string",
          "format": "datetime"
        }
      }
    },
    "encoding": "application/json"
  },
  "description": "Create a named webhook signing secret. The server generates a short random token returned once in the response. Reference the secret by name via secretId in place.wisp.v2.wh."
}