---
schema_version: "1"
id: 698c12ab6fd55bab6af4aa98323dd39d5f383847a86dd70a07533e29ee3ed4a3
title: Submit an API Spec With an Absolute URL
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/external_services_register_absolute.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.external_services_register_absolute.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 5dc0316d3b205f13af10e3ff9ed4eb61dfcd3853b9178118480920d69f939d6f
description: Provide a full, absolute URL to the spec.
products:
  - Salesforce Platform
  - Security
release: "264"
---
# Submit an API Spec With an Absolute URL

Provide a full, absolute URL to the spec.

### 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="d79838e72">User
              Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d79838e72 ">To manage connections: </td>

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

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

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/images/icon_important.png)

Important Before you can use an absolute URL, you must [add the URL to your Remote Sites settings](https://help.salesforce.com/s/articleView?id=xcloud.configuring_remoteproxy.htm&type=5&language=en_US).

To register an API spec using an absolute URL:

1. Make sure that the URL has been [added to your Remote Sites settings](https://help.salesforce.com/s/articleView?id=xcloud.configuring_remoteproxy.htm&type=5&language=en_US).
2. From Setup in Lightning Experience, enter External Services in the Quick Find box, and select **External Services**.
3. Click **New External Service**.
4. 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**.
5. Under **External Service Name**, enter a unique service name.
6. Under **Description**, enter an optional description. A good, short description can help distinguish one service from another in a long list of services.
7. Click under **Select a Named Credential** and select a named credential from the list.
8. Under **Service Schema**, select **Absolute URL** to upload and register your schema. The URL must point to a valid OpenAPI 2.0 or 3.0, and a JSON or YAML-compliant schema.
9. Enter an absolute URL path to the schema under **URL**. For example, `https://my_endpoint.example.com/accountSchema.json`. The absolute URL can point to a different domain than the one specified in Named Credentials.
10. Press Enter on your keyboard, or click outside of the URL box. The system begins to validate the schema.
11. 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**.
12. Click **Save & Next**.
    
    ![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).
13. 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/)
14. Click **Next**.
15. Click **Done**.