Before you go live
Credentials- Production API key lives in a secret manager, redacted from logs and error tracking.
- No Development keys in the production path. They cannot read Production data.
- Connector tokens are encrypted at rest.
origin_idis your stable internal tenant ID, not a name or an email.- Token exchange runs server-side. It needs your API key and must never run in the browser.
- A reconnect path exists for
RELINK_NEEDED, which never resolves on its own.
- Pagination stops on
cursor == null, not on a short page. - Every field is treated as nullable, and no
switchover an enum runs without a default - unmapped vendor values pass through verbatim. See Enum values. - Writes carry
X-Idempotency-Key- see Idempotency. Passthrough takes no key, so check before retrying. - Request bodies come from the Meta schema, not hardcoded.
429is retried usingRetry-After;5xxwith capped backoff; other4xxnever.- A scheduled reconciliation sweep exists. Webhook retries stop after ~60 seconds, so anything longer than a brief outage is lost silently.
integration_slugis on every log line. It turns “some customers fail” into “Workday customers fail”.- Alerts fire on consecutive failures and on staleness, not on single transient errors.
- Data age is shown - “Last synced 4 hours ago”. This is the biggest single reduction in support volume.
- First-sync state looks different from an empty account.
- Manual resync is throttled, and nothing resyncs on a timer.
Related
- Ideal workflow - the build order this checklist verifies.
- Troubleshooting - the order to debug a connector in, once you are live.
- Sync status - building the health surface your support team reads.
- Syncing - how and when Bindbee refreshes data.
- Platform - the Dashboard changelog, worth checking before each release.