Capabilities
Gather Shareworks credentials
1
Complete Shareworks API onboarding to obtain a client ID and register your
RSA public key with Shareworks.
2
Keep the matching RSA private key (PEM) available; the connector uses it to
sign the verification JWT that is exchanged for an access token.
3
Note whether your access targets the production or QA Shareworks
environment, and any key identifier (kid) assigned during onboarding.
Configuration fields
Synced resource types
- Participants: equity plan participants from
GET /rest/admin/v1/participants. - Companies: administering companies from
GET /rest/admin/v1/companies. - Plans: equity and stock plans from
GET /rest/admin/v1/plans. - Company membership grants: participants are emitted as company member grants, and company administrators receive an additional admin grant.
- Plan membership grants: enrolled participants are emitted as plan member grants.
Special notes
- All Shareworks resource types are opt-in.
- Company and plan memberships are not separate resources; they are grant edges on the company and plan resources.
- Authentication is a two-step exchange: the connector signs a verification JWT with the client RSA private key and exchanges it for a short-lived access token, which is cached and refreshed before expiry.
- List endpoints use
offsetandlimitpagination. - On rate limit responses, the connector retries with exponential backoff.
Configure the Shareworks connector
- Cloud-hosted
- Self-hosted
Follow these instructions to use a built-in, no-code connector hosted by C1.Done. Your Shareworks connector is now pulling access data into C1.
1
In C1, navigate to Apps > Connectors and click Add connector.
2
Search for Shareworks and click Add.
3
Choose where to add the connector: Create a new app, or Add to an existing app (then select the app).If you’re creating a new app, choose whether to link it to an application discovered from your identity provider: select Yes and pick the IdP application, or No to continue with just the connector.
4
Set the connector’s Name and, optionally, a Description.
5
Click the pencil icon next to Owners to choose who can configure and manage this connector.
6
Click Add. The connector is created and its configuration page opens.
7
Find the Settings area of the page and click Edit.
8
Enter the Shareworks credentials:
- Environment:
productionorqa. - Client ID: the client identifier from onboarding.
- Private key (PEM): the RSA private key matching your registered public key.
- Key ID: the optional key identifier, if assigned.
9
Click Save.
10
The connector’s label changes to Syncing, followed by Connected. You can view the logs to ensure that information is syncing.