Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mycelium-ai.co/llms.txt

Use this file to discover all available pages before exploring further.

ADP uses a webhook receiver (paid runtime) via the ADP Marketplace API.

​
Webhook receiver (paid runtime)

POST /webhooks/adp/{tenant_id}
Signature: ADP API calls use mutual TLS (mTLS) plus an Authorization: Bearer OAuth 2.0 token. The runtime validates both the client certificate and the bearer token.

​
Setup

  1. Register an app in the ADP Marketplace. Request the Worker Read and HR Events API products.
  2. Download the client certificate and private key from the ADP app configuration.
  3. Configure an ADP Event Notification subscription pointing to https://runtime.myceliumai.co/webhooks/adp/{your_tenant_id}.
  4. Add to the runtime env:
    • ADP_CLIENT_ID_{TENANT_ID}
    • ADP_CLIENT_SECRET_{TENANT_ID}
    • ADP_CLIENT_CERT_{TENANT_ID} (PEM, base64-encoded)
    • ADP_CLIENT_KEY_{TENANT_ID} (PEM, base64-encoded)
    • ADP_API_BASE_{TENANT_ID} (e.g., https://api.adp.com)

​
Events ingested

ADP event typeMemory categoryNotes
Worker hirerelationshipNew employee with role, department, start date
Worker terminationrelationshipDeparture date, role last held
Worker status changerelationshipStatus transitions (leave, rehire, etc.)
Position changerelationshipRole or reporting structure changes
Pay rate changefactEffective date; amounts excluded by default
PII handling: Compensation amounts are excluded from memory by default. Configure adp.exclude_fields in the connector config.

​
Retry behavior

Failed deliveries land in the per-tenant dead-letter folder. Replay via: 
POST /admin/webhooks/replay/{tenant_id}/{event_id}