Set Settings

Use this request to update settings for the specified path.

To update settings for the specified path, use a PUT method and the following URL:

{service_URI}/marketplace/v1/marketplaces/settings/{start_date}/{settings_path}

where:

  • {service_URI} is the service's URL.
  • {start_date} is the date when the setting was started. For example 1970-01-01.
  • {settings_path} the path to the specific setting. For example countries.FR is the path to the following setting:
{
  "countries": {
    "FR": {
      "is_domestic": true
    }
  }
}

For example:

$ curl \
    -H "x-marketplace-token: ms_{ACCESS_TOKEN}" \
    -H "Content-Type: application/json" \
    -X PUT \
    --data '{JSON}' \
    https://sellers-api.sandbox.marketplace.taxamo.com/marketplace/v1/marketplaces/settings/1970-01-01/countries.FR

where:

  • {ACCESS_TOKEN} is your access token used for authentication.
  • {JSON} is the body of the request where you specify the seller's details.

Details

API Component TypeAPI Component
Endpoint/marketplace/v1/marketplaces/settings/{start_date}/{settings_path}
MethodPUT
API Reference DocumentSet Settings

Input Parameters

ParameterDescription
start_dateSpecify the date when the setting was started. For example 1970-01-01.
settings_pathSpecify the path to the specific setting. For example countries.FR.

Request Fields

For a full list of the available fields, see Create seller . A full list of the fields is described in the Seller Settings Fields topic.

FieldDescription
marketplace_tokenSpecify the token used to authenticate the marketplace.
marketplace_codeSpecify the token used to identify the marketplace.

Response

The exact contents of the JSON response is dynamically generated and differs depending on the specified input parameters. Here is an example of one setting that you may see nested in the JSON response:

{
  "countries": {
    "FR": {
      "is_domestic": true
    }
  }
}