Create a Customer Shipping Address {#tms-ship-addr-tkn-create-intro}
====================================================================

This section describes how to create a customer shipping address.

Endpoint {#tms-ship-addr-tkn-create-intro_section_hqw_rjt_gwb}
--------------------------------------------------------------

**Test:** `POST ``https://apitest.visaacceptance.com``/tms/v2/customers/`*{customerTokenId}*`/shipping-addresses`{#tms-ship-addr-tkn-create-intro_restcust-test}  
**Production:** `POST ``https://api.visaacceptance.com``/tms/v2/customers/`*{customerTokenId}*`/shipping-addresses`  
The *`{customerTokenId}`* is the customer token ID returned in the id field when you created the customer token. For more information, see [Create a Customer](/docs/vas/en-us/tms/developer/all/rest/tms/tms-cust-tkn/tms-manage-cust-tkn/tms-cust-tkn-create-intro.md "").  
If the default field is not supplied and the customer does not already have a shipping address, then the shipping address will become the default. Otherwise, it will become a customer's non-default shipping address.

Required Fields for Creating a Customer Shipping Address {#tms-ship-addr-tkn-create-reqfields}
==============================================================================================

You can include any of the following fields in the body of the request:

shipTo.address1
:

shipTo.address2
:

shipTo.administrativeArea
:

shipTo.company
:

shipTo.country
:

shipTo.email
:

shipTo.firstName
:

shipTo.lastName
:

shipTo.locality
:

shipTo.phoneNumber
:

shipTo.postalCode
:
{#tms-ship-addr-tkn-create-reqfields_dl_e1p_mry_dwb}

REST Example: Creating a Customer Shipping Address {#tms-ship-addr-tkn-create-ex-rest}
======================================================================================

Request

```keyword
POST https://apitest.visaacceptance.com/tms/v2/customers/F2F3ADA770102B51E053A2598D0A9078/shipping-addresses
```

{#tms-ship-addr-tkn-create-ex-rest_codeblock_c51_vmt_gwb}  
Response to a Successful Request

```
{
  "_links": {
    "self": {
      "href": "/tms/v2/customers/F2F3ADA770102B51E053A2598D0A9078/shipping-addresses/F2F4C2D1B966D631E053A2598D0AB155"
    },
    "customer": {
      "href": "/tms/v2/customers/F2F3ADA770102B51E053A2598D0A9078"
    }
  },
  "id": "F2F4C2D1B966D631E053A2598D0AB155",
  "default": true,
  "shipTo": {
    "firstName": "John",
    "lastName": "Doe",
    "company": "Company Name",
    "address1": "1 Market St",
    "locality": "San Francisco",
    "administrativeArea": "CA",
    "postalCode": "94105",
    "country": "US",
    "email": "test@vas.com",
    "phoneNumber": "4158880000"
  },
  "metadata": {
    "creator": "testrest"
  }
}
```

{#tms-ship-addr-tkn-create-ex-rest_codeblock_e51_vmt_gwb}
