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

# Create Deploy Webhook

> Creates a deploy webhook for a GitHub repository to automatically trigger deployments.

<ParamField path="app_id" type="string" required>
  The ID of the application where the webhook will be created.
</ParamField>

<ParamField body="owner" type="string" required>
  The GitHub repository owner.
</ParamField>

<ParamField body="repo_name" type="string" required>
  The name of the GitHub repository.
</ParamField>

<ParamField body="repo_id" type="string" required>
  The ID of the GitHub repository.
</ParamField>

<ParamField body="account_id" type="string" required>
  The GitHub account ID.
</ParamField>

### Response

<ResponseField name="response" type="string">
  The URL of the created webhook.
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "response": "https://api.vertracloud.app/v1/apps/123/deploys/receiver/webhook"
  }
  ```
</ResponseExample>

### Error Responses

<ResponseField name="code" type="string">
  Possible error codes:

  * `UNAUTHORIZED`: User is not authenticated or lacks permissions.
  * `PLAN_RESTRICTED_FEATURE`: User plan does not support auto-deploy.
  * `INVALID_ACCOUNT_ID`: Provided GitHub account ID is invalid.
  * `MISSING_REPO_INFORMATION`: Required repository information is missing.
  * `INSTALLATION_NOT_FOUND`: GitHub installation not found for the user.
</ResponseField>

<ResponseField name="message" type="string">
  A descriptive message providing additional details about the error.
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "code": "INVALID_ACCOUNT_ID"
  }
  ```
</ResponseExample>