Skip to main content

Webhooks

Configure webhooks so your Git platform automatically notifies RoostGPT when code is pushed or a pull request is opened. RoostGPT then triggers test generation automatically.

Webhook URL​

Use this endpoint as the payload/target URL in all webhook configurations:

https://<your-roost-domain>/api/application/client/git/events/add

Replace <your-roost-domain> with your RoostGPT server's DNS name.

GitHub​

  1. Navigate to your GitHub repository

  2. Click "Settings"

    GitHub repo settings

  3. Click "Webhooks"

    GitHub webhooks menu

  4. Click "Add webhook"

    Add webhook button

  5. Set:

    • Payload URL: https://<your-roost-domain>/api/application/client/git/events/add
    • Content type: application/json

    GitHub webhook URL config

  6. Click "Let me select individual events" and select:

    • Pull Requests
    • Pushes
    • Releases

    GitHub event selection

  7. Click "Add webhook"

    GitHub save webhook

GitLab​

  1. Navigate to your GitLab repository

  2. In the left sidebar, click Settings → Webhooks

    GitLab webhooks menu

  3. In the URL field, enter: https://<your-roost-domain>/api/application/client/git/events/add

    GitLab webhook URL

  4. Under Trigger, select:

    • Push events
    • Merge request events
    • Release events

    GitLab event selection

  5. Click "Add webhook"

Bitbucket Cloud​

  1. Navigate to your Bitbucket repository

  2. In the left sidebar, click "Repository Settings"

  3. Click "Webhooks" in the left sidebar

  4. Click "Add webhook"

  5. Set a Title (e.g., RoostGPT)

  6. Set URL: https://<your-roost-domain>/api/application/client/git/events/add

  7. Under Triggers, select:

    • Pull Request: Created, Updated, Merged, Declined
    • Repository: Push

  8. Click "Save"

Bitbucket Server​

  1. Navigate to your Bitbucket Server repository

  2. Click "Repository settings"

    Bitbucket Server repo settings

  3. Click "Webhooks"

    Bitbucket Server webhooks

  4. Click "Create webhook"

    Create webhook button

  5. Set:

    • Name: roost-webhook
    • URL: https://<your-roost-domain>/api/application/client/git/events/add

    Webhook URL config

  6. Select events:

    • Push
    • Pull Requests: Opened, Source branch updated, Modified, Merged, Declined, Deleted

    Bitbucket Server event selection

  7. Click "Create"

Azure DevOps​

Azure DevOps uses Service Hooks for webhook-style event notifications. You need to create three separate subscriptions: Code Pushed, Pull Request Created, and Pull Request Merged.

  1. Navigate to https://dev.azure.com/{organization}/{project}

  2. Click "Project settings" (bottom-left corner)

    Azure DevOps project settings

  3. Click "Service hooks" → "Create Subscription"

    Service hooks menu

  4. Select Web Hooks as the service and click Next

    Web Hooks service

  5. For the first subscription, select event "Code pushed"

    Code pushed event

  6. Select the specific repository and branch (or leave as "Any")

    Repository filter

  7. Set the URL: https://<your-roost-domain>/api/application/client/git/events/add

    Webhook URL

  8. Click Finish

  9. Repeat steps 3–8 for:

    • "Pull request created"
    • "Pull request merged"

    Multiple subscriptions