---
sourceDocument: Brazil Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/integrate-applications

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Add REST service manually

# Add a REST service manually in Zero Copy Connector for ERP {#ariaid-title1}

Release version: Brazil  
Updated April 25, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read  
When adding an entity to a model using REST, if the service you need isn't listed, add the service manually in Zero Copy Connector for ERP (Enterprise Resource Planning).

## Before you begin

Role required: sn_erp_integration.erp_admin  
Complete the following before adding a service manually:

* Enable the sn_erp_integration.enableModelModification property. For more information, see [Install Zero Copy Connector for ERP](https://www.servicenow.com/docs/ZtU6VS8BCadoq_MqD1tfQQ "Install Zero Copy Connector for ERP from the ServiceNow Store, so that you can connect to SAP and other ERP systems and start building models on the ServiceNow AI Platform.").
* Create a connection and credential alias, specifying REST as the Connection type. For more information, see [Create a Connection \& Credential alias](https://www.servicenow.com/docs/access?context=connection-alias&version=brazil&pubname=brazil-platform-security&ft:locale=en-US).
* Create a REST connection for the service. Add the connection alias that you created and the connection URL.

* Create a system that uses the REST connection. For more information, see [Create an ERP system in Zero Copy Connector for ERP](https://www.servicenow.com/docs/1pQChQJAkKqV6WvnIRkBZQ "Configure an ERP system in Zero Copy Connector for ERP to register your ERP connection so that models and tables can use it as a data source."). On the system record, confirm that the heartbeats are successful and the retrieval status is complete. If any have failed, select Restart data retrieval.
{#erp-add-a-rest-service-manually__ul_q42_gtz_1jc}

## Procedure

1. Navigate to AllZero Copy Connector for ERPZero Copy Connector for ERP Home.
2. Open the model page by selecting the models icon. ![]() in the side panel.
3. Select the model to which you want to add an operation entity.
4. In the ERP system field, verify that the correct system is selected.
5. Select the Manage model button.
6. Select an operation.  
   If you don't have an operation, see [Add an operation to a model in Zero Copy Connector for ERP](https://www.servicenow.com/docs/aImlQVW8gdvPX~CTNzODkg "Add an operation to an ERP model in Zero Copy Connector for ERP to define how the model retrieves data, writes data, or creates a new instance of the business object.").
7. Select Select entity on the Manage entities tab.
8. In Select type, select REST.
9. Select + Add service manually.  
10. If using a metadata URL, follow these substeps (if uploading a metadata file, go to the next step).
    1. Select Use Swagger/OpenAPI URL.
    2. In the Swagger/OpenAPI Version field, select a version such as 2.0 or 3.0.
    3. Paste in a Swagger/OpenAPI URL and select outside of the field.
    4. In the Service name field, verify that a name is created automatically.  
       You can edit the service name as needed.

    {#erp-add-a-rest-service-manually__substeps_jck_dlx_xgc} {#erp-add-a-rest-service-manually__cmd_u1h_sh2_cjc}
11. If uploading a metadata file, follow these substeps.
    1. Select Upload Swagger/OpenAPI file.
    2. In Swagger/OpenAPI Version, select a version such as 2.0 or 3.0.
    3. Select Attach File.
    4. Select a JSON or YAML file and then select Open.
    5. Enter a Service name.  
       You can download, edit, or delete the file by selecting an icon.

    {#erp-add-a-rest-service-manually__substeps_eph_wlx_xgc}
12. When finished, select Add service.  
    A background job named Additional Service Handler runs.  
    Note:  
    If an issue occurs, an error message appears. Select Flow context for more information. You can also view execution details in Workflow Studio.

    The service is added to the entity record, along with the endpoint and return type. The endpoints available in an operation depend on the HTTP method associated with the operation type:
    * Read operations display GET endpoints.
    * Create operations display POST endpoints.
    * Update operations display PATCH, PUT, and other update endpoints.

    {#erp-add-a-rest-service-manually__ul_y4d_bb1_bjc}

13. When finished, select Add entity.
{#erp-add-a-rest-service-manually__steps_lpj_kh2_cjc}

*[\>]: and then