ngrok

Connect your ngrok account to Ploy to automatically discover everyone on your ngrok account, see whether each of them is enabled or disabled, and manage their access — disabling, re-enabling and creating users directly from Ploy. Ploy connects through ngrok's user provisioning (SCIM) interface, authenticated with a single ngrok API key.

What Ploy syncs

Users: every user on your ngrok account, with their name, email address and when they were added.
Account status: whether each user is enabled or disabled in ngrok. A disabled user shows in Ploy as an inactive, blocked identity.
App access: an ngrok access record for every enabled user, so you can see exactly who holds an ngrok seat. When a user is disabled or removed in ngrok, Ploy revokes their ngrok access on the next sync.

Ploy re-scans your ngrok account every 6 hours.

A few things ngrok's provisioning interface does not expose, so Ploy cannot sync them: account roles (Administrator, Team Manager, Developer), MFA status, and last sign-in or usage activity.

Before you begin

You need access to the ngrok dashboard as a user who can create API keys.
User provisioning (SCIM) must be available on your ngrok account. SCIM is included on ngrok's Enterprise plan. On Pay-as-you-go it needs the SSO and RBAC add-on plus the Identity and Access Governance add-on, and ngrok asks you to contact their support team to switch SCIM on.
Single sign-on must be configured on your ngrok account first — ngrok's user provisioning endpoint is only available once SSO is set up. See ngrok's SSO and SCIM documentation at https://ngrok.com/docs/iam/sso for how to set this up.

Create an API key in ngrok

Log in to the ngrok dashboard.
Go to Settings, then API Keys — or open https://dashboard.ngrok.com/api-keys directly.
Create a new API key. A description like ploy-integration makes it easy to identify later.
Copy the key — you'll paste it into Ploy in the next section.

Connect ngrok to Ploy

In Ploy, go to Integrations, find ngrok and start the setup.
The setup page links to ngrok's SSO and SCIM docs (Set up user provisioning in ngrok) and to your ngrok API keys page (Create an API key in ngrok) if you still need to do either step.
Under Enter your ngrok API key, paste the API key you created. This field is required.
Complete the setup. Ploy immediately verifies the connection by reading your ngrok user list with the key — if anything is wrong you'll see a specific error message (see Troubleshooting below), and once the check passes the integration is connected and the first sync begins.

What Ploy can change in ngrok

With the integration connected, Ploy can also make changes to your ngrok account — for example from onboarding and offboarding flows:

Create a user: Ploy adds a new user to your ngrok account through ngrok's provisioning API, with their email address and display name. The new user starts enabled, and ngrok assigns the account role itself — Ploy does not set one.
Disable a user: Ploy disables the user in ngrok, which blocks them from the account. The user's record stays on the account and Ploy revokes their ngrok access record.
Re-enable a user: Ploy re-enables a previously disabled user, restoring their access.

Ploy does not delete ngrok users: ngrok's provisioning interface handles deprovisioning by disabling a user rather than deleting them, so disabling is the supported way to remove someone's access.

Troubleshooting

"ngrok rejected that API key. Generate a new one and paste it again."

The API key you pasted is not valid — it may have been mistyped, revoked or rotated. Create a fresh key in the ngrok dashboard and run the setup again with the new key.

"ngrok's user provisioning endpoint isn't available on this account. It needs SSO to be set up first."

Your API key is fine, but ngrok's user provisioning (SCIM) endpoint is not enabled on your account. Make sure single sign-on is configured, that your plan includes SCIM (see Before you begin), and contact ngrok support if it still isn't available.

"We couldn't read your ngrok users with that API key. Check the key and try again."

Ploy could not read your ngrok user list. Double-check the key was pasted correctly and that SCIM is enabled on your account, then try again.

The integration was working but has stopped syncing

If the API key is later revoked or rotated in ngrok, Ploy will report the integration as disconnected with a message like "ngrok rejected this API key. Generate a new one and paste it again." Create a new API key in the ngrok dashboard and reconnect the integration with the new key.

Was this helpful?