# Narvar

> Send orders and shipments to Narvar for tracking and customer updates, start returns with labels, and work with returns, exchanges, refunds and return locations in Narvar's Shopify returns app.

App · 16 actions. Web page: https://docs.lodol.com/docs/integrations/narvar

## Actions

### Add shipment

Add a shipment to an order, with its carrier and tracking number, or update one Narvar has, so Narvar tracks the package and tells the customer. Needs the platform's account ID and auth token.

**Inputs**

- Order number (`order_number`, text, required): The order's number, as your store sends it to Narvar.
- Tracking number (`tracking_number`, text, required): The carrier's tracking number for the package.
- Carrier (`carrier`, text, required): Narvar's name for the carrier, such as ups, fedex, usps or dhl. Your Narvar account manager has the full list.
- Items shipped (`items`, list, required): What is in the package. Each needs a 'sku' (or 'item_id') and a 'quantity'.
- Ship date (`ship_date`, date and time): When the package shipped.
- Ship method (`ship_method`, text): Such as Ground or Next Day.
- Carrier service (`carrier_service`, text): Such as UPS Ground.
- Recipient first name (`recipient_first_name`, text): Who it is shipped to.
- Recipient last name (`recipient_last_name`, text): Who it is shipped to.
- Recipient email (`recipient_email`, text): The recipient's email address.
- Recipient phone (`recipient_phone`, text): The recipient's phone number.
- Street (`street_1`, text): The delivery street address.
- Street line 2 (`street_2`, text): Apartment, suite or floor.
- City (`city`, text): The delivery city.
- State or province (`state`, text): State or province, such as CA.
- ZIP or postal code (`zip_code`, text): ZIP or postal code.
- Country (`country`, text): Two-letter country code, such as US.

**Outputs**

- `messages` (list): Narvar's messages about the request, if any
- `order_number` (text): The order
- `status` (text): Narvar's status for the request, such as SUCCESS
- `tracking_number` (text): The shipment's tracking number

**Example output**

```json
{
  "messages": [],
  "order_number": "ORD123",
  "status": "SUCCESS",
  "tracking_number": "1Z9W9F489014511424"
}
```

### Change return status

Set a return's status in Narvar's Shopify returns app, such as delivered or cancelled, and add a note to it.

**Inputs**

- Return (`rma_number`, text, required): The return's RMA number. Pick a recent one, or give it from an earlier step.
- New status (`status`, text): The return's new status. Leave empty to only add a note. One of: `initiated`, `on_its_way_to_retailer` (On its way to you), `delivered_to_retailer` (Delivered to you), `received_by_retailer` (Received by you), `rejected`, `cancelled_by_retailer` (Cancelled by you), `cancelled_by_user` (Cancelled by the customer), `exception`, `out_of_stock_exception` (Out of stock exception), `resolve_manually_without_automation` (Resolve manually).
- Note (`note`, text): Text to add to the return's notes.

**Outputs**

- `note` (text): The note added, if any
- `response` (object): Narvar's answer, if any
- `rma_number` (text): The return
- `status` (text): The status set, empty if only a note

**Example output**

```json
{
  "note": "Received at DC01",
  "response": {},
  "rma_number": "RX5A",
  "status": "delivered_to_retailer"
}
```

### Create or update order

Send an order to Narvar, or new details of one it has, so Narvar can track it and send the customer updates. Needs the platform's account ID and auth token.

**Inputs**

- Order number (`order_number`, text, required): The order's number, as your store sends it to Narvar.
- Items (`items`, list, required): Everything in the order. Each needs a 'sku' and a 'quantity'; 'name', 'item_id', 'unit_price', 'item_image', 'item_url' and 'fulfillment_status' are shown to the customer too.
- Order date (`order_date`, date and time): When the order was placed.
- Customer first name (`customer_first_name`, text): The customer's first name.
- Customer last name (`customer_last_name`, text): The customer's last name.
- Customer email (`customer_email`, text): Where Narvar sends the customer's order and delivery updates.
- Customer phone (`customer_phone`, text): For text updates, with the country code.
- Customer ID (`customer_id`, text): Your own id for the customer.
- Street (`street_1`, text): The customer's billing street address.
- Street line 2 (`street_2`, text): Apartment, suite or floor.
- City (`city`, text): The customer's billing city.
- State or province (`state`, text): State or province, such as CA.
- ZIP or postal code (`zip_code`, text): ZIP or postal code.
- Country (`country`, text): Two-letter country code, such as US.
- Currency (`currency_code`, text): Three-letter currency code, such as USD.
- Order total (`order_total`, number): The amount billed for the order. At least 0.
- Tax (`tax_amount`, number): The tax on the order. At least 0.
- Shipping and handling (`shipping_amount`, number): What the customer paid for shipping and handling. At least 0.
- Promised delivery date (`order_promise_date`, date and time): When you promised the customer the order would arrive.
- Custom attributes (`attributes`, object): Your own keys and values to keep on the order.

**Outputs**

- `messages` (list): Narvar's messages about the request, if any
- `order_number` (text): The order sent
- `status` (text): Narvar's status for the request, such as SUCCESS

**Example output**

```json
{
  "messages": [],
  "order_number": "ORD123",
  "status": "SUCCESS"
}
```

### Create return location

Add a store or warehouse that takes returns. Your Narvar account needs return location management turned on.

**Inputs**

- Name (`name`, text, required): The location's name.
- Address (`address1`, text, required): Street address.
- Address line 2 (`address2`, text): Suite or floor.
- City (`city`, text, required): City.
- State or province (`state`, text, required): Such as California.
- State code (`state_code`, text, required): Such as CA.
- ZIP or postal code (`zip_code`, text, required): ZIP or postal code.
- Country (`country`, text, required): Such as United States.
- Country code (`country_code`, text, required): Two letters, such as US.
- Phone (`phone`, text, required): Such as 1-415-555-5555.
- Latitude (`latitude`, number, required): The location's latitude, such as 37.79. From -90 to 90.
- Longitude (`longitude`, number, required): The location's longitude, such as -122.39. From -180 to 180.
- Takes in-store returns (`accept_in_store_returns`, true/false): Whether customers can return items here in person.
- Takes mailed returns (`accept_mail_in_returns`, true/false): Whether returns can be mailed here. On unless turned off.

**Outputs**

- `location` (object): The return location

**Example output**

```json
{
  "location": {
    "accept_in_store_returns": true,
    "accept_mail_in_returns": true,
    "id": "YXWN",
    "location": {
      "address1": "1214 Main Road",
      "address2": "Suite 4",
      "city": "San Francisco",
      "country": "United States",
      "country_code": "US",
      "latitude": 37.79,
      "longitude": -122.39,
      "phone": "1-415-555-5555",
      "state": "California",
      "state_code": "CA",
      "zip": "94105"
    },
    "name": "San Francisco store"
  }
}
```

### Create return with label

Start a return on an order Narvar has and get its shipping label, tracking link or QR code. Needs the platform's account ID and auth token.

**Inputs**

- Order number (`order_number`, text, required): The order's number, as your store sends it to Narvar.
- Items to return (`items`, list, required): Each needs a 'sku', a 'quantity' and a 'return_reason_code' (a reason code set up in Narvar Hub); 'item_id' and 'customer_comment' are optional.
- Customer email (`customer_email`, text): Checked against the order before the return is made.
- Postal code (`postal_code`, text): Checked against the order's billing postal code (its shipping one for a gift).
- RMA number (`rma_number`, text): Your own RMA number. Leave empty to have Narvar make one.
- Carrier (`carrier`, text): Which carrier makes the label. Leave empty for your Narvar rules. One of: `ups`, `fedex`, `usps`, `dhl`.
- Return type (`return_type`, text): What kind of return this is. Defaults to a return by mail. One of: `return` (Return (default)), `lost` (Lost package), `refused` (Refused by the customer), `delivery-exception` (Delivery exception).
- Locale (`locale`, text): Such as en_US. Defaults to en_US.
- Gift return (`gift_return`, true/false): Turn on when the person returning it received it as a gift.

**Outputs**

- `messages` (list): Narvar's messages about the request, if any
- `order_number` (text): The order the return is for
- `return_methods` (list): Ways to send the return, with labels
- `return_reference_number` (text): Narvar's reference for the return, to get its label later
- `rma_number` (text): The return's RMA number
- `status` (text): Narvar's status for the request, such as SUCCESS

**Example output**

```json
{
  "messages": [],
  "order_number": "ORD123",
  "return_methods": [
    {
      "carrier": {
        "name": "UPS"
      },
      "label_url": "https://returns-narvar.com/returns/retailer/viewlabel?return_id=gbZ1AoqzlP1QABRmO",
      "qr_code_url": "",
      "tracking_number": "1Z9W9F489014511425",
      "tracking_url": "https://retailer.narvar.com/retailer/tracking/ups?tracking_numbers=1Z9W9F489014511425",
      "type": "MAIL"
    }
  ],
  "return_reference_number": "gbZ1AoqzlP1QABRmO",
  "rma_number": "RA1001",
  "status": "SUCCESS"
}
```

### Create Shopify return

Start a return or exchange on a Shopify order in Narvar's returns app, and get its RMA number, label and QR code.

**Inputs**

- Order number (`order_number`, text, required): The order's number, as your store sends it to Narvar.
- Customer email (`email`, text, required): The email address on the order.
- Items to return (`return_items`, list, required): Each needs a 'lineItemId' (the Shopify line item) and a 'quantity'; give a 'returnReason' or 'returnReasonId' from your return reasons.
- How it comes back (`shipping_method`, text, required): How the customer sends the item back. One of: `usps_returns` (USPS), `fedex`, `ups`, `keep_the_item` (Keep the item), `return_in_store` (Return in store), `ship_on_your_own` (Ship on their own).
- Items to exchange (`exchange_items`, list): For an exchange: each with 'returnItem' (as in Items to return) and the replacement's 'newProductVariantId'.
- Refund to (`refund_method`, text): How the customer is refunded, if your refund rules allow it. One of: `original_payment` (Original payment method), `gift_card` (Gift card).
- Locale (`locale`, text): Such as en. Defaults to en.
- Shipping price (`shipping_price`, number): What the customer pays to send it back. At least 0.
- Send from address (`from_address`, object): Only when the order's address won't do: name, address1, address2, city, provinceCode, postalCode, countryCode and phone.

**Outputs**

- `qr_code` (text): Address of the QR code image
- `rma_number` (text): The new return's RMA number
- `shipping_label` (text): Address of the label image

**Example output**

```json
{
  "qr_code": "https://storage.googleapis.com/shopify-zero-narvar/example/qr_code.png",
  "rma_number": "RX5A",
  "shipping_label": "https://storage.googleapis.com/shopify-zero-narvar/example/return_label.pdf"
}
```

### Delete return location

Delete a return location. Delete the return rules that use it first.

**Inputs**

- Return location (`location_id`, text, required): The return location. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): True once deleted
- `location_id` (text): The location deleted

**Example output**

```json
{
  "deleted": true,
  "location_id": "YXWN"
}
```

### Get order

Get an order Narvar has, with its items, shipments and tracking numbers, customer and billing. Needs the platform's account ID and auth token.

**Inputs**

- Order number (`order_number`, text, required): The order's number, as your store sends it to Narvar.

**Outputs**

- `messages` (list): Narvar's messages about the request, if any
- `order` (object): The order
- `status` (text): Narvar's status for the request, such as SUCCESS

**Example output**

```json
{
  "messages": [],
  "order": {
    "attributes": {},
    "billing": {
      "amount": 34.07,
      "billed_to": {
        "address": {
          "city": "San Francisco",
          "country": "US",
          "state": "CA",
          "street_1": "50 Beale St",
          "street_2": "Floor 4",
          "zip": "94105"
        },
        "email": "john@example.com",
        "first_name": "John",
        "last_name": "Doe",
        "location_id": "",
        "phone": "4155550100"
      },
      "shipping_handling": 6.42,
      "tax_amount": 2.66,
      "tax_rate": 8.5
    },
    "currency_code": "USD",
    "customer": {
      "address": {
        "city": "San Francisco",
        "country": "US",
        "state": "CA",
        "street_1": "50 Beale St",
        "street_2": "Floor 4",
        "zip": "94105"
      },
      "customer_id": "3bc3642c-86ee-3b9a-880a-203a22738465",
      "email": "john@example.com",
      "first_name": "John",
      "last_name": "Doe",
      "phone": "4155550100"
    },
    "order_date": "2026-11-14T07:06:49Z",
    "order_items": [
      {
        "categories": [
          "Tops"
        ],
        "description": "Narwhal Tee, blue, medium",
        "fulfillment_status": "SHIPPED",
        "fulfillment_type": "HD",
        "is_backordered": false,
        "is_final_sale": false,
        "is_gift": false,
        "item_id": "itemid23541406",
        "item_image": "https://cdn.example.com/narwhal-tee.png",
        "item_promise_date": "2026-11-20T07:06:48Z",
        "item_url": "https://shop.example.com/products/narwhal-tee",
        "line_number": 1,
        "line_price": 24.99,
        "name": "Narwhal Tee",
        "quantity": 1,
        "sku": "23541406",
        "unit_price": 24.99
      }
    ],
    "order_number": "ORD123",
    "order_promise_date": "2026-11-20T07:06:48Z",
    "pickups": [],
    "selected_ship_method": "Ground",
    "shipments": [
      {
        "carrier": "ups",
        "carrier_service": "UPS Ground",
        "items_info": [
          {
            "item_id": "itemid23541406",
            "quantity": 1,
            "sku": "23541406"
          }
        ],
        "ship_date": "2026-11-16T07:06:48Z",
        "ship_method": "Ground",
        "ship_source": "DC01",
        "ship_total": 6.42,
        "shipped_from": {
          "address": {
            "city": "San Francisco",
            "country": "US",
            "state": "CA",
            "street_1": "50 Beale St",
            "street_2": "Floor 4",
            "zip": "94105"
          },
          "email": "john@example.com",
          "first_name": "Warehouse",
          "last_name": "DC01",
          "location_id": "DC01",
          "phone": "4155550100"
        },
        "shipped_to": {
          "address": {
            "city": "San Francisco",
            "country": "US",
            "state": "CA",
            "street_1": "50 Beale St",
            "street_2": "Floor 4",
            "zip": "94105"
          },
          "email": "john@example.com",
          "first_name": "John",
          "last_name": "Doe",
          "location_id": "",
          "phone": "4155550100"
        },
        "tracking_number": "1Z9W9F489014511424"
      }
    ]
  },
  "status": "SUCCESS"
}
```

### Get return

Get one return or exchange from Narvar's Shopify returns app, with its status, items, packages, refund and fees.

**Inputs**

- Return (`rma_number`, text, required): The return's RMA number. Pick a recent one, or give it from an earlier step.

**Outputs**

- `return` (object): The return

**Example output**

```json
{
  "return": {
    "currency": "GBP",
    "email": "customer@example.com",
    "errors": [],
    "estimated_refund": "900.00",
    "fee_breakdown": [
      {
        "currency": "GBP",
        "description": "Return Fee",
        "fee": 0.0,
        "formatted_fee": "FREE"
      }
    ],
    "gift": false,
    "items": [
      {
        "child_reason": "Too small",
        "child_reason_code": "R5YGD",
        "comment": "Runs small, ordered size 8",
        "exchange_item": {},
        "item_id": 17632336576829,
        "keep_the_item": false,
        "quantity": 1,
        "reason": "Incorrect Sizing",
        "reason_code": "DMKKB",
        "sku": "8MUO2",
        "total_item_price": "900.00",
        "transaction_type": "return",
        "unit_price": "900.00"
      }
    ],
    "label_url": "https://storage.googleapis.com/shopify-zero-narvar/example/return_label.pdf",
    "locale": "en",
    "order_number": "#3420",
    "origin_city": "London",
    "origin_country": "GB",
    "origin_zip": "NW1 6XE",
    "package": {
      "carrier": "ship_on_your_own",
      "carrier_service_method": "",
      "destination_city": "San Francisco",
      "destination_country": "US",
      "destination_zip": "94105",
      "tracking_number": ""
    },
    "packages": [
      {
        "carrier_service_name": "",
        "destination_city": "San Francisco",
        "destination_country_code": "US",
        "destination_postal_code": "94105",
        "items": [
          {
            "item_id": 17632336576829,
            "quantity": 1
          }
        ],
        "letter": "A",
        "return_method": "self",
        "return_tracking_company": "",
        "return_tracking_number": "",
        "tracking_link": ""
      }
    ],
    "refund_method": "original_payment",
    "restocking_fee": "0.00",
    "retailer_name": "Dev Narvar",
    "return_creation_date": "2026-08-17T20:53:43.000Z",
    "return_method": "self",
    "return_status": "initiated",
    "rma_number": "RX5A",
    "shop_currency": "USD",
    "shopify_order_id": 7327841321277,
    "transaction_types": [
      "return"
    ],
    "transactions": []
  }
}
```

### Get return label

Get a platform return's label, tracking link and QR code again, by the reference number 'Create return with label' gave. Needs the platform's account ID and auth token.

**Inputs**

- Return reference number (`return_reference_number`, text, required): The reference number 'Create return with label' gave.

**Outputs**

- `messages` (list): Narvar's messages about the request, if any
- `order_number` (text): The order the return is for
- `return_methods` (list): Ways to send the return, with labels
- `return_reference_number` (text): Narvar's reference for the return, to get its label later
- `rma_number` (text): The return's RMA number
- `status` (text): Narvar's status for the request, such as SUCCESS

**Example output**

```json
{
  "messages": [],
  "order_number": "ORD123",
  "return_methods": [
    {
      "carrier": {
        "name": "UPS"
      },
      "label_url": "https://returns-narvar.com/returns/retailer/viewlabel?return_id=gbZ1AoqzlP1QABRmO",
      "qr_code_url": "",
      "tracking_number": "1Z9W9F489014511425",
      "tracking_url": "https://retailer.narvar.com/retailer/tracking/ups?tracking_numbers=1Z9W9F489014511425",
      "type": "MAIL"
    }
  ],
  "return_reference_number": "gbZ1AoqzlP1QABRmO",
  "rma_number": "RA1001",
  "status": "SUCCESS"
}
```

### Get return location

Get one return location with its address and what it takes.

**Inputs**

- Return location (`location_id`, text, required): The return location. Pick one, or give its id from an earlier step.

**Outputs**

- `location` (object): The return location

**Example output**

```json
{
  "location": {
    "accept_in_store_returns": true,
    "accept_mail_in_returns": true,
    "id": "YXWN",
    "location": {
      "address1": "1214 Main Road",
      "address2": "Suite 4",
      "city": "San Francisco",
      "country": "United States",
      "country_code": "US",
      "latitude": 37.79,
      "longitude": -122.39,
      "phone": "1-415-555-5555",
      "state": "California",
      "state_code": "CA",
      "zip": "94105"
    },
    "name": "San Francisco store"
  }
}
```

### Get return timeline

Get the history of a return in Narvar's Shopify returns app: each status change and who made it.

**Inputs**

- Return (`rma_number`, text, required): The return's RMA number. Pick a recent one, or give it from an earlier step.

**Outputs**

- `count` (number): How many entries
- `rma_number` (text): The return
- `timeline` (list): What happened, in order

**Example output**

```json
{
  "count": 1,
  "rma_number": "RX5A",
  "timeline": [
    {
      "by_user": "system",
      "description": "Return initiated",
      "status": "initiated",
      "timeline_item_type": "state_transition",
      "timestamp": "2026-08-17T20:53:43Z",
      "user": {
        "email": "",
        "first_name": "",
        "last_name": ""
      }
    }
  ]
}
```

### List return locations

List the stores and warehouses that take returns in Narvar's Shopify returns app.

**Inputs**: None.

**Outputs**

- `count` (number): How many
- `locations` (list): The return locations

**Example output**

```json
{
  "count": 1,
  "locations": [
    {
      "accept_in_store_returns": true,
      "accept_mail_in_returns": true,
      "id": "YXWN",
      "location": {
        "address1": "1214 Main Road",
        "address2": "Suite 4",
        "city": "San Francisco",
        "country": "United States",
        "country_code": "US",
        "latitude": 37.79,
        "longitude": -122.39,
        "phone": "1-415-555-5555",
        "state": "California",
        "state_code": "CA",
        "zip": "94105"
      },
      "name": "San Francisco store"
    }
  ]
}
```

### List returns

List returns and exchanges from Narvar's Shopify returns app, newest first unless dates are given, filtered by order or customer. Gets one page; to see more, run it again with the next page number.

**Inputs**

- Dates are (`date_field`, text): Whether the dates mean when returns were made or last changed. One of: `created` (When the return was made (default)), `updated` (When the return last changed). Default: `created`.
- From (`since`, date and time): Only returns on or after this time, oldest first.
- Until (`until`, date and time): Only returns on or before this time. With no dates, the newest come first.
- Order number (`order_number`, text): Only returns for this order.
- Customer email (`email`, text): Only returns for this customer's orders.
- Page size (`per_page`, number): How many to return, 1 to 100. Defaults to 100. From 1 to 100.
- Page (`page`, number): Which page of results, starting at 1. At least 1.

**Outputs**

- `count` (number): How many on this page
- `next_timestamp` (text): Where the next page starts, as a From time; empty on the last
- `returns` (list): The returns

**Example output**

```json
{
  "count": 1,
  "next_timestamp": "",
  "returns": [
    {
      "currency": "GBP",
      "email": "customer@example.com",
      "errors": [],
      "estimated_refund": "900.00",
      "fee_breakdown": [
        {
          "currency": "GBP",
          "description": "Return Fee",
          "fee": 0.0,
          "formatted_fee": "FREE"
        }
      ],
      "gift": false,
      "items": [
        {
          "child_reason": "Too small",
          "child_reason_code": "R5YGD",
          "comment": "Runs small, ordered size 8",
          "exchange_item": {},
          "item_id": 17632336576829,
          "keep_the_item": false,
          "quantity": 1,
          "reason": "Incorrect Sizing",
          "reason_code": "DMKKB",
          "sku": "8MUO2",
          "total_item_price": "900.00",
          "transaction_type": "return",
          "unit_price": "900.00"
        }
      ],
      "label_url": "https://storage.googleapis.com/shopify-zero-narvar/example/return_label.pdf",
      "locale": "en",
      "order_number": "#3420",
      "origin_city": "London",
      "origin_country": "GB",
      "origin_zip": "NW1 6XE",
      "package": {
        "carrier": "ship_on_your_own",
        "carrier_service_method": "",
        "destination_city": "San Francisco",
        "destination_country": "US",
        "destination_zip": "94105",
        "tracking_number": ""
      },
      "packages": [
        {
          "carrier_service_name": "",
          "destination_city": "San Francisco",
          "destination_country_code": "US",
          "destination_postal_code": "94105",
          "items": [
            {
              "item_id": 17632336576829,
              "quantity": 1
            }
          ],
          "letter": "A",
          "return_method": "self",
          "return_tracking_company": "",
          "return_tracking_number": "",
          "tracking_link": ""
        }
      ],
      "refund_method": "original_payment",
      "restocking_fee": "0.00",
      "retailer_name": "Dev Narvar",
      "return_creation_date": "2026-08-17T20:53:43.000Z",
      "return_method": "self",
      "return_status": "initiated",
      "rma_number": "RX5A",
      "shop_currency": "USD",
      "shopify_order_id": 7327841321277,
      "transaction_types": [
        "return"
      ],
      "transactions": []
    }
  ]
}
```

### Record received items

Tell Narvar's Shopify returns app what your warehouse received for a return: approve, reject or flag each item, and refund the customer in full or in part.

**Inputs**

- Return (`rma_number`, text, required): The return's RMA number. Pick a recent one, or give it from an earlier step.
- Items received (`items`, list, required): Each needs an 'item_id' (or 'item_sku'), a 'quantity' and a 'status': approved, approved_no_restock, rejected, not_received, exception or invalid_item.
- Issue the refund (`process_refund`, true/false): Refund the customer in Shopify. On unless turned off.
- Approve when all items are approved (`auto_approve`, true/false): Approve the return as soon as every item is approved.
- Drop items not received (`remove_not_received_items`, true/false): Take items marked not_received off the return and approve the rest, instead of sending it to exception.
- Refund amount (`refund_amount`, number): A partial refund in place of the full one, no more than Narvar worked out. Leave empty for the full refund. At least 0.
- Refund currency (`refund_currency`, text): Three-letter currency code, such as USD.
- Move return to (`status_override`, text): A new status for the return. Can't be used with a refund amount. One of: `on_its_way_to_retailer` (On its way to you), `delivered_to_retailer` (Delivered to you), `received_by_retailer` (Received by you), `approved`, `rejected`, `exception`, `resolve_manually_without_automation` (Resolve manually), `cancelled_by_retailer` (Cancelled by you), `cancelled_by_user` (Cancelled by the customer), `needs_manual_approval` (Needs manual approval).
- Reference ID (`reference_id`, text): Narvar ignores a second update with the same reference. Leave empty to make one.

**Outputs**

- `reference_id` (text): The update's reference id
- `response` (object): Narvar's answer, if any
- `rma_number` (text): The return
- `updated` (true/false): True once Narvar took the update

**Example output**

```json
{
  "reference_id": "6f1c2b9e-1d3a-4c55-9a8e-2f6b1d0c7e41",
  "response": {},
  "rma_number": "RX5A",
  "updated": true
}
```

### Update return location

Change a return location's name, address or what it takes. Give every field, as Narvar replaces the location.

**Inputs**

- Return location (`location_id`, text, required): The return location. Pick one, or give its id from an earlier step.
- Name (`name`, text, required): The location's name.
- Address (`address1`, text, required): Street address.
- Address line 2 (`address2`, text): Suite or floor.
- City (`city`, text, required): City.
- State or province (`state`, text, required): Such as California.
- State code (`state_code`, text, required): Such as CA.
- ZIP or postal code (`zip_code`, text, required): ZIP or postal code.
- Country (`country`, text, required): Such as United States.
- Country code (`country_code`, text, required): Two letters, such as US.
- Phone (`phone`, text, required): Such as 1-415-555-5555.
- Latitude (`latitude`, number, required): The location's latitude, such as 37.79. From -90 to 90.
- Longitude (`longitude`, number, required): The location's longitude, such as -122.39. From -180 to 180.
- Takes in-store returns (`accept_in_store_returns`, true/false): Whether customers can return items here in person.
- Takes mailed returns (`accept_mail_in_returns`, true/false): Whether returns can be mailed here. On unless turned off.

**Outputs**

- `location` (object): The return location

**Example output**

```json
{
  "location": {
    "accept_in_store_returns": true,
    "accept_mail_in_returns": true,
    "id": "YXWN",
    "location": {
      "address1": "1214 Main Road",
      "address2": "Suite 4",
      "city": "San Francisco",
      "country": "United States",
      "country_code": "US",
      "latitude": 37.79,
      "longitude": -122.39,
      "phone": "1-415-555-5555",
      "state": "California",
      "state_code": "CA",
      "zip": "94105"
    },
    "name": "San Francisco store"
  }
}
```
