feat: add third-party integration docs - #2623
Merged
Merged
Conversation
Adds 90 community-contributed integration stubs from ory/integrates, organized by vendor category under docs/integrates-with/<category>/<vendor>.mdx, and wires them into sidebars-integrates.ts (27 category sections). For pages that overlap with an existing source-of-truth doc in this repo (Mailchimp via Actions, GitHub sign-in, kratos SMTP and SMS courier pages), the new page leads with a "Primary documentation" admonition linking to the canonical page; see docs/integrates-with/_DUPLICATES.md for the inventory.
…pages Merge the draft provider snippets that were staged under docs/integrates-with into the canonical Ory courier pages: - 01_sending-emails-smtp.mdx: add Brevo, Mailchimp Transactional (Mandrill), and SparkPost as first-class provider entries alongside Sendgrid/Mailgun/SES/Postmark. - 10_sending-sms.mdx: add a Provider examples section with Twilio, MessageBird, Plivo, Sinch, Vonage, and WhatsApp Business request_config examples (the page previously only showed Twilio inline). Removes the now-folded snippet drafts and the _DUPLICATES.md inventory, since the overlaps they tracked are now resolved in-page.
Add a proper Terraform page for the official ory/ory provider, which had no page in this repo (its canonical docs are external, on the Terraform/OpenTofu registries). Repoint pulumi.mdx's three references from the ory/integrates GitHub URL to the new internal ./terraform.mdx, and add it to the IaC and DevOps sidebar category above Pulumi.
Per the integrations-team handoff, collapse community stubs that duplicate existing first-party Ory docs: - SMS providers: delete the standalone messagebird/plivo/sinch/twilio/ vonage stubs (now folded into kratos/emails-sms/sending-sms) and drop them from the sidebar. Keep WhatsApp as its own page (custom courier handler, not a plain SMS provider) and point the SMS page's WhatsApp entry at it. - Mailchimp marketing: fold the marketing-audience flow into the existing actions/integrations/mailchimp page as a section (it already covers both subsystems) and delete the cdp-analytics/mailchimp and cdp-analytics/mailchimp-marketing duplicates. - Helm: add a thin integrates-with/iac-devops/helm pointer page with a rel=canonical to the existing hydra/self-hosted Helm chart guide, so the official charts are discoverable under IaC and DevOps without duplicating content.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…-deployment homes) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…upe salesforce/workday slugs
Apply the ory-docs-voice style guide across the integration catalog: convert telegraphic fragments and arrow-chains into complete second-person sentences, fix terminology (Ory Identities, sign in, self-service flows, set up, Admin API, full product names on first mention), and remove marketing fluff. Thin canonical-pointer stubs were largely already on-voice and left as-is. Preserved: frontmatter, <head> canonical links, admonition types/titles and their links, page types, all link targets/anchors, and the existing /docs/actions links (pending a separate docs-team decision).
* docs: fix underscores * docs: added redirects
* feat: document transient payload passthrough in elements * chore: format * Apply suggestions from code review Co-authored-by: Jonas Hungershausen <jonas.hungershausen@gmail.com> * Apply suggestions from code review Co-authored-by: unatasha8 <una.cogavin@ory.sh> --------- Co-authored-by: unatasha8 <una.cogavin@ory.sh>
* feat: add docs for client side events in elements * Apply suggestions from code review Co-authored-by: unatasha8 <una.cogavin@ory.sh> Co-authored-by: Jonas Hungershausen <jonas.hungershausen@gmail.com> * chore: format * chore: apply suggestion * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: unatasha8 <una.cogavin@ory.sh> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
added docs for scim mapper now receiving identity
* feat: add docs for ory elements v1.2 * Apply suggestions from code review Co-authored-by: Vincent <vincent@ory.sh> * chore: u * chore: u * chore: regnerate type docs * chore: use ProjectConfiguration * chore: u --------- Co-authored-by: Vincent <vincent@ory.sh>
chore(docs): update OEL image tag
Add a "Pause and resume event streams" section to the live event streams guide covering how to pause/resume a stream from the Ory Console, how to create a stream as paused, and what happens to events while a stream is paused. Most importantly, it explains the buffering behavior: while paused, events keep accumulating and are retained for up to 7 days. Resuming within that window delivers the buffered backlog; events older than 7 days are permanently discarded. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
wassimoo
requested review from
aeneasr,
piotrmsc,
unatasha8,
vinckr and
zepatrik
as code owners
June 11, 2026 14:15
|
No actionable comments were generated in the recent review. 🎉 ℹ️ Recent review info⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: CHILL Plan: Pro Plus Run ID: 📒 Files selected for processing (3)
✅ Files skipped from review due to trivial changes (1)
📝 WalkthroughWalkthroughThis PR adds a complete integrations documentation section, wires it into the main sidebar and navbar, updates navbar responsive breakpoints and mobile sidebar behavior, prefers explicit DocCard href values, and ignores Claude Code local files. ChangesIntegrations Documentation Setup
Estimated Code Review Effort🎯 3 (Moderate) | ⏱️ ~20 minutes Suggested labels
Suggested reviewers
Poem
🚥 Pre-merge checks | ✅ 4 | ❌ 1❌ Failed checks (1 warning)
✅ Passed checks (4 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches📝 Generate docstrings
🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![coderabbitai[bot]](https://cdn.github.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
🧹 Nitpick comments (2)
sidebars-integrates.ts (2)
7-7: 💤 Low valueUnused type alias.
The
SidebarItemsConfigtype alias is defined but never used in this file. Consider removing it or applying it to theintegratesSidebarconstant for type safety.♻️ Option 1: Remove unused type
-type SidebarItemsConfig = SidebarItemConfig[] -♻️ Option 2: Apply type to constant
-const integratesSidebar = [ +const integratesSidebar: SidebarItemsConfig = [🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@sidebars-integrates.ts` at line 7, The file defines an unused type alias SidebarItemsConfig; either delete this unused alias or apply it to the integratesSidebar constant for type safety — locate the SidebarItemsConfig declaration and either remove that line, or annotate the integratesSidebar export (symbol integratesSidebar) with the SidebarItemsConfig type so the alias is actually used.
101-105: ⚡ Quick winInconsistent category link configuration.
Two categories ("Data persistence" and "IaC and DevOps") are missing the
linkproperty that all other 25 categories have. This means these categories won't have generated index pages, creating an inconsistent navigation experience.♻️ Add missing link properties for consistency
For "Data persistence" category:
{ type: "category", label: "Data persistence", + link: { type: "generated-index" }, items: ["integrates-with/data-persistence/cockroachdb"], },For "IaC and DevOps" category:
{ type: "category", label: "IaC and DevOps", + link: { type: "generated-index" }, items: [Also applies to: 202-208
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@sidebars-integrates.ts` around lines 101 - 105, Two category objects ("Data persistence" and "IaC and DevOps") are missing the standardized link property used by the other categories, so add a link entry to each category object to generate an index page consistent with the other 25 categories; for each category (the objects with label "Data persistence" and label "IaC and DevOps" in sidebars-integrates.ts) add a link property matching the pattern used elsewhere (e.g., the same link type and id/slug format used by the other categories) so the categories produce generated index pages and consistent navigation.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Nitpick comments:
In `@sidebars-integrates.ts`:
- Line 7: The file defines an unused type alias SidebarItemsConfig; either
delete this unused alias or apply it to the integratesSidebar constant for type
safety — locate the SidebarItemsConfig declaration and either remove that line,
or annotate the integratesSidebar export (symbol integratesSidebar) with the
SidebarItemsConfig type so the alias is actually used.
- Around line 101-105: Two category objects ("Data persistence" and "IaC and
DevOps") are missing the standardized link property used by the other
categories, so add a link entry to each category object to generate an index
page consistent with the other 25 categories; for each category (the objects
with label "Data persistence" and label "IaC and DevOps" in
sidebars-integrates.ts) add a link property matching the pattern used elsewhere
(e.g., the same link type and id/slug format used by the other categories) so
the categories produce generated index pages and consistent navigation.
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro Plus
Run ID: c40924e3-a3b2-4d71-956a-30be1dbf4f79
⛔ Files ignored due to path filters (149)
docs/actions/integrations/mailchimp.mdxis excluded by!**/*.mdxdocs/integrates-with/agent-identity/skyfire.mdxis excluded by!**/*.mdxdocs/integrates-with/agent-identity/tetrate.mdxis excluded by!**/*.mdxdocs/integrates-with/api-gateways/apigee.mdxis excluded by!**/*.mdxdocs/integrates-with/api-gateways/aws-api-gateway.mdxis excluded by!**/*.mdxdocs/integrates-with/api-gateways/envoy.mdxis excluded by!**/*.mdxdocs/integrates-with/api-gateways/kong.mdxis excluded by!**/*.mdxdocs/integrates-with/api-gateways/traefik.mdxis excluded by!**/*.mdxdocs/integrates-with/cdp-analytics/amplitude.mdxis excluded by!**/*.mdxdocs/integrates-with/cdp-analytics/mailchimp.mdxis excluded by!**/*.mdxdocs/integrates-with/cdp-analytics/mixpanel.mdxis excluded by!**/*.mdxdocs/integrates-with/cdp-analytics/mparticle.mdxis excluded by!**/*.mdxdocs/integrates-with/cdp-analytics/segment.mdxis excluded by!**/*.mdxdocs/integrates-with/cloud-infrastructure/aws.mdxis excluded by!**/*.mdxdocs/integrates-with/cloud-infrastructure/azure.mdxis excluded by!**/*.mdxdocs/integrates-with/cloud-infrastructure/gcp.mdxis excluded by!**/*.mdxdocs/integrates-with/compliance-audit/drata.mdxis excluded by!**/*.mdxdocs/integrates-with/compliance-audit/vanta.mdxis excluded by!**/*.mdxdocs/integrates-with/consent-privacy/didomi.mdxis excluded by!**/*.mdxdocs/integrates-with/consent-privacy/onetrust.mdxis excluded by!**/*.mdxdocs/integrates-with/consent-privacy/osano.mdxis excluded by!**/*.mdxdocs/integrates-with/containerization/docker.mdxis excluded by!**/*.mdxdocs/integrates-with/containerization/kubernetes.mdxis excluded by!**/*.mdxdocs/integrates-with/crm/hubspot.mdxis excluded by!**/*.mdxdocs/integrates-with/crm/microsoft-dynamics-365.mdxis excluded by!**/*.mdxdocs/integrates-with/crm/pipedrive.mdxis excluded by!**/*.mdxdocs/integrates-with/crm/salesforce.mdxis excluded by!**/*.mdxdocs/integrates-with/crm/zoho-crm.mdxis excluded by!**/*.mdxdocs/integrates-with/data-persistence/cockroachdb.mdxis excluded by!**/*.mdxdocs/integrates-with/directory-sync/bamboohr.mdxis excluded by!**/*.mdxdocs/integrates-with/directory-sync/google-workspace-scim.mdxis excluded by!**/*.mdxdocs/integrates-with/directory-sync/jumpcloud-scim.mdxis excluded by!**/*.mdxdocs/integrates-with/directory-sync/microsoft-scim.mdxis excluded by!**/*.mdxdocs/integrates-with/directory-sync/okta-scim.mdxis excluded by!**/*.mdxdocs/integrates-with/directory-sync/onelogin-scim.mdxis excluded by!**/*.mdxdocs/integrates-with/directory-sync/workday-scim.mdxis excluded by!**/*.mdxdocs/integrates-with/edge-token-validation/akamai-edgeworkers.mdxis excluded by!**/*.mdxdocs/integrates-with/edge-token-validation/cloudflare-workers.mdxis excluded by!**/*.mdxdocs/integrates-with/edge-token-validation/fastly-compute.mdxis excluded by!**/*.mdxdocs/integrates-with/email-providers/aws-ses.mdxis excluded by!**/*.mdxdocs/integrates-with/email-providers/brevo.mdxis excluded by!**/*.mdxdocs/integrates-with/email-providers/mailchimp-transactional.mdxis excluded by!**/*.mdxdocs/integrates-with/email-providers/mailgun.mdxis excluded by!**/*.mdxdocs/integrates-with/email-providers/postmark.mdxis excluded by!**/*.mdxdocs/integrates-with/email-providers/sendgrid.mdxis excluded by!**/*.mdxdocs/integrates-with/email-providers/sparkpost.mdxis excluded by!**/*.mdxdocs/integrates-with/enterprise-sso/auth0-saml.mdxis excluded by!**/*.mdxdocs/integrates-with/enterprise-sso/cyberark-identity.mdxis excluded by!**/*.mdxdocs/integrates-with/enterprise-sso/forgerock-am.mdxis excluded by!**/*.mdxdocs/integrates-with/enterprise-sso/generic-oidc.mdxis excluded by!**/*.mdxdocs/integrates-with/enterprise-sso/generic-saml.mdxis excluded by!**/*.mdxdocs/integrates-with/enterprise-sso/google-workspace.mdxis excluded by!**/*.mdxdocs/integrates-with/enterprise-sso/hid-global.mdxis excluded by!**/*.mdxdocs/integrates-with/enterprise-sso/ibm-security-verify.mdxis excluded by!**/*.mdxdocs/integrates-with/enterprise-sso/jumpcloud.mdxis excluded by!**/*.mdxdocs/integrates-with/enterprise-sso/keycloak.mdxis excluded by!**/*.mdxdocs/integrates-with/enterprise-sso/microsoft-adfs.mdxis excluded by!**/*.mdxdocs/integrates-with/enterprise-sso/microsoft-entra-id.mdxis excluded by!**/*.mdxdocs/integrates-with/enterprise-sso/okta.mdxis excluded by!**/*.mdxdocs/integrates-with/enterprise-sso/onelogin.mdxis excluded by!**/*.mdxdocs/integrates-with/enterprise-sso/pingone.mdxis excluded by!**/*.mdxdocs/integrates-with/enterprise-sso/rippling.mdxis excluded by!**/*.mdxdocs/integrates-with/feature-flags/launchdarkly.mdxis excluded by!**/*.mdxdocs/integrates-with/feature-flags/split-io.mdxis excluded by!**/*.mdxdocs/integrates-with/fraud-bot-protection/arkose-labs.mdxis excluded by!**/*.mdxdocs/integrates-with/fraud-bot-protection/castle.mdxis excluded by!**/*.mdxdocs/integrates-with/fraud-bot-protection/cloudflare-turnstile.mdxis excluded by!**/*.mdxdocs/integrates-with/fraud-bot-protection/hcaptcha.mdxis excluded by!**/*.mdxdocs/integrates-with/fraud-bot-protection/recaptcha.mdxis excluded by!**/*.mdxdocs/integrates-with/fraud-bot-protection/sift.mdxis excluded by!**/*.mdxdocs/integrates-with/generic-protocols/generic-oidc.mdxis excluded by!**/*.mdxdocs/integrates-with/generic-protocols/generic-saml.mdxis excluded by!**/*.mdxdocs/integrates-with/government-identity/aadhaar.mdxis excluded by!**/*.mdxdocs/integrates-with/government-identity/bankid.mdxis excluded by!**/*.mdxdocs/integrates-with/government-identity/eidas.mdxis excluded by!**/*.mdxdocs/integrates-with/government-identity/idin.mdxis excluded by!**/*.mdxdocs/integrates-with/iac-devops/helm.mdxis excluded by!**/*.mdxdocs/integrates-with/iac-devops/pulumi.mdxis excluded by!**/*.mdxdocs/integrates-with/iac-devops/terraform.mdxis excluded by!**/*.mdxdocs/integrates-with/identity-verification/equifax.mdxis excluded by!**/*.mdxdocs/integrates-with/identity-verification/gbg-acuant.mdxis excluded by!**/*.mdxdocs/integrates-with/identity-verification/id-me.mdxis excluded by!**/*.mdxdocs/integrates-with/identity-verification/jumio.mdxis excluded by!**/*.mdxdocs/integrates-with/identity-verification/lexisnexis.mdxis excluded by!**/*.mdxdocs/integrates-with/identity-verification/onfido.mdxis excluded by!**/*.mdxdocs/integrates-with/identity-verification/persona.mdxis excluded by!**/*.mdxdocs/integrates-with/identity-verification/prove.mdxis excluded by!**/*.mdxdocs/integrates-with/identity-verification/socure.mdxis excluded by!**/*.mdxdocs/integrates-with/mfa/duo-security.mdxis excluded by!**/*.mdxdocs/integrates-with/mfa/okta-verify.mdxis excluded by!**/*.mdxdocs/integrates-with/mfa/yubikey.mdxis excluded by!**/*.mdxdocs/integrates-with/monitoring-observability/datadog.mdxis excluded by!**/*.mdxdocs/integrates-with/monitoring-observability/new-relic.mdxis excluded by!**/*.mdxdocs/integrates-with/monitoring-observability/opentelemetry.mdxis excluded by!**/*.mdxdocs/integrates-with/monitoring-observability/prometheus-grafana.mdxis excluded by!**/*.mdxdocs/integrates-with/payment-billing/recurly.mdxis excluded by!**/*.mdxdocs/integrates-with/payment-billing/stripe.mdxis excluded by!**/*.mdxdocs/integrates-with/siem-security-analytics/elastic-siem.mdxis excluded by!**/*.mdxdocs/integrates-with/siem-security-analytics/microsoft-sentinel.mdxis excluded by!**/*.mdxdocs/integrates-with/siem-security-analytics/splunk.mdxis excluded by!**/*.mdxdocs/integrates-with/siem-security-analytics/sumo-logic.mdxis excluded by!**/*.mdxdocs/integrates-with/sms-providers/messagebird.mdxis excluded by!**/*.mdxdocs/integrates-with/sms-providers/plivo.mdxis excluded by!**/*.mdxdocs/integrates-with/sms-providers/sinch.mdxis excluded by!**/*.mdxdocs/integrates-with/sms-providers/twilio.mdxis excluded by!**/*.mdxdocs/integrates-with/sms-providers/vonage.mdxis excluded by!**/*.mdxdocs/integrates-with/sms-providers/whatsapp.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/amazon-lwa.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/apple.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/auth0.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/battle-net.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/dingtalk.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/discord.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/epic-games.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/facebook.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/github-app.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/github.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/gitlab.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/google.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/kakao.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/lark.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/line.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/linkedin.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/microsoft.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/naver.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/netid.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/patreon.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/salesforce.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/slack.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/spotify.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/steam.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/telegram.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/tiktok.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/twitch.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/uaepass.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/vk.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/wechat.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/x-twitter.mdxis excluded by!**/*.mdxdocs/integrates-with/social-sign-in/yandex.mdxis excluded by!**/*.mdxdocs/integrates-with/support-helpdesk/freshdesk.mdxis excluded by!**/*.mdxdocs/integrates-with/support-helpdesk/intercom.mdxis excluded by!**/*.mdxdocs/integrates-with/support-helpdesk/zendesk.mdxis excluded by!**/*.mdxdocs/integrates-with/user-enrichment/clearbit.mdxis excluded by!**/*.mdxdocs/integrates-with/user-enrichment/fullcontact.mdxis excluded by!**/*.mdxdocs/integrates-with/user-enrichment/zoominfo.mdxis excluded by!**/*.mdxdocs/integrates-with/webhook-infrastructure/hookdeck.mdxis excluded by!**/*.mdxdocs/integrates-with/webhook-infrastructure/svix.mdxis excluded by!**/*.mdxdocs/kratos/emails-sms/01_sending-emails-smtp.mdxis excluded by!**/*.mdxdocs/kratos/emails-sms/10_sending-sms.mdxis excluded by!**/*.mdx
📒 Files selected for processing (5)
.gitignoresidebars-integrates.tssidebars.tssrc/navbar.tssrc/theme/DocCard/index.tsx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
9 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds documentation for connecting Ory Network to third-party products, for more info see: https://github.com/ory/integrates
Checklist
If this pull request addresses a security vulnerability,
I confirm that I got approval (please contact security@ory.com) from the maintainers to push the changes.
Further comments
Summary by CodeRabbit
New Features
Style / UI
Chores