integrations & errors

Author: ethanpalm

settings.mdx

@@ -665,174 +665,201 @@ This section contains the full reference for the `docs.json` file.
 ### Integrations
 
 <ResponseField name="integrations" type="object">
-  Configurations for official integrations
+  Third-party integrations.
 
   <Expandable title="Integrations">
     <ResponseField name="amplitude" type="object">
+      Amplitude analytics integration.
 
       <Expandable title="Amplitude">
         <ResponseField name="apiKey" type="string" required>
-          The API key for Amplitude.
+          Your Amplitude API key.
         </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="clearbit" type="object">
-
+      Clearbit data enrichment integration.
+      
       <Expandable title="Clearbit">
         <ResponseField name="publicApiKey" type="string" required>
-          The public API key for Clearbit.
+          Your Clearbit API key.
         </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="fathom" type="object">
-
+      Fathom analytics integration.
+      
       <Expandable title="Fathom">
         <ResponseField name="siteId" type="string" required>
-          The site ID for Fathom.
+          Your Fathom site ID.
         </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="frontchat" type="object">
-
+      Front chat integration.
+      
       <Expandable title="Frontchat">
         <ResponseField name="snippetId" type="string" required>
+          Your Front chat snippet ID.
 
           Minimum length: 6
         </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="ga4" type="object">
-
+      Google Analytics 4 integration.
+      
       <Expandable title="Ga4">
         <ResponseField name="measurementId" type="string matching ^G" required>
-
+          Your Google Analytics 4 measurement ID.
+          
           Must match pattern: ^G
         </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="gtm" type="object">
-
+      Google Tag Manager integration.
+      
       <Expandable title="Gtm">
         <ResponseField name="tagId" type="string matching ^G" required>
-
+          Your Google Tag Manager tag ID.
+          
           Must match pattern: ^G
         </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="heap" type="object">
-
+      Heap analytics integration.
+      
       <Expandable title="Heap">
         <ResponseField name="appId" type="string" required>
-          The app ID for Heap.
+          Your Heap app ID.
         </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="hotjar" type="object">
-
+      Hotjar integration.
+      
       <Expandable title="Hotjar">
         <ResponseField name="hjid" type="string" required>
-          The Hotjar ID.
+          Your Hotjar ID.
         </ResponseField>
         <ResponseField name="hjsv" type="string" required>
-          The Hotjar script version.
+          Your Hotjar script version.
         </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="intercom" type="object">
-
+      Intercom integration.
+      
       <Expandable title="Intercom">
         <ResponseField name="appId" type="string" required>
-
+          Your Intercom app ID.
+          
           Minimum length: 6
         </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="koala" type="object">
-
+      Koala integration.
+      
       <Expandable title="Koala">
         <ResponseField name="publicApiKey" type="string" required>
-
+          Your Koala public API key.
+          
           Minimum length: 2
         </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="logrocket" type="object">
-
+      LogRocket integration.
+      
       <Expandable title="Logrocket">
         <ResponseField name="appId" type="string" required>
-          The app ID for Logrocket.
+          Your LogRocket app ID.
         </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="mixpanel" type="object">
+      Mixpanel integration.
 
       <Expandable title="Mixpanel">
         <ResponseField name="projectToken" type="string" required>
-          The project token for Mixpanel.
+          Your Mixpanel project token.
         </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="osano" type="object">
-
+      Osano integration.
+      
       <Expandable title="Osano">
         <ResponseField name="scriptSource" type="string" required>
-          The script source for Osano.
+          Your Osano script source.
         </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="pirsch" type="object">
-
+      Pirsch analytics integration.
+      
       <Expandable title="Pirsch">
         <ResponseField name="id" type="string" required>
-          The ID for Pirsch.
+          Your Pirsch ID.
         </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="posthog" type="object">
-
+      PostHog integration.
+      
       <Expandable title="Posthog">
         <ResponseField name="apiKey" type="string matching ^phc\_" required>
-
+          Your PostHog API key.
+          
           Must match pattern: ^phc\_
         </ResponseField>
         <ResponseField name="apiHost" type="string (uri)">
-          The API host for Posthog.
+          Your PostHog API host.
         </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="plausible" type="object">
-
+      Plausible analytics integration.
+      
       <Expandable title="Plausible">
         <ResponseField name="domain" type="string" required>
-          The domain for Plausible.
+          Your Plausible domain.
         </ResponseField>
         <ResponseField name="server" type="string">
-          The server for Plausible.
+          Your Plausible server.
         </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="segment" type="object">
+      Segment integration.
+      
       <Expandable title="Segment">
         <ResponseField name="key" type="string" required>
-          The key for Segment.
+          Your Segment key.
         </ResponseField>
       </Expandable>
     </ResponseField>
-
     <ResponseField name="telemetry" type="object">
+      Telemetry settings.
+      
       <Expandable title="Telemetry">
         <ResponseField name="enabled" type="boolean">
           Whether to enable telemetry.
         </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="cookies" type="object">
+      Cookie settings.
+      
       <Expandable title="Cookies">
         <ResponseField name="key" type="string">
-          The key for cookies.
+          Key for cookies.
         </ResponseField>
         <ResponseField name="value" type="string">
-          The value for cookies.
+          Value for cookies.
         </ResponseField>
       </Expandable>
     </ResponseField>
@@ -842,11 +869,15 @@ This section contains the full reference for the `docs.json` file.
 ### Errors
 
 <ResponseField name="errors" type="object">
+  Error handling settings.
+  
   <Expandable title="Errors">
     <ResponseField name="404" type="object">
+      404 "Page not found" error handling.
+      
       <Expandable title="404">
         <ResponseField name="redirect" type="boolean">
-          Whether to redirect to the home page, if the page is not found
+          Whether to automatically redirect to the home page when a page is not found.
         </ResponseField>
       </Expandable>
     </ResponseField>