GitHub Setup & Troubleshooting

This guide walks through connecting a GitHub repository, setting up automatic synchronization, and creating a repository-managed transformer library.

Setup guide

1. Connect the repository – on the Repositories page, select Connect Repository and provide the repository details and a GitHub access token that can read the repository. See Managing Repositories.
2. Get the webhook details – open the Webhook Info action for your repository to copy the webhook URL and secret.
3. Create the webhook in GitHub (Repository → Settings → Webhooks → Add webhook):
   • Payload URL – the webhook URL from step 2.
   • Content type – application/json (recommended).
   • Secret – the secret from step 2.
   • Events – "Just the push event".
4. Create the library – on the Library Modules page, create a new library From Repository and choose the file you want to track. See Create a Transformer Library from a Repository.
5. Push a change – a new published version is created automatically. You can also use the Synchronize action to update on demand.

Troubleshooting

Symptom	Likely cause	Fix
Automatic updates aren't working	The webhook secret in GitHub doesn't match	Re-copy the secret from Webhook Info and make sure the GitHub webhook secret matches exactly.
GitHub reports the webhook can't be delivered	The webhook URL or content type is wrong	Use the exact URL from Webhook Info and set the content type to application/json.
Push happens but no new version appears	The tracked file or branch didn't change	Only changed content creates a new version. Confirm the file path and branch, then try a manual sync.
Connecting fails	The access token is invalid or expired	Use Validate Token to check it, and Refresh Token to provide a new one.
The feature appears unavailable	The feature isn't enabled for your tenant	Contact your Fenergo administrator to enable Transformer Libraries and Repository Connections.