{"id":15286420,"url":"https://github.com/vj-abigo/invite-on-label","last_synced_at":"2025-04-13T02:32:30.920Z","repository":{"id":44906170,"uuid":"329284634","full_name":"vj-abigo/invite-on-label","owner":"vj-abigo","description":"Automate organization invitation based on the label (used by EddieHub org)","archived":false,"fork":false,"pushed_at":"2023-08-24T20:02:18.000Z","size":4559,"stargazers_count":20,"open_issues_count":1,"forks_count":10,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-04T03:02:46.173Z","etag":null,"topics":["actions","automate-organization-invite","github","github-actions","invite-users","organization-tool"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vj-abigo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-01-13T11:20:25.000Z","updated_at":"2024-12-23T19:43:41.000Z","dependencies_parsed_at":"2024-06-18T18:38:25.587Z","dependency_job_id":"3c7ef3f6-37d1-4a01-8dee-c7db7b77edd3","html_url":"https://github.com/vj-abigo/invite-on-label","commit_stats":{"total_commits":77,"total_committers":8,"mean_commits":9.625,"dds":0.4675324675324676,"last_synced_commit":"a86679769b8d1b8d77a80f12d3904274ba2fa2b5"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vj-abigo%2Finvite-on-label","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vj-abigo%2Finvite-on-label/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vj-abigo%2Finvite-on-label/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vj-abigo%2Finvite-on-label/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vj-abigo","download_url":"https://codeload.github.com/vj-abigo/invite-on-label/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248657819,"owners_count":21140842,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["actions","automate-organization-invite","github","github-actions","invite-users","organization-tool"],"created_at":"2024-09-30T15:13:56.409Z","updated_at":"2025-04-13T02:32:30.633Z","avatar_url":"https://github.com/vj-abigo.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Invite-on-label workflow\n\n![Screenshot of the invite the bot sends](https://user-images.githubusercontent.com/62864373/109786137-dc3b1280-7c32-11eb-9f10-e0e8ed936d2e.png)\n\nThis action allows you to auto-invite people to your org. after they open an issue, with a specific label.\n\n### How to use\n\n- Go to your repository\n- Create a folder named `.github` and create a `workflows` folder inside it if it doesn't exist.\n- Create a new file named `invitation.yml` with the following contents inside the `workflows` folder:\n\n```yml\non:\n  issues:\n    types: [labeled]\n\njobs:\n  automate_invite:\n    runs-on: ubuntu-latest\n    steps:\n      - name: Invite on label\n        uses: vj-abigo/invite-on-label@v1.4\n        with:\n          organization: GitHub-Org\n          label: invite me to the organization\n          repo-token: ${{ secrets.GITHUB_TOKEN }}\n          comment: 'Welcome to the Org.'\n        env:\n          INVITE_TOKEN: ${{ secrets.INVITE_TOKEN }}\n```\n\n- Replace the `organization` name to put in name of your org, replace the `label` with name of the label with which you want this action to be triggered.\n- Replace `comment` with the message you want the github-actions bot to send after an invite is sent.\n- **NOTE:** create a [personal access token](https://github.com/settings/tokens/new) called _`INVITE_TOKEN`_ _(or give it another name, but don't forget to change it in the workflow)_ with the scope of _`admin:org`_ and set the expiration date as _`No expiration`_ _(If you don't want to regenerate token again)_\n\n![Give admin:org access to the token](https://user-images.githubusercontent.com/43115551/109795252-b450ac80-7c3c-11eb-8de7-5dc5d600f82e.png)\n\n- Copy the generated token and navigate to your org's secrets(`Organization Settings \u003e Secrets`) and create a `New Organization Secret` with the Name as `INVITE_TOKEN` and the value as the token that you copied in the previous step.\n  `https://github.com/organizations/*your-org-name*/settings/secrets/actions`\n- You don't worry about the `GITHUB_TOKEN`, It will be given by GitHub\n\n### Note:\n\n**_organization_** - _(required)_ Name of the organization to which you would like to invite your contributors\n\n**_label_** - _(required)_ Name of the label\n\n**_comment_** - _(optional)_ A comment which will be posted by github-actions bot after invite is sent.\n\n\u003e Default comment: `Invitation sent for the GitHub Organisation. Welcome to the community`\n\n**_existingMemberMessage_** _(optional)_ Message for existing organisation members\n\n\u003e Default Message: `You are already a member of our Organisation.`\n\n### Examples\n\n- [EddieHub invitation Workflow](https://github.com/EddieHubCommunity/support/blob/main/.github/workflows/invitation.yml)\n\n### Contributing\n\nPlease see [`CONTRIBUTING.md`](./CONTRIBUTING.md) for getting started with the contribution. Make sure that you follow [`CODE_OF_CONDUCT.md`](./CODE_OF_CONDUCT.md) while contributing and engaging in the discussions. **When contributing, please first discuss the change you wish to make via an issue on this repository before making the actual change.**\n\n#### ToDo-\n\n- [ ] Better Docs\n- [ ] Fix bugs, if any\n\n#### Bugs-\n\nIf you feel any difficulty in usage or notice a bug, don't forget to [open a new issue](https://github.com/vj-abigo/invite-on-label/issues/new).\n\n### Contributors\n\n\u003ca href=\"https://github.com/vj-abigo/invite-on-label/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=vj-abigo/invite-on-label\" /\u003e\n\u003c/a\u003e\n\nMade with [contributors-img](https://contrib.rocks).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvj-abigo%2Finvite-on-label","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvj-abigo%2Finvite-on-label","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvj-abigo%2Finvite-on-label/lists"}