---
schema_version: "1"
id: 3deec55c6a33a72e1f9b8c5baca2156b6ebff1e8faad096a5fa5760147f290b4
title: Paste the JSON or YAML formatted Schema Into Your Browser
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/external_services_register_json.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.external_services_register_json.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 20ab00ab51b4117b854009089719560a4afc3d19d65d7b188d811aa351a51662
description: Copy and paste the JSON or YAML formatted schema into your browser.
products:
  - Salesforce Platform
  - Security
release: "264"
---
# Paste the JSON or YAML formatted Schema Into Your Browser

Copy and paste the JSON or YAML formatted schema into your browser.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d125301e72">User
              Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d125301e72 ">To manage connections: </td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d125301e72 ">Customize Application</td>

          </tr>
        </tbody>
      </table>

To register an API spec by copying and pasting its JSON or YAML-compliant schema into your browser:

1. From Setup in Lightning Experience, enter External Services in the Quick Find box, and select **External Services**.
2. Click **New External Service**.
3. On the **Select an API Source** page, select whether you’re importing an API spec **From Mulesoft Anypoint Platform**, or **From API Specification**. Since we're using our own spec in this example, select **From API Specification**.
4. Under **External Service Name**, enter a unique service name.
5. Under **Description**, enter an optional description. A good, short description can help distinguish one service from another in a long list of services.
6. Click under **Select a Named Credential** and select a named credential from the list.
7. Under **Service Schema**, select **Complete Schema**. Provide a schema that’s complete, valid for OpenAPI 2.0 or 3.0, and is JSON or YAML-compliant.
8. Paste your JSON or YAML-compliant schema into the provided text field.
9. Click **Save & Next**. Your uploaded schema is validated by External Services.
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/images/icon_note.png)
    
    Note If your schema includes non-supported media types, the system displays the **Associate operations with supported media types** page. Select a valid mapping for each non-supported type, as described in [Mapping Media Types During Registration](https://help.salesforce.com/s/articleView?id=platform.external_services_mime_type_mapping.htm&release=264.0.0&type=5).
10. If one or more errors are found during the validation process, a message (or series of messages) gives specific details about the error. You make corrections to the schema by editing it directly in the text editor and clicking **Validate** to revalidate your changes, or by modifying an offline copy and re-registering it. There are two types of errors:
    - Syntax or logical errors—_Must be fixed to complete the registration process_. To resolve an error, use the error message to discover the type and location of the error. Make corrections, and click **Validate**. Syntax error messages provide line and column number location.
    - Syntax or logical warnings—You don’t need to fix warnings to complete a registration. But the respective schema components are ignored by the External Services and aren’t registered. To fix warnings, use the guidance in the warning message, make corrections, and click **Validate**.
11. Select the operations you want to import into your external service registration. You can select up to 3,000 _operations_ per org, and up to 3,000 active _objects_ per org. If you exceed either of these limits, divide the operations in your schema across separate registrations. For information about limits, see [External Services Considerations](https://help.salesforce.com/s/articleView?id=platform.enhanced_external_services_considerations.htm&release=264.0.0&type=5 "Here are the semantic, service, and usage constraints to keep in mind when integrating your services into External Services."). For information about “objects” in Open API schemas, see [Basic Structure (OpenAPI 2.0)](https://swagger.io/docs/specification/2-0/basic-structure/) and [Basic Structure (OpenAPI 3.0)](https://swagger.io/docs/specification/basic-structure/)
12. Click **Next**.
13. Click **Done**.