---
title: "Create a wake authorization"
method: POST
path: "/wake/authorizations"
tags: ["Wake"]
---

# Create a wake authorization

`POST /wake/authorizations`

Grant a sender domain (and optionally a specific address and command set)
permission to wake a target function. The domain must be fully-qualified.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `recipient_endpoint_id` string, uuid, required
  - `allowed_sender_domain` string, required — Fully-qualified sender domain (at least two labels).
  - `allowed_sender_address` string, nullable — Optional specific sender address to pin the grant to.
  - `allowed_commands` string[], nullable — Optional command allowlist; null = any command.
  - `note` string

## Response `201`

Wake authorization created

- object
  - `success` true, required
  - `data` object, required — A per-target allowlist grant authorizing a sender to wake a function.
    - `id` string, uuid, required
    - `recipient_endpoint_id` string, uuid, required
    - `allowed_sender_domain` string, required
    - `allowed_sender_address` string, nullable
    - `allowed_commands` string[], nullable
    - `enabled` boolean, required
    - `note` string, nullable
    - `created_at` string, date-time, required

## Other responses

- `400` — Invalid request parameters
- `401` — Invalid or missing API key
- `404` — Resource not found
- `409` — The request conflicts with the current state of the resource

---

[API](https://skmtc.dev/primitive/apis/primitive-api.md) · [All operations](https://skmtc.dev/primitive/apis/primitive-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/primitive/primitive-api/revisions/c2299d28022c/schema)