Bulk Create Addresses

import requests
url = "https://api-b2b.bigcommerce.com/api/v3/io/addresses/bulk"
payload = {
    "0": {
        "firstName": "Marie",
        "lastName": "Curie",
        "phoneNumber": "512-200-1234",
        "zipCode": "78704",
        "addressLine1": "512 Bluebonnet Lane",
        "addressline2": "Building 1",
        "city": "Austin",
        "stateName": "Texas",
        "countryName": "United States",
        "stateCode": "TX",
        "countryCode": "US",
        "companyId": 123456,
        "isBilling": False,
        "isShipping": True,
        "isDefaultBilling": False,
        "isDefaultShipping": False,
        "label": "Austin Warehouse",
        "externalId": "123456",
        "extraFields": {
            "fieldName": "Tax Provider Tax Code",
            "fieldValue": "G"
        }
    },
    "1": {
        "firstName": "Isaac",
        "lastName": "Newton",
        "phoneNumber": "512-100-1000",
        "zipCode": "78726",
        "addressLine1": "737 Lone Star Road",
        "addressline2": "Suite 200",
        "city": "Austin",
        "stateName": "Texas",
        "countryName": "United States",
        "stateCode": "TX",
        "countryCode": "US",
        "companyId": 123456,
        "isBilling": True,
        "isShipping": False,
        "isDefaultBilling": False,
        "isDefaultShipping": False,
        "label": "Austin HQ",
        "externalId": "123456",
        "extraFields": {
            "fieldName": "Tax Provider Tax Code",
            "fieldValue": "G"
        }
    }
}
headers = {
    "X-Auth-Token": "<apiKey>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "data": {
    "0": {
      "addressId": 123456,
      "firstName": "Marie",
      "lastName": "Curie",
      "phoneNumber": "512-200-1234",
      "zipCode": "78704",
      "addressLine1": "512 Bluebonnet Lane",
      "addressline2": "Building 1",
      "city": "Austin",
      "stateName": "Texas",
      "countryName": "United States",
      "stateCode": "TX",
      "countryCode": "US",
      "companyId": 123456,
      "isBilling": false,
      "isShipping": true,
      "isDefaultBilling": false,
      "isDefaultShipping": false,
      "label": "Austin Warehouse",
      "externalId": "123456",
      "extraFields": [
        {
          "fieldName": "Tax Provider Tax Code",
          "fieldValue": "G",
          "fieldType": 0
        }
      ]
    },
    "1": {
      "addressId": 123457,
      "firstName": "Isaac",
      "lastName": "Newton",
      "phoneNumber": "512-100-1000",
      "zipCode": "78726",
      "addressLine1": "737 Lone Star Road",
      "addressline2": "Suite 200",
      "city": "Austin",
      "stateName": "Texas",
      "countryName": "United States",
      "stateCode": "TX",
      "countryCode": "US",
      "companyId": 123456,
      "isBilling": true,
      "isShipping": false,
      "isDefaultBilling": false,
      "isDefaultShipping": false,
      "label": "Austin HQ",
      "externalId": "123456",
      "extraFields": [
        {
          "fieldName": "Tax Provider Tax Code",
          "fieldValue": "G",
          "fieldType": 0
        }
      ]
    }
  },
  "code": 200,
  "meta": {
    "message": "Success"
  }
}

Creates multiple addresses for up to 10 addresses at a time. You can create addresses for different Company accounts in a single request by entering a different companyid value for each address object.

See Create a Company Address for considerations related to creating one or more addresses.

Creates multiple addresses for **up to 10** addresses at a time. You can create addresses for different Company accounts in a single request by entering a different `companyid` value for each address object. See [Create a Company Address](#create-a-company-address) for considerations related to creating one or more addresses.

Authentication

X-Auth-Tokenstring

Authentication header

Header	Argument	Description
`X-Auth-Token`	`access_token`	For more about API accounts that generate `access_token`s, see our Guide to API Accounts.

Authentication header

Header	Argument	Description
`X-Store-Hash`	`store_hash`	The unique store hash associated with a BigCommerce store that has B2B Edition enabled.

### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Store-Hash` | `store_hash` | The unique store hash associated with a BigCommerce store that has B2B Edition enabled. |

Request

This endpoint expects an object.

firstNamestringOptional

The first name on the address.

lastNamestringOptional

The last name on the address.

phoneNumberstringOptional

The phone number on the address.

zipCodestringOptional

The postal code on the address.

addressLine1stringOptional

The first line of the address.

addressLine2stringOptional

The second line of the address.

citystringOptional

The city on the address.

stateNamestringOptional

The full name of the state or province on the address. This must correspond to stateCode in the request if the state or province is required for the country.

countryNamestringOptional

The full name of the country on the address. Use Get a Country to retrieve valid country names.

stateCodestringOptional

The two-letter ISO code for the state or province on the address. Omit this field when adding state or province information for an unsupported country.

countryCodestringOptional

The two-letter ISO code for the country on the address. Use Get a Country to retrieve valid country codes.

companyIdintegerOptional

The unique numeric ID of the Company account.

isBillingbooleanOptional

Indicates whether the address is a billing address.

isShippingbooleanOptional

Indicates whether the address is a shipping address.

isDefaultBillingbooleanOptional

Indicates whether the address is the default billing address.

isDefaultShippingbooleanOptional

Indicates whether the address is the default shipping address.

labelstringOptional

The label used on the storefront to identify the address.

externalIdstringOptional

An external ID assigned to the address in a third-party system, such as an ERP.

extraFieldslist of objectsOptional

Enter extra field information for the address.

Response

dataobject

codeintegerDefaults to 200

HTTP Response Code

metaobject

Errors

413

Content Too Large Error

422

Unprocessable Entity Error

Authentication

Authentication header

Further reading

Authentication header

Request

Response

Errors

Authentication header

Further reading

Authentication header