Manual App Creation

📘

Enable webhooks

Webhooks need to be enabled for the App to work. This is the method the app uses to connect and communicate with Codecov.

To create a App Integration for Codecov, first navigate to your organization in the UI.

Then from the Sidebar Click Developer Settings > Apps:

Choose "New App" and fill out the information as follows:

🚧

Create the App for your Organization

When creating the app, ensure that you're creating it for your organization, not your personal account. The URL on the app creation page should read: https://.com/settings/apps/new

And fill out the relevant fields for app creation:

It's important to set the proper callback URL. They should point to your Codecov Dedicated Cloud install as follows:

• <your-codecov-url>/login/_enterprise for Enterprise (on premises)
• <your-codecov-url>/login/ for (and Enterprise cloud)

For the webhook URL:

• <your-codecov-url>/webhooks/_enterprise for Enterprise (on premises)
• <your-codecov-url>/webhooks/ for (and Enterprise cloud)

Add a webhook secret (not optional) and include in the information packet to securely send to Codecov.

Permissions

The following screenshots show all of the permissions needed by the app integration, as well as the relevant events. For visibility, permissions with a greater setting than "No Access" have been emphasized in green.

Repository Permissions

Organization Permissions

User Permissions

Email address read is required. All others can be set to "No Access"

Events

📘

Using .com?

If you're not using Enterprise, make sure that you only publish this app for your organization unless you plan to install on multiple organizations.

After ensuring all fields are filled appropriately, click "Create App"

After app creation, follow the remaining instructions in

App Integration for Dedicated Cloud