Create a product

POST 
https://euwest.api.elasticpath.com/v2/subscriptions/products

Create a product

Request

Query Parameters

filter string

application/json

Body

data ProductCreaterequired
typeSubscriptionProductType (string)required
Possible values: [subscription_product]
Example: subscription_product
attributes ProductAttributesrequired
external_refExternalRef (string)
A unique attribute that you could use to contain information from another company system, for example. The maximum length is 2048 characters.
Possible values: <= 2048 characters
Example: abc123
namestringrequired
The name of the product.
Possible values: >= 3 characters and <= 1024 characters
Example: Magazine
descriptionstring
The product or service description to display to customers.
Possible values: <= 1024 characters
Example: A lovely magazine that is published every month.
skustring
A stock keeping unit for the product, if appropriate.
Possible values: <= 1024 characters
Example: MAGAZINE1
main_imageuri
A URL from which an image or file for the product can be fetched. You can either upload your images and files to Commerce using the Commerce Files API or you can use your own content delivery network. If you are using the Commerce Files API, use Create a File to upload your file and return an HREF link in the response. An extensive range of media and file extensions are supported.
Possible values: <= 1024 characters
Example: https://magazine.com/cover.jpg
price Price
property name* object
The base price.
amountint64required
The value as a whole number of the currency's smallest subdivision.
Example: 100
includes_taxboolean
Indicates whether the amount includes any taxes.
Example: true
price_units object
The timeframe during which the product price is applicable. For example, for a streaming service, the price is $12.99 and the unit is months and the amount is 1. In other words, the streaming service is available for $12.99 a month. You may want to specify a unit price if you have many products that all have different prices. Rather than having to create separate plans for each product, you can specify the timeframe during which the product price is applicable and then create one plan that determines the billing frequency for those products.
unitstringrequired
A unit of time.
Possible values: [day, month]
Example: day
amountintegerrequired
The number of days or months the period covers.
Possible values: >= 1
Example: 7

Responses

201

Success. The product is created.

application/json

Schema

Schema

data Product
idUUID (string)
The unique identifier.
Example: 11111111-2222-3333-4444-555555555555
typeSubscriptionProductType (string)required
Possible values: [subscription_product]
Example: subscription_product
attributes ProductResponseAttributes
external_refExternalRef (string)
A unique attribute that you could use to contain information from another company system, for example. The maximum length is 2048 characters.
Possible values: <= 2048 characters
Example: abc123
namestringrequired
The name of the product.
Possible values: >= 3 characters and <= 1024 characters
Example: Magazine
descriptionstring
The product or service description to display to customers.
Possible values: <= 1024 characters
Example: A lovely magazine that is published every month.
skustring
A stock keeping unit for the product, if appropriate.
Possible values: <= 1024 characters
Example: MAGAZINE1
main_imageuri
A URL from which an image or file for the product can be fetched. You can either upload your images and files to Commerce using the Commerce Files API or you can use your own content delivery network. If you are using the Commerce Files API, use Create a File to upload your file and return an HREF link in the response. An extensive range of media and file extensions are supported.
Possible values: <= 1024 characters
Example: https://magazine.com/cover.jpg
price Price
property name* object
The base price.
amountint64required
The value as a whole number of the currency's smallest subdivision.
Example: 100
includes_taxboolean
Indicates whether the amount includes any taxes.
Example: true
price_units object
The timeframe during which the product price is applicable. For example, for a streaming service, the price is $12.99 and the unit is months and the amount is 1. In other words, the streaming service is available for $12.99 a month. You may want to specify a unit price if you have many products that all have different prices. Rather than having to create separate plans for each product, you can specify the timeframe during which the product price is applicable and then create one plan that determines the billing frequency for those products.
unitstringrequired
A unit of time.
Possible values: [day, month]
Example: day
amountintegerrequired
The number of days or months the period covers.
Possible values: >= 1
Example: 7
updated_atstringrequired
The date and time a resource was updated.
Example: 2017-01-10T11:41:19.244842Z
created_atstringrequired
The date and time a resource was created.
Example: 2017-01-10T11:41:19.244842Z
meta ProductMetarequired
display_price DisplayPrice
without_tax PriceFormatting
amountint64required
The unformatted amount for the objects.
Example: 100
currencystringrequired
The three-letter ISO currency code in uppercase, associated with a price.
Example: USD
formattedstringrequired
The formatted amount for the objects.
Example: $1.00
with_tax PriceFormatting
amountint64required
The unformatted amount for the objects.
Example: 100
currencystringrequired
The three-letter ISO currency code in uppercase, associated with a price.
Example: USD
formattedstringrequired
The formatted amount for the objects.
Example: $1.00
ownerstringrequired
The owner of a resource, either store or organization.
Example: store
timestamps Timestampsrequired
updated_atstringrequired
The date and time a resource was updated.
Example: 2017-01-10T11:41:19.244842Z
created_atstringrequired
The date and time a resource was created.
Example: 2017-01-10T11:41:19.244842Z

Example (auto)

{
  "data": {
    "id": "11111111-2222-3333-4444-555555555555",
    "type": "subscription_product",
    "attributes": {
      "external_ref": "abc123",
      "name": "Magazine",
      "description": "A lovely magazine that is published every month.",
      "sku": "MAGAZINE1",
      "main_image": "https://magazine.com/cover.jpg",
      "price": {
        "USD": {
          "amount": 100,
          "includes_tax": false
        },
        "GBP": {
          "amount": 90,
          "includes_tax": true
        }
      },
      "price_units": {
        "unit": "day",
        "amount": 7
      },
      "updated_at": "2017-01-10T11:41:19.244842Z",
      "created_at": "2017-01-10T11:41:19.244842Z"
    },
    "meta": {
      "display_price": {
        "without_tax": {
          "amount": 100,
          "currency": "USD",
          "formatted": "$1.00"
        },
        "with_tax": {
          "amount": 110,
          "currency": "USD",
          "formatted": "$1.10"
        }
      },
      "owner": "store",
      "timestamps": {
        "updated_at": "2017-01-10T11:41:19.244842Z",
        "created_at": "2017-01-10T11:41:19.244842Z"
      }
    }
  }
}

400

Bad request. The request failed validation.

application/json

Schema

Schema

errors Error[]required
Array [
statusstringrequired
The HTTP response code of the error.
Example: 500
titlestringrequired
A brief summary of the error.
Example: Internal server error
detailstring
Optional additional detail about the error.
Example: An internal error has occurred.
metaobject
Additional supporting meta data for the error.
Example: {"missing_ids":["e7d50bd5-1833-43c0-9848-f9d325b08be8"]}
]

Example (auto)

{
  "errors": [
    {
      "status": "500",
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

missing-name

{
  "errors": [
    {
      "title": "Validation Error",
      "status": "400",
      "detail": "data.attributes.name: \"name\" is required"
    }
  ]
}

500

Internal server error. There was a system failure in the platform.

application/json

Schema

Schema

errors Error[]required
Array [
statusstringrequired
The HTTP response code of the error.
Example: 500
titlestringrequired
A brief summary of the error.
Example: Internal server error
detailstring
Optional additional detail about the error.
Example: An internal error has occurred.
metaobject
Additional supporting meta data for the error.
Example: {"missing_ids":["e7d50bd5-1833-43c0-9848-f9d325b08be8"]}
]

Example (auto)

{
  "errors": [
    {
      "status": "500",
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

internal-server-error

{
  "errors": [
    {
      "title": "Internal Server Error",
      "status": "500"
    }
  ]
}

Authorization: http

name: BearerTokentype: httpscheme: bearer

• csharp
• curl
• dart
• go
• http
• java
• javascript
• kotlin
• c
• nodejs
• objective-c
• ocaml
• php
• powershell
• python
• r
• ruby
• rust
• shell
• swift

• HTTPCLIENT
• RESTSHARP

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://euwest.api.elasticpath.com/v2/subscriptions/products");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <token>");
var content = new StringContent("{\n  \"data\": {\n    \"type\": \"subscription_product\",\n    \"attributes\": {\n      \"external_ref\": \"abc123\",\n      \"name\": \"Magazine\",\n      \"description\": \"A lovely magazine that is published every month.\",\n      \"sku\": \"MAGAZINE1\",\n      \"main_image\": \"https://magazine.com/cover.jpg\",\n      \"price\": {\n        \"USD\": {\n          \"amount\": 100,\n          \"includes_tax\": false\n        },\n        \"GBP\": {\n          \"amount\": 90,\n          \"includes_tax\": true\n        }\n      },\n      \"price_units\": {\n        \"unit\": \"day\",\n        \"amount\": 7\n      }\n    }\n  }\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Request Collapse all

Base URL

https://euwest.api.elasticpath.com/v2

Auth

Bearer Token

Parameters

filter — query

Body

{
  "data": {
    "type": "subscription_product",
    "attributes": {
      "external_ref": "abc123",
      "name": "Magazine",
      "description": "A lovely magazine that is published every month.",
      "sku": "MAGAZINE1",
      "main_image": "https://magazine.com/cover.jpg",
      "price": {
        "USD": {
          "amount": 100,
          "includes_tax": false
        },
        "GBP": {
          "amount": 90,
          "includes_tax": true
        }
      },
      "price_units": {
        "unit": "day",
        "amount": 7
      }
    }
  }
}

ResponseClear

Click the Send API Request button above and see the response here!