Create, classify, and monitor contractor hires via the Worksome GraphQL API and webhooks

Steps

1. Generate an API access token from your Worksome account's Authentication settings, per the GraphQL Getting Started guide.
2. Send GraphQL requests as HTTP POST with a JSON body to https://api.worksome.com/graphql, passing the access token in the request's auth header.
3. Browse available types and operations via the Apollo Studio-hosted schema explorer linked from the docs, which Worksome recommends over the static reference pages for searching the current schema.
4. Submit a hire/contract creation mutation with worker and engagement details to bring a new contractor into a hire; the hire is routed through classification and approval steps server-side.
5. Register a webhook endpoint with a shared secret and subscribe to lifecycle events such as HIRE_CREATED, HIRE_CHANGED, CLASSIFICATION_CREATED, contractAccepted, hireCancelled, and hireTerminated to track status changes without polling.
6. On each inbound webhook call, recompute the HMAC-SHA256 signature of the payload using your shared secret and compare it against the signature header to confirm the request originated from Worksome before trusting the payload.