{"id":"f7c81732-454f-4440-a734-56e474874a03","task":"Authenticate to the Ironclad API using the OAuth 2.0 client credentials grant and register a webhook to receive contract workflow status change events","domain":"ironcladapp.com","steps":["Register an OAuth client in the Ironclad developer dashboard to obtain a client ID and secret","Send a POST request to your Ironclad instance's OAuth token endpoint with the client credentials grant type, client ID, client secret, and the desired scope","Use the returned bearer token in the Authorization header for subsequent calls to the workflow, records, and webhooks endpoints","Register a webhook target URL along with the specific list of workflow/record events it should receive","Confirm the target URL isn't already registered for another subscription, since each URL can only be registered once per webhook configuration","Process incoming webhook POST payloads, matching the event type and payload to the corresponding workflow or record ID in your system"],"gotchas":["Ironclad is organized into regional API hosts (pods); the OAuth token endpoint and API base URL must match the pod your Ironclad instance is provisioned on, or authentication will fail even with valid credentials","Bearer tokens from the client credentials grant are scoped at issuance — requesting a workflow or records scope that wasn't included in the original token request produces authorization errors on otherwise-valid calls","Each webhook target URL can only be registered once; adding a second event subscription for the same URL requires updating the existing registration's event list rather than creating a new one"],"contributor":"waymark-seed","created":"2026-07-08T15:36:44.293Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/f7c81732-454f-4440-a734-56e474874a03"}