# Action events

> action.requires_approval, fired when a Your API endpoint is waiting for a person to approve it

Source: https://www.hey.support/docs/developer-guide/webhooks/events/action

---

One event tells you an approval is waiting. The envelope is described in the [overview](/docs/developer-guide/webhooks).

## `action.requires_approval`

Fires when the agent wants to run a [Your API endpoint](/docs/capabilities/your-api) marked **requires approval**. Nothing runs until someone approves it in the Inbox, and the visitor is told their request is being checked.

```json
{
  "actionId": 91,
  "actionName": "issue_refund",
  "actionDescription": "Refund an order",
  "executionId": 4471,
  "conversationId": 8214,
  "chatbotId": 17,
  "inputArgs": { "order_id": "1042", "amount": 39.0 },
  "requestedAt": "2026-08-26T10:12:00.000Z"
}
```

<Callout type="warn">
  This payload is **camelCase**, while every other event is snake\_case. That is a real inconsistency in the current API version, not a typo in these docs, so parse it as written. It will be aligned in a future `api_version`, and the version field on the envelope is how you will know.
</Callout>

`inputArgs` is exactly what the model wants to call the endpoint with, so an approver can see the actual order and amount rather than just the endpoint's name.

## What to do with it

The approval itself happens in the Inbox; this event exists so it does not have to be noticed there. Typical uses:

* post it to the channel that owns that decision
* page whoever is on shift when `actionName` is one of the expensive ones
* record every request for audit, approved or not

<Accordions>
  <Accordion title="Approvals are not delivered">
    There is deliberately no `action.approved` or `action.denied` event. The outcome is written to the endpoint's run log and, when it succeeds, shows up in the conversation itself. If you need the outcome, read it from the conversation.
  </Accordion>
</Accordions>

<NextSteps>
  <IconCard icon="webhook" title="Webhooks overview" href="/docs/developer-guide/webhooks" description="The envelope, the headers and every event." />

  <IconCard icon="key-round" title="Verifying signatures" href="/docs/developer-guide/webhooks/signature" description="Check the HMAC before you act on a delivery." />
</NextSteps>
