Set Up Instructions

Alchemer

Connect Alchemer to Ploy to bring your Alchemer account users, teams and licence seats into Ploy. Once connected, Ploy keeps your Alchemer user list in sync automatically and can also manage the account lifecycle for you — creating, updating and removing users, and changing team memberships — as part of your Ploy workflows.

What Ploy syncs from Alchemer

Ploy connects to the Alchemer REST API and syncs on a regular schedule:

  • Account users — every user on your Alchemer account, including disabled users (shown as blocked in Ploy rather than silently missing). Ploy records each user's email, display name, administrator status, phone support flag and licence tier.

  • Last sign-in activity — each user's last login is synced as usage data, so you can see who is actually using their Alchemer seat.

  • The Alchemer app — Alchemer is added to your app inventory, with every account user recorded as a confirmed user of the app and administrators distinguished from regular users.

  • Teams — every Alchemer team is synced as a group, along with its members and their team roles. A team deleted in Alchemer is archived in Ploy and its memberships are revoked.

  • Licences — Ploy detects the licence tiers in use on your account (for example Full Access or Professional) and attributes a seat to each active user holding one, so seat changes are reconciled on every sync. Disabling a user releases their seat in Ploy.

Alchemer's API does not expose purchased seat counts or pricing, so those stay editable by your admins on the licence in Ploy. It also does not expose MFA status, so Ploy cannot report on MFA for Alchemer users.

Prerequisites

  • An Alchemer account administrator needs to create the API key. The account-user API is admin-only, so a key belonging to a non-administrator will not work.

  • Know which Alchemer data center your account is hosted in. Check the URL you see when logged in to Alchemer: app.alchemer.com (United States), app.alchemer.eu (European Union), app.alchemer-ca.com (Canada) or app.au.alchemer.com (Australia).

Step 1: Create an Alchemer API key

  1. Log in to Alchemer as an account administrator.

  2. Open the API key settings, found under Account, then Integrations, then API Key.

  3. Create an API key if you don't already have one.

  4. Copy both the API Token and the API Token Secret — you'll paste both into Ploy in the next step. Keep them somewhere safe.

Step 2: Connect Alchemer to Ploy

  1. In Ploy, go to the Integrations page and select Alchemer.

  2. Data Center — pick the region shown in your Alchemer URL when logged in: United States (app.alchemer.com), European Union (app.alchemer.eu), Canada (app.alchemer-ca.com) or Australia (app.au.alchemer.com). Using the wrong region rejects valid credentials.

  3. API Token — paste the API Token from Step 1.

  4. API Token Secret — paste the API Token Secret shown alongside the API Token.

  5. Test the connection, then save. Ploy verifies the credentials and starts the first sync.

All three fields are required.

What Ploy can change in Alchemer

With the integration connected, Ploy can also make changes in Alchemer as part of your workflows:

  • Create users — Ploy creates the account user in Alchemer, and Alchemer emails the new user to set their password. You can optionally set a licence tier and display name, or create the user disabled.

  • Update users — enable or disable the account (disabling frees the licence seat without deleting the user), change the licence tier, or change the display name.

  • Remove users — delete the account user from Alchemer entirely, freeing their licence seat.

  • Team membership — add a user to a team (they join with the team's default role) or remove them, for example when Ploy approves or revokes an access request for that team.

Updating your credentials

To rotate the API key, create the new key in Alchemer, then open the Alchemer integration in Ploy and paste the new API Token and API Token Secret. The saved secret is never displayed back — leave it untouched to keep the existing one, or paste a new value to replace it.

Troubleshooting

  • "Invalid API token or secret. Check the credentials and that the selected data center matches your account" — the token or secret is wrong, or your account lives in a different data center than the one selected. Alchemer rejects valid credentials sent to the wrong region, so double-check the URL you see when logged in to Alchemer and pick the matching Data Center.

  • "The API key must belong to an Alchemer account administrator" — the key you pasted works, but its owner is not an account administrator, so Alchemer refuses access to the account-user API. Create the key while logged in as an administrator.

  • "Alchemer is rate limiting requests. Please wait a minute and try again" — Alchemer is temporarily throttling API calls. Wait a minute and test the connection again. During scheduled syncs Ploy backs off and retries automatically.

  • "Alchemer authentication failed - check the API token, secret and data center" — a scheduled sync could no longer authenticate, usually because the API key was deleted or regenerated in Alchemer. Paste the current key into the integration and save.

  • "Alchemer returned an error: ..." — Alchemer rejected the request for another reason; the message shown comes directly from Alchemer.

Was this helpful?
Was this helpful?