> ## 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.

# Get Deploy Webhook URL

> Retrieves the GitHub deploy webhook URL and repository information for an application.

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

### Response

<ResponseField name="response" type="object">
  Contains repository and webhook details.

  <Expandable title="Toggle object">
    <ResponseField name="repo_owner" type="string">
      The owner of the GitHub repository.
    </ResponseField>

    <ResponseField name="repo_name" type="string">
      The name of the GitHub repository.
    </ResponseField>

    <ResponseField name="webhook_url" type="string">
      The URL of the deploy webhook.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "response": {
      "repo_owner": "owner_name",
      "repo_name": "repository_name",
      "webhook_url": "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.
  * `DEPLOYMENT_NOT_FOUND`: Webhook integration not found for the application.
</ResponseField>

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

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