Infrastructure

JetBrains

Connect JetBrains to Ploy to scan the people in your JetBrains organization and the IDEs each of them is licensed for. Ploy reads your assigned JetBrains commercial licences and surfaces, for every licensed user, their email and name, whether their licence is active or suspended, which JetBrains products they hold (IntelliJ IDEA, PyCharm, DataGrip, WebStorm, and others), and when they were last active.

Ploy only reads data from JetBrains — it never makes changes to your account.

Before you begin

You need a commercial JetBrains account managed in the JetBrains Central Console, and you must be an organization admin, team admin, or primary billing contact. Only those roles can generate an API token.

Ploy identifies JetBrains users by the email on each assigned licence. People who only use free or Community-edition JetBrains products, or who have not been assigned a commercial licence, are not part of your JetBrains commercial account and will not appear in Ploy.

Find your customer code

Your customer code (also called your customer ID) is a short numeric identifier for your JetBrains organization.

  1. Sign in to the JetBrains Central Console at account.jetbrains.com.

  2. Open the Help menu and choose Copy support information.

  3. Your customer ID is included in the copied details. Paste it somewhere you can read it.

Generate an API token

  1. In the JetBrains Central Console, click your organization name in the bottom-left corner and choose Org administration.

  2. Open the API section and click Generate Token.

  3. Copy the generated token and keep it somewhere secure, such as a password manager. You will paste it into Ploy in the next step.

The token inherits the permissions of the person who generates it. Ploy only makes read requests, so an admin or billing-contact token works without any extra configuration.

Connect JetBrains in Ploy

  1. Open the JetBrains integration in Ploy.

  2. In Customer Code, enter the customer ID you found above.

  3. In API Key, paste the token you generated.

  4. Click Test to check the connection. Ploy verifies the credentials against your JetBrains account.

  5. When the test succeeds, click Save. Ploy will begin scanning your JetBrains users on its regular schedule.

What each field is for

  • Customer Code: identifies which JetBrains organization Ploy connects to. Sent to JetBrains as your customer code.

  • API Key: lets Ploy authenticate to the JetBrains Account API for this connection. It is stored encrypted and is not shown again after you save.

What Ploy imports

  • Users — each person holding an assigned JetBrains commercial licence, matched to your existing Ploy identities by email.

  • Per-IDE access — which JetBrains products each user is licensed for, such as IntelliJ IDEA, PyCharm, DataGrip, or WebStorm.

  • Activity — each user's last-seen date, so you can spot unused licences.

Ploy refreshes this data automatically on a recurring schedule.

Troubleshooting

  • The connection test fails with an authentication error. Double-check the customer code, and make sure the API token was copied in full with no extra spaces. Confirm the token was generated by an organization admin, team admin, or primary billing contact.

  • A user is missing from Ploy. Ploy only sees people with an assigned commercial licence. Free or Community-edition users, and anyone without a licence, will not appear.

  • You cannot generate a token. Your JetBrains role does not have API access. Ask an organization admin or primary billing contact to generate the token for you.

Was this helpful?