Skip to main content

Illumera Integration

Illumera provides staffing and talent for Align projects. The connection is a Marketplace app published by Align Official. It works the other way round from most integrations: instead of Align reading from Illumera, Illumera calls Align's API with a key Align issues to it.

What the connection does​

The Illumera listing in the Marketplace describes the connection:

  • Activating an Illumera project creates the matching Align project, its statement-of-work milestones, and its people.
  • People arrive pending approval and non-billable, until a manager assigns a role and approves them.
  • Hours are logged in both systems.
  • Completing a milestone in Align unlocks the consultant's invoicing in Illumera.
  • You can also import an Align project into Illumera to source and fill open roles.

On Align's side, the connection unlocks these API endpoints for Illumera:

  • user invites and bulk provisioning;
  • project membership;
  • wiki pages;
  • time entries, including approval.

The listing also declares the Align events Illumera receives: agreement signed, release released, time logged, time approved, project member added, user invited, invoice finalized and invoice paid.

Installing​

You need the Admin role in your Align workspace.

  1. Open Marketplace and choose Illumera.
  2. Click Install and confirm.
  3. The Illumera connected dialog opens. There are no credentials to enter. Installing turns on the Illumera add-on for your workspace.
  4. Click Finish connecting in Illumera to complete the link from Illumera's side. Align issues the API key Illumera uses when you do. Choose Later to do it another time.

The Illumera add-on​

The Illumera endpoints need the Illumera add-on. Installing the Marketplace app turns it on.

Some workspaces also see an Illumera Integration card under Add-ons in Settings → Integrations. The card appears only where Align's billing portal is enabled for the workspace. From it you can:

  • see whether the add-on is active;
  • click Activate to start a subscription through checkout;
  • click Cancel add-on to cancel it. The add-on stays active until the end of the current billing period.

When the add-on is not active, calls to the Illumera endpoints are refused.

Disconnecting​

Open Marketplace → Installed Apps → Illumera and, under Danger Zone, cancel the installation. This revokes the API credential Illumera uses. The app can be reinstalled later.

Projects, people, milestones and time entries already in Align are not deleted.