Skip to main content
GET
https://api.vertracloud.app
/
v1
/
apps
/
{app_id}
/
deploys
/
webhook
Get Deploy Webhook URL
curl --request GET \
  --url https://api.vertracloud.app/v1/apps/{app_id}/deploys/webhook
{
  "status": "success",
  "response": {
    "repo_owner": "owner_name",
    "repo_name": "repository_name",
    "webhook_url": "https://api.vertracloud.app/v1/apps/123/deploys/receiver/webhook"
  }
}
​
app_id
string
required
The ID of the application whose webhook URL will be retrieved.

​
Response

​
status
string
Indicates if the request was successful. Returns success on success.
​
response
object
Contains repository and webhook details.
{
  "status": "success",
  "response": {
    "repo_owner": "owner_name",
    "repo_name": "repository_name",
    "webhook_url": "https://api.vertracloud.app/v1/apps/123/deploys/receiver/webhook"
  }
}

​
Error Responses

​
status
string
Returns error if the request fails.
​
code
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.
{
  "status": "error",
  "code": "DEPLOYMENT_NOT_FOUND"
}