ck_dev_… locally, ck_prod_… in production):
Create a connect session
201 with { "token", "connectUrl", "projectId", "environmentId", "expiresAt" }. Redirect the user’s browser to connectUrl. Hub hosts the connect page and the OAuth callback.
Receive the delivery
When the user finishes connecting, Hub POSTs a signed JSON envelope to yourdeliveryUrl. The body is { "type", "payload" }, with these headers:
Verify before trusting the body. Recompute the HMAC over the raw bytes and compare in constant time:
verify passes: parse the body, exchange or store the credential, and respond 200.
List connections
cURL
{ tenantId, plugin, status, authType, connected, verified, missingFields, reportedAt }, one entry per tenantId:plugin. connected and verified are booleans; reportedAt is an ISO timestamp.