Skip to main content

Auto-Sync Configuration

Auto-sync uses GitHub webhooks to automatically trigger syncs when Figma Make pushes changes.

How It Works​

  1. Figma Make pushes to its auto-created repository
  2. GitHub sends a webhook to GitFig server
  3. GitFig syncs changes to your target repository
  4. You receive the changes as a PR or direct push

Setting Up Webhooks​

Step 1: Get Your Webhook URL​

The GitFig webhook URL is:

https://oauth.gitfig.com/api/webhooks/github

Step 2: Generate a Secret​

Generate a secure webhook secret:

openssl rand -hex 32

Save this secret - you'll need it for both GitHub and GitFig.

Step 3: Configure on GitHub​

  1. Go to your Make repository on GitHub
  2. Click Settings → Webhooks → Add webhook
  3. Fill in the fields:
FieldValue
Payload URLhttps://oauth.gitfig.com/api/webhooks/github
Content typeapplication/json
SecretYour generated secret
SSL verificationEnable
Events"Just the push event"
  1. Click Add webhook

Step 4: Verify Webhook​

GitHub shows a green checkmark when the webhook is working. If you see a red X, check the recent deliveries for error messages.

Webhook Security​

The webhook secret ensures only GitHub can trigger syncs:

  • GitFig validates the X-Hub-Signature-256 header
  • Invalid signatures are rejected with 401 Unauthorized
  • This prevents malicious sync triggers

Monitoring Syncs​

View sync history in GitFig:

  1. Open the Make Bridge tab
  2. Click "History" to see recent syncs
  3. Each entry shows status, timestamp, and commit info

Troubleshooting​

Webhook not triggering​

  • Check webhook is configured on the Make repo (not target)
  • Verify the secret matches
  • Check GitHub webhook delivery logs

"Signature verification failed"​

  • Webhook secret doesn't match
  • Reconfigure with the correct secret

Sync fails but webhook works​

  • Check GitFig has access to both repositories
  • Verify sync strategy settings