CreateSubmissions replaces the submissions for a variant This can be used at any stage, but is most recommended for the intitial creation of a new submission. For updating submissions after creation see UpdateSubmission

POST

/v2/storefront/listing/submission

curl --request POST \
  --url https://api.zentail.com/v2/storefront/listing/submission \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "submissions": [ { "submissionId": "example", "sku": "example", "contentSent": "example", "contentReceived": "example", "metadata": { "additionalProperty": "example" }, "type": "example", "successful": true, "submittedAttributeVersionIds": [ "example" ], "preparedAt": "2026-04-15T12:00:00Z", "submittedAt": "2026-04-15T12:00:00Z", "acknowledgedAt": "2026-04-15T12:00:00Z" } ] }'

Authorizations

• zentail_oauth

Request Body^required

Media typeapplication/json

CreateSubmissionsRequest is used to replace all submissions for the given type and sku

object

submissions

Array<object>

Submission represents specific data sent to a channel for a particular SKU

object

submissionId

submission_id is returned by the API, setting this when calling ReplaceSubmissions will have no effect

string format: int64

sku

string

contentSent

string

contentReceived

string

metadata

object

key

additional properties

string

type

type is a user-specified type which is used to match like submissions when doing a replace operation

string

successful

boolean

submittedAttributeVersionIds

submitted_attribute_version_ids are the Attribute Version IDs of all of the Attributes that were part of this Submission. This is used to show the user in Zentail when each of the Attributes in the Listing were submitted. This is also reflected in the Listing and Variant endpoints via the submitted_at timestamp on each Attribute

Array<string>

preparedAt

string format: date-time

submittedAt

string format: date-time

acknowledgedAt

string format: date-time

Example^generated

{
  "submissions": [
    {
      "submissionId": "example",
      "sku": "example",
      "contentSent": "example",
      "contentReceived": "example",
      "metadata": {
        "additionalProperty": "example"
      },
      "type": "example",
      "successful": true,
      "submittedAttributeVersionIds": [
        "example"
      ],
      "preparedAt": "2026-04-15T12:00:00Z",
      "submittedAt": "2026-04-15T12:00:00Z",
      "acknowledgedAt": "2026-04-15T12:00:00Z"
    }
  ]
}

Responses

200

A successful response.

Media typeapplication/json

CreateSubmissionsResponse contains the submissions created

object

submissions

Array<object>

Submission represents specific data sent to a channel for a particular SKU

object

submissionId

submission_id is returned by the API, setting this when calling ReplaceSubmissions will have no effect

string format: int64

sku

string

contentSent

string

contentReceived

string

metadata

object

key

additional properties

string

type

type is a user-specified type which is used to match like submissions when doing a replace operation

string

successful

boolean

submittedAttributeVersionIds

submitted_attribute_version_ids are the Attribute Version IDs of all of the Attributes that were part of this Submission. This is used to show the user in Zentail when each of the Attributes in the Listing were submitted. This is also reflected in the Listing and Variant endpoints via the submitted_at timestamp on each Attribute

Array<string>

preparedAt

string format: date-time

submittedAt

string format: date-time

acknowledgedAt

string format: date-time

Example^generated

{
  "submissions": [
    {
      "submissionId": "example",
      "sku": "example",
      "contentSent": "example",
      "contentReceived": "example",
      "metadata": {
        "additionalProperty": "example"
      },
      "type": "example",
      "successful": true,
      "submittedAttributeVersionIds": [
        "example"
      ],
      "preparedAt": "2026-04-15T12:00:00Z",
      "submittedAt": "2026-04-15T12:00:00Z",
      "acknowledgedAt": "2026-04-15T12:00:00Z"
    }
  ]
}

default

An unexpected error response.

Media typeapplication/json

object

code

integer format: int32

message

string

details

Array<object>

object

@type

string

key

additional properties

Example^generated

{
  "code": 1,
  "message": "example",
  "details": [
    {
      "@type": "example"
    }
  ]
}