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

# Troubleshooting automations

> Common Automation issues and solutions

## Debugging failed executions

1. Open the failed execution from the Automation details page.
2. Review the **Action session** for error messages.
3. Check which step failed and review output.

## Trigger issues

### Manual triggers not starting

* Verify account has access to target repositories/projects.
* Check repositories match your search query.
* Verify permissions to run Automations.

### Pull request triggers not firing

* Verify webhook configured correctly in GitHub/GitLab.
* Check webhook secret matches Automation settings.
* Confirm PR events are selected in webhook config.

See [Pull request triggers](/ona/automations/triggers/pullrequest).

### Time-based triggers not running

* Verify schedule is correct (schedules run on UTC).
* Check the Automation is not paused or disabled.
* Confirm service account has repository access.

See [Time-based triggers](/ona/automations/triggers/timebased).

## Repository access errors

"Repository not found" or "access denied":

| Account type    | Check                                            |
| --------------- | ------------------------------------------------ |
| User            | SCM access? PAT scopes? Repo still exists?       |
| Service account | Git auth configured? PAT valid? Required scopes? |

See [Service accounts](/ona/organizations/service-accounts).

## Permission errors

"Permission denied" or "Insufficient permissions":

* Projects must be shared with "all members" for Automations to access them.
* Verify service account is organization member with SCM permissions.

See [Project sharing](/ona/projects/project-sharing).

## Sharing issues

### Cannot see Automations page

* Verify organization has Automations enabled.
* If not admin, confirm you are in a group with shared Automation access.

### "Project not found" on shared Automation

The Automation targets a project you do not have access to. Ask admin to share the project, or select a different target.

### Git auth errors on shared Automations

Shared Automations run under your identity. Re-authenticate at [app.ona.com](https://app.ona.com) > **Settings** > **Git Providers**.

### Cannot see other users' executions

Expected. Executors only see their own executions. Admins see all.

## Plan limits

### "Your plan allows a maximum of N automations"

Your organization has reached the maximum number of Automations for its plan. Delete unused Automations or upgrade your plan. See [Plans and limits](/ona/automations/plans-and-limits).

### "The maximum concurrent actions limit cannot exceed N on your current plan"

The max parallel value you set exceeds your plan's cap. Reduce the value or upgrade your plan. See [Guardrails](/ona/automations/guardrails) for per-plan limits.

### "The maximum total actions limit cannot exceed N on your current plan"

The max total value you set exceeds your plan's cap. Reduce the value or upgrade your plan. See [Guardrails](/ona/automations/guardrails) for per-plan limits.

### "Organizations on the ... tier cannot create webhooks"

Webhook creation is restricted to the Enterprise plan. Non-enterprise organizations can use manual and time-based triggers. See [Pull request triggers](/ona/automations/triggers/pullrequest).

## Getting help

Contact your Ona account manager with:

* Automation name/ID and execution ID.
* Error messages from Action session.
* Steps to reproduce.