Add a secondary metafield(To be deprecated)

POST https://{handle}.myshopline.com/admin/openapi/v20260301/:p_resource/:p_owner_id/:resource/:owner_id/metafields.json

handle : The store's unique identifier, which is the prefix of the store's domain name. For example, if a store's domain name is open001.myshopline.com , the store handle is open001 .

Create a metafield.

DEPRECATED

This API is deprecated from API version v20250601. Use the Create a metafield for a resource API instead.

Path Parameters

owner_id string required

Secondary resource id

Example: 1802351351232521351351
p_owner_id string required

First class resource id

Example: 16024213413413412341234
p_resource string required

First class resources , like products

Example: products
resource string required

Secondary resources such as variants

Example: variants

Request Headers

Content-Type string required

The field must be set to the fixed value application/json; charset=utf-8.
Authorization string required

The access token for the API resource. Refer to App authorization to obtain the access token, and then pass the obtained token in the Bearer format.
Example:

Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw

Request Body

metafieldobject

metafield
description string

Description
Example: My description
key string

A unique identifier for a metafield within its namespace.
Example: key_123
namespace string

Namespace , 2-50 characters
Example: namespace_123
type string

The type of value, such as single_line_text_field, multi_line_text_field, boolean, url, variant_reference, product_reference, page_reference, rating, number_decimal, number_integer, dimension, volume, weight, json, file_reference, date_time, date, color
Example: single_line_text_field
value object

The data stored in the metafield.

Status Codes

For the complete list of codes and messages, see Http status code.

Response Headers

traceId

A globally unique identifier for the request. It is used to track the request flow throughout the system, allowing for easy location and debugging when issues arise.

Response Body

metafieldobject

metafield
created_at string

Creation time
Example: 2022-12-28T09:39:35+00:00
description string

Description
Example: My description
id long

Metafield's id
Example: 124213413421342130
key string

A unique identifier for a metafield within its namespace.
Example: key_123
namespace string

Namespace
Example: namespace_123
owner_id string

Resource id
Example: 18024213413413412341234
owner_resource string

Resources
Example: variants
type string

Type
Example: single_line_text_field
updated_at string

Update time
Example: 2022-12-28T09:39:35+00:00
value object

The data stored in the metafield.

API Explorer

Debugger

Examples

Base URL

https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301

ParamOptions

owner_id — path required

p_owner_id — path required

p_resource — path required

resource — path required

Authorization — header required

Body

Body required

{
  "metafield": {
    "description": "My description",
    "key": "key_123",
    "namespace": "namespace_123",
    "type": "single_line_text_field",
    "value": null
  }
}

Language

curl --request POST \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301/p_resource/p_owner_id/resource/owner_id/metafields.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'

Was this article helpful to you?

SHOPLINE

Legal