Webhook Configuration

Set up GitHub webhooks so DevArc receives real-time notifications whenever you push code, open pull requests, or work with issues.

How It Works

GitHub webhooks send HTTP POST requests to DevArc every time a configured event occurs in your repository. This allows DevArc to update your metrics, achievements, and analytics in real time — without waiting for periodic syncs.

Real-time updates
Secure with HMAC signatures
Automatic achievement tracking
1

Navigate to Repository Settings

Go to the GitHub repository you want to connect, then open SettingsWebhooksAdd webhook.

https://github.com/<owner>/<repo>/settings/hooks/new
2

Configure Webhook Settings

Fill in the following fields on the GitHub webhook form:

Payload URL https://devarc.dev/api/github/webhook
Content type application/json
Secret Leave blank — DevArc validates webhooks using your connected GitHub account
SSL verification Enable SSL verification (recommended)

Important

Make sure to select application/json as the content type. The default application/x-www-form-urlencoded format is not supported.

3

Select Events

Choose "Let me select individual events" and enable the following:

Pushes

Tracks commits, lines changed, languages, and triggers achievement checks.

Pull requests

Tracks PR activity for collaboration and code review metrics.

Issues

Monitors issue activity for impact and responsiveness analytics.

Other events

Optional. Other events are safely ignored by DevArc.

Tip: If you prefer simplicity, you can select "Send me everything" instead. DevArc will process only the events it needs and safely ignore the rest.

4

Save and Verify

Click "Add webhook". GitHub will send a ping event to verify the connection.

To confirm it's working, check the Recent Deliveries tab on the webhook page. You should see a successful ping delivery with a 200 response.

You're all set!

Push a commit to the repository and watch your DevArc dashboard update in real time.

Troubleshooting

Webhook shows a red warning icon

Check the Recent Deliveries tab for the error response. Common causes:

  • Wrong content type — must be application/json
  • Incorrect payload URL — verify it matches exactly
  • Repository not connected in DevArc — connect it first via the Repositories page

Dashboard not updating after push

Metrics processing runs asynchronously. Allow up to 30 seconds for the dashboard to reflect new commits. If it still doesn't update, check that the webhook delivery was successful on GitHub and that the repository is listed as "tracked" on your Repositories page.

Can I set up webhooks for an organization?

Yes. Organization-level webhooks work the same way. Go to your organization's SettingsWebhooks and follow the same steps. All repositories in the organization will send events to DevArc.