# POST /agents/repos/{owner}/{repo}/automations (GitHub API)
Base URL: https://api.github.com
Auth: Authorization; GitHub token; required.
Request formats: application/json.
Last verified: 2026-10-20

> Create an automation for a repository

## Critical Gotchas
* GitHub recommends an `Accept: application/vnd.github+json` header and an explicit `X-GitHub-Api-Version` header.
* Fine-grained tokens only authorize repositories and permissions selected when the token is created.

## cURL
curl -X POST 'https://api.github.com/agents/repos/example-owner/example-repo/automations' \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H 'Accept: application/vnd.github+json' \
  -H 'X-GitHub-Api-Version: 2026-03-10' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "example-name",
  "prompt": "example-prompt"
}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| owner | path | string | Yes | The account owner of the repository. The name is not case sensitive. |
| repo | path | string | Yes | The name of the repository. The name is not case sensitive. |
| name | body | string | Yes | The name of the automation. |
| prompt | body | string | Yes | The prompt template for the automation. |
| triggers | body | object | No | Public trigger configuration keyed by stable public trigger identifier. Each... |
| model | body | string | No | The model to use for sessions triggered by this automation. Omit to use the p... |
| reasoning_effort | body | string | No | The reasoning effort to use for sessions triggered by this automation. Omit o... |
| tools | body | string[] | No | The tools available to the automation. |
Other params: allowed_custom_agents, enabled, owner_type, write_scope, require_actor_write_permission

## Response example
{"id":"string","name":"string"}

---
Need an API key? Get one at https://github.com/settings/tokens