{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Manage OAuth Clients","description":"With the LawVu API, developers can build custom workflows and add-ons for LawVu customers","siteUrl":"https://developer.lawvu.com","keywords":"lawvu api, lawvu developer, legal tech, integrations, lawvu power platform connector","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"manage-oauth-clients","__idx":0},"children":["Manage OAuth Clients"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["LawVu allows you to create and manage ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/guides/authentication#overview"},"children":["custom OAuth clients"]}," for securely integrating external applications with the platform. This guide walks through each step of creating a new OAuth client, assigning the required permissions, and managing its configuration."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Creating and managing OAuth clients requires the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage Integrations"]}," permission. Without this permission, the Custom Integrations option will not appear."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Don't have access?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contact your LawVu organization administrator to enable the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage Integrations"]}," permission for your account. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.lawvu.com/en/articles/3202052-managing-roles-and-permissions-for-your-team-members#h_7a234181b7"},"children":["Managing roles and permissions"]}," help article for instructions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the permission has been granted, you may need to refresh the page for the change to take effect."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"creating-a-new-oauth-client","__idx":2},"children":["Creating a New OAuth Client"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1---open-custom-integrations","__idx":3},"children":["Step 1 - Open Custom Integrations"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integrations"]}," from the side panel."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom Integrations"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2---create-a-new-integration","__idx":4},"children":["Step 2 - Create a new integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Integration"]}," to open the setup form. You will be prompted to provide the following details:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"30%","data-label":"Field"},"children":["Field "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integration name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A descriptive, friendly name for your integration. This name is displayed on the OAuth consent screen when users authorize access."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirect URL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The HTTPS URL in your application that will receive OAuth callback responses. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/guides/authentication#redirect-uris"},"children":["Redirect URIs"]}," for requirements."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contact details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact information for the individual or team responsible for the integration. LawVu uses these details to communicate planned outages or breaking changes for the API."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Terms acceptance"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You must agree to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developer.lawvu.com/terms"},"children":["LawVu Developer Platform terms"]}," to create an integration."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-3---save-your-client-credentials","__idx":5},"children":["Step 3 - Save your client credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the integration is created, LawVu displays key identifiers and URLs. You should record these immediately."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Store your Client Secret now"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," is shown ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["only once"]}," at creation time. Copy and store it in a secure location (such as a secrets manager or vault) before leaving this page. If lost, you will need to generate a new secret."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"30%","data-label":"Value"},"children":["Value "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The unique identifier assigned to your integration. You will use this in all OAuth requests."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A secret string used during authentication. Store this securely - it cannot be retrieved after you leave the page."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret Expiry"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The validity period for the displayed secret. Expired secrets will be rejected during authentication. You can generate a new secret before expiry from the integration management page."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authorize URL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The frontend web URL used to initiate the OAuth authorization flow and obtain an authorization code."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token URL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The endpoint used by your application to exchange authorization codes or refresh tokens for access tokens."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Next step"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With your Client ID and Secret in hand, follow the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/guides/authentication"},"children":["Authentication guide"]}," to complete the OAuth authorization code flow and start making API calls."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"managing-existing-oauth-clients","__idx":6},"children":["Managing Existing OAuth Clients"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After creation, integrations can be updated from the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integrations"]}," page. Available actions include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Editing the integration name and contact details"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Adding or removing redirect URLs"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Creating new client secrets or revoking existing ones"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sandbox-vs-production-environments","__idx":7},"children":["Sandbox vs. Production Environments"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Sandbox clients cannot be migrated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["OAuth clients created in a sandbox environment ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["cannot"]}," be migrated to production. Sandbox integrations - including client IDs, client secrets, redirect URLs, and configuration - will ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," transfer automatically. Because these environments operate independently, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["all OAuth clients must be recreated manually in production"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you are ready to move to production, plan to:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Recreate the OAuth client in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["production"]}," Integrations area."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Generate and securely store a new client secret."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Update your application configuration with the new Client ID, Client Secret, Authorize URL, and Token URL."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]}]},"headings":[{"value":"Manage OAuth Clients","id":"manage-oauth-clients","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Creating a New OAuth Client","id":"creating-a-new-oauth-client","depth":2},{"value":"Step 1 - Open Custom Integrations","id":"step-1---open-custom-integrations","depth":3},{"value":"Step 2 - Create a new integration","id":"step-2---create-a-new-integration","depth":3},{"value":"Step 3 - Save your client credentials","id":"step-3---save-your-client-credentials","depth":3},{"value":"Managing Existing OAuth Clients","id":"managing-existing-oauth-clients","depth":2},{"value":"Sandbox vs. Production Environments","id":"sandbox-vs-production-environments","depth":2}],"frontmatter":{"title":"Managing Integration Clients guide","description":"Manage clients for integration with the LawVu API using OAuth 2.0.","markdown":{"lastUpdatedBlock":{"hide":false}},"seo":{"title":"Manage OAuth Clients"}},"lastModified":"2026-05-05T03:44:48.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/guides/integration-clients","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}