---
title: "Intent created"
method: POST
path: "intent.created"
---

# Intent created

`POST intent.created` (webhook)

Fired when a new intent is created.

## Payload

- IntentCreatedWebhookPayload — Payload for the intent.created webhook event.
  - `authorization_details` IntentAuthorization[] — Key quorums that can authorize this intent.
    - `display_name` string — Display name of the key quorum
    - `members` IntentAuthorizationMember[], required — Members in this authorization quorum
      - union — A member of an intent authorization quorum. Can be a user, key, or nested key quorum.
        - object — A user member of an intent authorization quorum.
          - `signed_at` number, nullable, required — Unix timestamp when this member signed, or null if not yet signed.
          - `type` 'user', required
          - `user_id` string, required — User ID of the key quorum member
        - object — A key member of an intent authorization quorum.
          - `public_key` string, required — Public key of the key quorum member
          - `signed_at` number, nullable, required — Unix timestamp when this member signed, or null if not yet signed.
          - `type` 'key', required
        - object — A nested key quorum member of an intent authorization quorum.
          - `display_name` string — Display name for the child key quorum (if any)
          - `key_quorum_id` string, required — ID of the child key quorum member
          - `members` IntentAuthorizationKeyQuorumMember[], required — Members of this child quorum
            - union — A leaf member (user or key) of a nested key quorum in an intent authorization.
              - …
          - `threshold` number, required — Number of signatures required from this child quorum
          - `threshold_met` boolean, required — Whether this child key quorum has met its signature threshold
          - `type` 'key_quorum', required
    - `threshold` number, required — Number of signatures required to satisfy this quorum
  - `created_at` number, required — Unix timestamp when the intent was created.
  - `created_by_display_name` string — Display name of the user who created the intent.
  - `created_by_id` string — The ID of the user who created the intent.
  - `expires_at` number, required — Unix timestamp when the intent expires.
  - `intent_id` string, required — The unique ID of the intent.
  - `intent_type` 'KEY_QUORUM' | 'POLICY' | 'RULE' | 'RPC' | 'TRANSFER' | 'WALLET', required — Type of intent.
  - `status` string, required — The current status of the intent.
  - `type` 'intent.created', required — The type of webhook event.

## Acknowledgement `200`

Return a 200 status to indicate that the webhook was received successfully.

---

[API](https://skmtc.net/privy-io/apis/privy-api.md) · [All operations](https://skmtc.net/privy-io/apis/privy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/privy-io/privy-api/revisions/bb2eb34156cc/schema)
