If you are a new team member trying to join an organization that is using the classic Github OAuth integration, you may encounter an error page with the following message: "You need permission - To access this organization, ask your administrator to give you Write permission in Github or Bitbucket." In this support article, we will guide you through the steps to resolve this issue.
Verify Write Permission
It is important to verify that you indeed have write permission to the organization. Double-check with your organization's administrator or owner to ensure that you have the necessary permissions assigned.
Check OAuth App Access Restriction
If you have confirmed that you have write permission to the organization, it is possible that the organization has OAuth App access restriction enabled. This means that as a new user, you need to explicitly request or grant access to the organization on your personal Github account.
Requesting or granting access to an OAuth App access restricted organization:
- Navigate to the CircleCI OAuth App on your personal account by selecting
Authorized OAuth Apps>
- Scroll down to the section labeled
- You should see an option to grant or request permission next to the organization's name. Please proceed to do so.
- If the organization is not listed here, please reach out to the organization's administrator to request the correct permissions to the organization
Once you have confirmed that you have the right permissions and you have granted access to the organization, you should be able to log in to your CircleCI account and access the organization.
If you have followed the above steps and still encounter the permission error mentioned earlier, please don't hesitate to contact our support team.