Clear answers before you integrate

Frequently asked questions

The product boundary, current availability, security model, and operating behavior—without hiding the early-access edges.

Read the implementation guide

Product

What problem does Retrybase solve?

Retrybase turns broken customer integrations into a controlled recovery workflow: classify the failure, suppress incident noise, notify the right person, guide reconnection, and verify the connection is actually healthy.

Does Retrybase replace our integration platform?

No. It sits beside your existing OAuth implementation, integration code, iPaaS, unified API, or provider SDK.

Who is Retrybase for?

SaaS teams that own customer-facing integrations and need a reliable way to detect, explain, and recover broken connections.

Is Retrybase generally available?

Not yet. The product is in early access, and the public website remains intentionally excluded from search indexes during launch testing.

What is available today?

The durable event, classification, recovery, notification, verification, and reporting backend is running. A real Salesforce reference recovery has completed end to end.

Integration

Does Retrybase replace our OAuth implementation?

No. Your application continues to own OAuth, provider credentials, token refresh, and provider API calls.

How do we report a failure?

Send a normalized failure event containing your connection identifier, provider, timestamp, error code or HTTP status, and optional business metadata.

How does Retrybase know a connection recovered?

Your application runs a lightweight provider health probe and posts a verification result for the specific recovery attempt. Verification is authoritative; a browser return alone is not proof.

Can Retrybase detect silent failures?

Yes. Optional heartbeats let the watchdog identify connections that stopped reporting even when your application emitted no explicit error.

Which providers are available today?

The event model is provider-independent. The Salesforce reference flow is operational. HubSpot and Google recovery hosts are planned but are not yet generally available.

What happens during a provider-wide outage?

Retrybase correlates failures before notifying. Connections may be suppressed behind a provider incident so customers are not asked to fix something outside their control.

Security and data

Does Retrybase store provider access or refresh tokens?

No. Provider tokens remain inside your application or dedicated recovery host. Retrybase receives normalized operational events and verification results, not provider credentials.

Does Retrybase see customer records?

No. Retrybase is outside the data plane and does not need access to the records moving through an integration.

Does Retrybase write to providers?

No. Provider authorization and health checks are performed by the host application. Retrybase does not write to Salesforce, HubSpot, Google, or other providers.

What does Retrybase store?

It stores connection identifiers chosen by the SaaS application, normalized codes and statuses, timestamps, classifications, recovery state, notification outcomes, and optional business-impact metadata. Secret-looking fields are redacted before write.

How are recovery links protected?

Recovery links are signed, time-limited, and rate-limited. Opening the page does not start recovery, and the same link can be reopened to retry until it expires. Provider return state is separately signed, short-lived, bound to one attempt, and single-use.

Operations

Will duplicate events send duplicate email?

No. Event receipts, workflow handlers, notifications, and scheduled actions use durable idempotency keys. Work is delivered at least once but applied once logically.

What if verification never arrives?

Each attempt has a tenant-configurable verification deadline with a safety floor. The attempt expires back to action required instead of remaining in recovery forever.

What if verification arrives after the deadline?

A late healthy result is accepted as truth and recorded as a late verification rather than discarded.

How is email delivery tracked?

The first transport records submission, delivery, bounce, complaint, and open callbacks. Opens are treated as weak delivery evidence, never as proof of recovery.

Can we measure instrumentation gaps?

Yes. Coverage reporting identifies stale or missing heartbeats and compares watchdog-detected failures with failures reported by your own instrumentation.

Can we test before production?

Yes. Use a test project, a test inbox, and provider developer accounts. The Salesforce reference host uses a Developer Edition organization and a record-free limits probe.