---
sourceDocument: Yokohama Finance and Supply Chain
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/source-to-pay-operations

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Finance and Supply Chain

ft:clusterId :

    - stpop

bundleId :

    - stpop

workflow :

    - Employee


---

# Create a REST message for a custom API

# Create a REST message for a custom API {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Create a REST message request and send it to a custom API endpoint to fetch the
latest supplier news.

## Before you begin

* Install the News Integration for Supplier Lifecycle Operations plugin (com.snc.sn_supplier_news).
* Set the application scope to News Integration for Supplier Lifecycle Operations using the application picker.
{#create-custom-api-rest__ul_ydf_w1f_ytb}

Role required: admin

## Procedure

1. Navigate to AllSystem Web ServicesOutboundREST Message.
2. Select New.
3. On the form, fill in the fields.  
   {#create-custom-api-rest__table_ep4_42f_ytb__entry__2}

   | Field | Description |
   |-|-|
   | Name | Name for this message. |
   | Endpoint | Endpoint that this REST message is sent to. |
   | Authentication type | Authentication to use, if any, and the profile record that contains the user credentials. |
   [Table 1. REST Message form]

   {#create-custom-api-rest__table_ep4_42f_ytb}
4. Right-click the form header and select Save.  
   After creating the REST message, a GET HTTP method is created automatically using the values from the REST message record.
5. In the HTTP Methods related list, select Default GET.
6. In the Name field, specify a name for the GET HTTP method.
7. Select the HTTP Request tab.
8. In the HTTP Headers embedded list, select Insert a new row.
9. In the Name field, enter the name of the header.  
   Supported headers depend on the REST web service provider that you want to connect to.
10. Double-click the Value field for the new row and enter the value that you want to assign to this header.  
    You can use a variable in the format ${variable} instead of a static value. You can assign a value to the variable when sending a REST request.
11. In the HTTP Query Parameters embedded list, select Insert a new row.
12. In the Name field, enter the name of the query parameter.
13. Double-click the Value field for the new row and enter the value that you want to assign to this query parameter.  
    You can use a variable in the format ${variable} instead of a static value. You can assign a value to the variable when sending a REST request.
14. Select Update.

## What to do next

[Add and configure the Get News data resource in UI Builder](https://servicenow-prod.fluidtopics.net/WCpzjCrEfGh8xJOoq9UbqA "Add and configure the Get News - Composite data resource in UI Builder to dynamically retrieve supplier news in the News and Activity section of the Source-to-Pay Workspace.").
**Previous topic:** [Configuring a custom API to dynamically fetch supplier news](https://servicenow-prod.fluidtopics.net/14Ik9VcX3Y~hZ~LrjjOaQQ "By default, News Integration for Supplier Lifecycle Operations retrieves the supplier news and activities using the Microsoft Bing News Search API.")  
**Next topic:** [Add and configure the Get News data resource in UI Builder](https://servicenow-prod.fluidtopics.net/WCpzjCrEfGh8xJOoq9UbqA "Add and configure the Get News - Composite data resource in UI Builder to dynamically retrieve supplier news in the News and Activity section of the Source-to-Pay Workspace.")

*[\>]: and then