> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# On Automate.ax deployment awaiting authorization

> Run an automation when a deployment needs integration-account authorization.

`automate.onDeploymentAwaitingAuthorization` emits when a deployment cannot proceed until its required integration accounts are authorized, including after a bound account is revoked.

```ts automations/watch-deployment-authorization.automation.ts theme={null}
import { automation } from "automate.ax"
import { automate } from "automate.ax/automate"

export default automation("Watch deployment authorization", () => {
  automate.onDeploymentAwaitingAuthorization({
    account: "operations",
    projectId: "proj_01",
  })
})
```

When `account` is omitted, the trigger uses the deploying project's organization. An explicit static Automate.ax binding requires `deployment:read` and can select another organization. `projectId` must identify a project in the resulting organization.

## Trigger data

Returns the [deployment event shape](/reference/integrations/automate/triggers/on-deployment-event) with `status: "awaiting_authorization"`.
