Integrations

BuildMagic integrates with GitHub and GitLab for authentication, repository access, and build automation via webhooks. You can connect one or both providers to your account.

Supported Providers

ProviderSign InBrowse ReposCloneWebhooks
GitHubYesYesYesYes
GitLabYesYesYesYes

Connecting GitHub

If you signed up with GitHub, your account is already connected. To connect GitHub to an existing account:

  1. Go to Settings → Integrations in the dashboard.
  2. Click Connect next to GitHub.
  3. You'll be redirected to GitHub to authorize BuildMagic.
  4. After authorizing, you'll be redirected back to the dashboard with GitHub connected.

Once connected, you can browse your GitHub repositories when adding applications, and BuildMagic will use your GitHub credentials to clone repositories during builds.

Connecting GitLab

  1. Go to Settings → Integrations in the dashboard.
  2. Click Connect next to GitLab.
  3. You'll be redirected to GitLab to authorize BuildMagic.
  4. After authorizing, you'll be redirected back with GitLab connected.

Using Multiple Providers

You can connect both GitHub and GitLab simultaneously. When adding an application, you choose which provider to use. This lets you build projects from both platforms in a single BuildMagic account.

Setting Up Webhooks

Webhooks let BuildMagic automatically trigger builds when you push code to your repository. Without webhooks, you'll need to trigger builds manually from the dashboard or via the API.

GitHub Webhooks

  1. Go to your repository on GitHub → Settings → Webhooks.
  2. Click Add webhook.
  3. Configure the webhook:
    • Payload URL: https://buildmagic.dev/api/webhooks/github
    • Content type: application/json
    • Events: Select Just the push event.
  4. Click Add webhook.

GitLab Webhooks

  1. Go to your project on GitLab → Settings → Webhooks.
  2. Click Add new webhook.
  3. Configure the webhook:
    • URL: https://buildmagic.dev/api/webhooks/gitlab
    • Trigger: Select Push events.
  4. Click Add webhook.

Once configured, every push to the repository will send an event to BuildMagic, which triggers a build using the matching workflow.

Disconnecting a Provider

  1. Go to Settings → Integrations.
  2. Click Disconnect next to the provider.

Disconnecting removes the stored OAuth token. Existing applications that use the disconnected provider will fail to clone repositories until you reconnect. The applications themselves are not deleted.