GraphQL API Reference

Welcome to the Submarine Platform GraphQL API reference. This reference includes the complete set of GraphQL types, queries, mutations, and their parameters for interacting with the Submarine eco-system.

For more general Submarine platform documentation, please check out our platform overview.

Learn how to authenticate to the API in the Getting Started guide.

Platform API Status∶ https://status.getsubmarine.com

API Endpoints
# Production:
https://api.getsubmarine.com/graphql
Headers
# You will need your API Token, these are environment specific
Authorization: Bearer <YOUR_PLATFORM_TOKEN_HERE>
Version

1.0.0

Channels

Queries

channel

Description

Find a channel by ID, or return the current channel.

Response

Returns a Channel

Arguments
Name Description
id - SharedGlobalID The channel's ID.

Example

Query
query channel($id: SharedGlobalID) {
  channel(id: $id) {
    channelType
    config {
      ...PlatformConfigFragment
    }
    createdAt
    externalId
    id
    identifier
    name
    organisation {
      ...OrganisationFragment
    }
    sharedSecret
    status
    updatedAt
  }
}
Variables
{"id": SharedGlobalID}
Response
{
  "data": {
    "channel": {
      "channelType": "SHOPIFY",
      "config": PlatformConfig,
      "createdAt": ISO8601DateTime,
      "externalId": 4,
      "id": GlobalID,
      "identifier": "xyz789",
      "name": "xyz789",
      "organisation": Organisation,
      "sharedSecret": "xyz789",
      "status": "ACTIVE",
      "updatedAt": ISO8601DateTime
    }
  }
}

channels

Description

List all channels.

Response

Returns a ChannelConnection

Arguments
Name Description
after - String Returns the elements in the list that come after the specified cursor.
before - String Returns the elements in the list that come before the specified cursor.
first - Int Returns the first n elements from the list.
last - Int Returns the last n elements from the list.

Example

Query
query channels(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int
) {
  channels(
    after: $after,
    before: $before,
    first: $first,
    last: $last
  ) {
    edges {
      ...ChannelEdgeFragment
    }
    nodes {
      ...ChannelFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
  }
}
Variables
{
  "after": "xyz789",
  "before": "xyz789",
  "first": 987,
  "last": 987
}
Response
{
  "data": {
    "channels": {
      "edges": [ChannelEdge],
      "nodes": [Channel],
      "pageInfo": PageInfo
    }
  }
}

Objects

Channel

Description

A sales channel.

Fields
Field Name Description
channelType - ChannelType! The type of sales channel (eg. Shopify).
config - PlatformConfig! The channel's Submarine configuration.
createdAt - ISO8601DateTime! The time the channel was created
externalId - ID! The channel's external ID.
id - GlobalID! The channel's ID.
identifier - String! The channel's identifier
name - String The channel's name
organisation - Organisation! The channel's owner.
sharedSecret - String! The shared secret to be used when decoding Submarine notifications.
status - ChannelStatus! The channel's status (eg. active).
updatedAt - ISO8601DateTime! The time the channel was last updated
Example
{
  "channelType": "SHOPIFY",
  "config": PlatformConfig,
  "createdAt": ISO8601DateTime,
  "externalId": "4",
  "id": GlobalID,
  "identifier": "xyz789",
  "name": "abc123",
  "organisation": Organisation,
  "sharedSecret": "abc123",
  "status": "ACTIVE",
  "updatedAt": ISO8601DateTime
}

Organisations

Queries

organisation

Description

Find an organisation by ID, or return the current organisation

Response

Returns an Organisation

Arguments
Name Description
id - GlobalID The organisation's ID.

Example

Query
query organisation($id: GlobalID) {
  organisation(id: $id) {
    address {
      ...MailingAddressFragment
    }
    channels {
      ...ChannelConnectionFragment
    }
    createdAt
    email
    id
    name
    status
    updatedAt
  }
}
Variables
{"id": GlobalID}
Response
{
  "data": {
    "organisation": {
      "address": MailingAddress,
      "channels": ChannelConnection,
      "createdAt": "xyz789",
      "email": "abc123",
      "id": GlobalID,
      "name": "abc123",
      "status": "ACTIVE",
      "updatedAt": "xyz789"
    }
  }
}

organisations

Description

List all organisations.

Response

Returns an OrganisationConnection

Arguments
Name Description
after - String Returns the elements in the list that come after the specified cursor.
before - String Returns the elements in the list that come before the specified cursor.
first - Int Returns the first n elements from the list.
last - Int Returns the last n elements from the list.

Example

Query
query organisations(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int
) {
  organisations(
    after: $after,
    before: $before,
    first: $first,
    last: $last
  ) {
    edges {
      ...OrganisationEdgeFragment
    }
    nodes {
      ...OrganisationFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
  }
}
Variables
{
  "after": "xyz789",
  "before": "abc123",
  "first": 987,
  "last": 123
}
Response
{
  "data": {
    "organisations": {
      "edges": [OrganisationEdge],
      "nodes": [Organisation],
      "pageInfo": PageInfo
    }
  }
}

Mutations

organisationCreate

Description

Create a new organisation.

Response

Returns an OrganisationCreatePayload

Arguments
Name Description
input - OrganisationCreateInput! Input for creating an organisation.

Example

Query
mutation organisationCreate($input: OrganisationCreateInput!) {
  organisationCreate(input: $input) {
    organisation {
      ...OrganisationFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": OrganisationCreateInput}
Response
{
  "data": {
    "organisationCreate": {
      "organisation": Organisation,
      "userErrors": [UserError]
    }
  }
}

Objects

Organisation

Description

An organisation using the Submarine Platform.

Fields
Field Name Description
address - MailingAddress The organisation's mailing address.
channels - ChannelConnection! The organisation's channels.
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

createdAt - String! The time the organisation was created
email - String! The organisation's email address.
id - GlobalID! The organisation's ID.
name - String! The organisation's name.
status - OrganisationStatus! The organisation's status (eg. active).
updatedAt - String! The time the organisation was last updated
Example
{
  "address": MailingAddress,
  "channels": ChannelConnection,
  "createdAt": "xyz789",
  "email": "xyz789",
  "id": GlobalID,
  "name": "xyz789",
  "status": "ACTIVE",
  "updatedAt": "xyz789"
}

Products

Queries

product

Description

Find a product by ID.

Response

Returns a Product

Arguments
Name Description
id - SharedGlobalID! The product's ID.

Example

Query
query product($id: SharedGlobalID!) {
  product(id: $id) {
    channel {
      ...ChannelFragment
    }
    externalId
    id
    imageUrl
    productVariants {
      ...ProductVariantFragment
    }
    status
    title
  }
}
Variables
{"id": SharedGlobalID}
Response
{
  "data": {
    "product": {
      "channel": Channel,
      "externalId": "xyz789",
      "id": GlobalID,
      "imageUrl": "xyz789",
      "productVariants": [ProductVariant],
      "status": "DELETED",
      "title": "abc123"
    }
  }
}

products

Description

List all products.

Response

Returns a ProductConnection

Arguments
Name Description
after - String Returns the elements in the list that come after the specified cursor.
before - String Returns the elements in the list that come before the specified cursor.
first - Int Returns the first n elements from the list.
last - Int Returns the last n elements from the list.

Example

Query
query products(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int
) {
  products(
    after: $after,
    before: $before,
    first: $first,
    last: $last
  ) {
    edges {
      ...ProductEdgeFragment
    }
    nodes {
      ...ProductFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
  }
}
Variables
{
  "after": "xyz789",
  "before": "xyz789",
  "first": 123,
  "last": 123
}
Response
{
  "data": {
    "products": {
      "edges": [ProductEdge],
      "nodes": [Product],
      "pageInfo": PageInfo
    }
  }
}

Mutations

productCreate

Description

Create a new product.

Response

Returns a ProductCreatePayload

Arguments
Name Description
input - ProductCreateInput! Input for creating a product.

Example

Query
mutation productCreate($input: ProductCreateInput!) {
  productCreate(input: $input) {
    product {
      ...ProductFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": ProductCreateInput}
Response
{
  "data": {
    "productCreate": {
      "product": Product,
      "userErrors": [UserError]
    }
  }
}

productDelete

Description

Delete a product.

Response

Returns a ProductDeletePayload

Arguments
Name Description
input - ProductDeleteInput! Input for deleting a product.

Example

Query
mutation productDelete($input: ProductDeleteInput!) {
  productDelete(input: $input) {
    deletedProductId
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": ProductDeleteInput}
Response
{
  "data": {
    "productDelete": {
      "deletedProductId": GlobalID,
      "userErrors": [UserError]
    }
  }
}

productUpdate

Description

Update a product.

Response

Returns a ProductUpdatePayload

Arguments
Name Description
input - ProductUpdateInput! Input for updating a product.

Example

Query
mutation productUpdate($input: ProductUpdateInput!) {
  productUpdate(input: $input) {
    product {
      ...ProductFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": ProductUpdateInput}
Response
{
  "data": {
    "productUpdate": {
      "product": Product,
      "userErrors": [UserError]
    }
  }
}

Objects

Product

Description

A product.

Fields
Field Name Description
channel - Channel! The product's channel.
externalId - String! The product's external ID.
id - GlobalID! The product's ID.
imageUrl - String The product's image url.
productVariants - [ProductVariant!]! The product's variants.
status - ProductStatus! The product's status.
title - String The product's title.
Example
{
  "channel": Channel,
  "externalId": "abc123",
  "id": GlobalID,
  "imageUrl": "abc123",
  "productVariants": [ProductVariant],
  "status": "DELETED",
  "title": "abc123"
}

Product Variants

Queries

productVariant

Description

Find a product variant by ID.

Response

Returns a ProductVariant

Arguments
Name Description
id - SharedGlobalID! The product variant's ID.

Example

Query
query productVariant($id: SharedGlobalID!) {
  productVariant(id: $id) {
    externalId
    id
    imageUrl
    price {
      ...MoneyFragment
    }
    product {
      ...ProductFragment
    }
    shippable
    sku
    status
    taxable
    title
    weightGrams
  }
}
Variables
{"id": SharedGlobalID}
Response
{
  "data": {
    "productVariant": {
      "externalId": "xyz789",
      "id": GlobalID,
      "imageUrl": "abc123",
      "price": Money,
      "product": Product,
      "shippable": true,
      "sku": "abc123",
      "status": "DELETED",
      "taxable": false,
      "title": "abc123",
      "weightGrams": 123
    }
  }
}

productVariants

Description

List all product variants.

Response

Returns a ProductVariantConnection

Arguments
Name Description
after - String Returns the elements in the list that come after the specified cursor.
before - String Returns the elements in the list that come before the specified cursor.
first - Int Returns the first n elements from the list.
last - Int Returns the last n elements from the list.

Example

Query
query productVariants(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int
) {
  productVariants(
    after: $after,
    before: $before,
    first: $first,
    last: $last
  ) {
    edges {
      ...ProductVariantEdgeFragment
    }
    nodes {
      ...ProductVariantFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
  }
}
Variables
{
  "after": "abc123",
  "before": "xyz789",
  "first": 123,
  "last": 123
}
Response
{
  "data": {
    "productVariants": {
      "edges": [ProductVariantEdge],
      "nodes": [ProductVariant],
      "pageInfo": PageInfo
    }
  }
}

Mutations

productVariantCreate

Description

Create a new product variant.

Response

Returns a ProductVariantCreatePayload

Arguments
Name Description
input - ProductVariantCreateInput! Input for creating a product variant.

Example

Query
mutation productVariantCreate($input: ProductVariantCreateInput!) {
  productVariantCreate(input: $input) {
    productVariant {
      ...ProductVariantFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": ProductVariantCreateInput}
Response
{
  "data": {
    "productVariantCreate": {
      "productVariant": ProductVariant,
      "userErrors": [UserError]
    }
  }
}

productVariantDelete

Description

Delete a product variant.

Response

Returns a ProductVariantDeletePayload

Arguments
Name Description
input - ProductVariantDeleteInput! Input for deleting a product variant.

Example

Query
mutation productVariantDelete($input: ProductVariantDeleteInput!) {
  productVariantDelete(input: $input) {
    deletedProductVariantId
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": ProductVariantDeleteInput}
Response
{
  "data": {
    "productVariantDelete": {
      "deletedProductVariantId": GlobalID,
      "userErrors": [UserError]
    }
  }
}

productVariantUpdate

Description

Update a product variant.

Response

Returns a ProductVariantUpdatePayload

Arguments
Name Description
input - ProductVariantUpdateInput! Input for updating a product variant.

Example

Query
mutation productVariantUpdate($input: ProductVariantUpdateInput!) {
  productVariantUpdate(input: $input) {
    productVariant {
      ...ProductVariantFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": ProductVariantUpdateInput}
Response
{
  "data": {
    "productVariantUpdate": {
      "productVariant": ProductVariant,
      "userErrors": [UserError]
    }
  }
}

Objects

ProductVariant

Description

A product.

Fields
Field Name Description
externalId - String! The variant's external ID.
id - GlobalID! The product variant's ID.
imageUrl - String The variant's image URL.
price - Money! The variant's price
product - Product! The product this variant belongs to.
shippable - Boolean! Whether the variant requires shipping.
sku - String The variant's SKU.
status - ProductVariantStatus! The variant's status.
taxable - Boolean! Whether a tax is charged when the variant is sold.
title - String The variant's title.
weightGrams - Int The variant's weight in grams.
Example
{
  "externalId": "abc123",
  "id": GlobalID,
  "imageUrl": "abc123",
  "price": Money,
  "product": Product,
  "shippable": false,
  "sku": "abc123",
  "status": "DELETED",
  "taxable": false,
  "title": "abc123",
  "weightGrams": 987
}

Webhooks

Queries

webhook

Description

Find a webhook by ID.

Response

Returns a Webhook

Arguments
Name Description
id - GlobalID! The webhook's ID.

Example

Query
query webhook($id: GlobalID!) {
  webhook(id: $id) {
    channel {
      ...ChannelFragment
    }
    createdAt
    id
    status
    topic
    updatedAt
    url
  }
}
Variables
{"id": GlobalID}
Response
{
  "data": {
    "webhook": {
      "channel": Channel,
      "createdAt": ISO8601DateTime,
      "id": GlobalID,
      "status": "ACTIVE",
      "topic": "CAMPAIGN_ORDER_CANCELLED",
      "updatedAt": ISO8601DateTime,
      "url": Url
    }
  }
}

webhooks

Description

List all webhooks.

Response

Returns a WebhookConnection

Arguments
Name Description
after - String Returns the elements in the list that come after the specified cursor.
before - String Returns the elements in the list that come before the specified cursor.
first - Int Returns the first n elements from the list.
last - Int Returns the last n elements from the list.

Example

Query
query webhooks(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int
) {
  webhooks(
    after: $after,
    before: $before,
    first: $first,
    last: $last
  ) {
    edges {
      ...WebhookEdgeFragment
    }
    nodes {
      ...WebhookFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
  }
}
Variables
{
  "after": "abc123",
  "before": "xyz789",
  "first": 123,
  "last": 987
}
Response
{
  "data": {
    "webhooks": {
      "edges": [WebhookEdge],
      "nodes": [Webhook],
      "pageInfo": PageInfo
    }
  }
}

Mutations

webhookCreate

Description

Creates a webhook subscription.

Response

Returns a WebhookCreatePayload

Arguments
Name Description
input - WebhookCreateInput! Input for creating a webhook subscription.

Example

Query
mutation webhookCreate($input: WebhookCreateInput!) {
  webhookCreate(input: $input) {
    userErrors {
      ...UserErrorFragment
    }
    webhook {
      ...WebhookFragment
    }
  }
}
Variables
{"input": WebhookCreateInput}
Response
{
  "data": {
    "webhookCreate": {
      "userErrors": [UserError],
      "webhook": Webhook
    }
  }
}

webhookDelete

Description

Deletes a webhook subscription.

Response

Returns a WebhookDeletePayload

Arguments
Name Description
input - WebhookDeleteInput! Input for deleting a Webhook Subscription.

Example

Query
mutation webhookDelete($input: WebhookDeleteInput!) {
  webhookDelete(input: $input) {
    deletedWebhookId
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": WebhookDeleteInput}
Response
{
  "data": {
    "webhookDelete": {
      "deletedWebhookId": GlobalID,
      "userErrors": [UserError]
    }
  }
}

webhookUpdate

Description

Updates a webhook subscription.

Response

Returns a WebhookUpdatePayload

Arguments
Name Description
input - WebhookUpdateInput! Input for updating the webhook.

Example

Query
mutation webhookUpdate($input: WebhookUpdateInput!) {
  webhookUpdate(input: $input) {
    userErrors {
      ...UserErrorFragment
    }
    webhook {
      ...WebhookFragment
    }
  }
}
Variables
{"input": WebhookUpdateInput}
Response
{
  "data": {
    "webhookUpdate": {
      "userErrors": [UserError],
      "webhook": Webhook
    }
  }
}

Objects

Webhook

Description

A webhook.

Fields
Field Name Description
channel - Channel! The webhooks's channel
createdAt - ISO8601DateTime! The time the webhook was created
id - GlobalID! The webhooks's ID.
status - WebhookStatus! The webhooks's status (eg. ACTIVE).
topic - WebhookTopic! The webhooks's topic (eg. CHARGE_FAILED).
updatedAt - ISO8601DateTime! The time the webhook was last updated
url - Url! The webhooks url path
Example
{
  "channel": Channel,
  "createdAt": ISO8601DateTime,
  "id": GlobalID,
  "status": "ACTIVE",
  "topic": "CAMPAIGN_ORDER_CANCELLED",
  "updatedAt": ISO8601DateTime,
  "url": Url
}

Charges

Queries

charge

Description

Find a Charge by ID.

Response

Returns a Charge

Arguments
Name Description
id - GlobalID! The charge's ID.

Example

Query
query charge($id: GlobalID!) {
  charge(id: $id) {
    amount {
      ...MoneyFragment
    }
    chargeType
    createdAt
    customer {
      ...CustomerFragment
    }
    description
    externalId
    failureCode
    failureMessage
    id
    metadata
    paymentIntent {
      ...PaymentIntentFragment
    }
    recordStatus
    refunds {
      ...RefundFragment
    }
    source
    status
    updatedAt
  }
}
Variables
{"id": GlobalID}
Response
{
  "data": {
    "charge": {
      "amount": Money,
      "chargeType": "AUTHORISE",
      "createdAt": ISO8601DateTime,
      "customer": Customer,
      "description": "abc123",
      "externalId": "xyz789",
      "failureCode": "API_ERROR",
      "failureMessage": "abc123",
      "id": GlobalID,
      "metadata": Metadata,
      "paymentIntent": PaymentIntent,
      "recordStatus": "PROCESSED",
      "refunds": [Refund],
      "source": "SHOPIFY",
      "status": "FAILED",
      "updatedAt": ISO8601DateTime
    }
  }
}

charges

Description

List all charges.

Response

Returns a ChargeConnection

Arguments
Name Description
after - String Returns the elements in the list that come after the specified cursor.
before - String Returns the elements in the list that come before the specified cursor.
first - Int Returns the first n elements from the list.
last - Int Returns the last n elements from the list.

Example

Query
query charges(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int
) {
  charges(
    after: $after,
    before: $before,
    first: $first,
    last: $last
  ) {
    edges {
      ...ChargeEdgeFragment
    }
    nodes {
      ...ChargeFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
    totalCount
  }
}
Variables
{
  "after": "abc123",
  "before": "abc123",
  "first": 987,
  "last": 123
}
Response
{
  "data": {
    "charges": {
      "edges": [ChargeEdge],
      "nodes": [Charge],
      "pageInfo": PageInfo,
      "totalCount": 987
    }
  }
}

Mutations

chargeCapture

Description

Captures a charge for a payment intent.

Response

Returns a ChargeCapturePayload

Arguments
Name Description
input - ChargeCaptureInput! Input for capturing a charge.

Example

Query
mutation chargeCapture($input: ChargeCaptureInput!) {
  chargeCapture(input: $input) {
    charge {
      ...ChargeFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": ChargeCaptureInput}
Response
{
  "data": {
    "chargeCapture": {
      "charge": Charge,
      "userErrors": [UserError]
    }
  }
}

chargeRecord

Description

Records a charge for a payment intent.

Response

Returns a ChargeRecordPayload

Arguments
Name Description
input - ChargeRecordInput! Input for recording a charge.

Example

Query
mutation chargeRecord($input: ChargeRecordInput!) {
  chargeRecord(input: $input) {
    charge {
      ...ChargeFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": ChargeRecordInput}
Response
{
  "data": {
    "chargeRecord": {
      "charge": Charge,
      "userErrors": [UserError]
    }
  }
}

Objects

Charge

Description

A Charge

Fields
Field Name Description
amount - Money The amount the charge is for.
chargeType - ChargeType The type of charge.
createdAt - ISO8601DateTime! The time the charge was created.
customer - Customer! The customer associated with the charge.
description - String The charge's description.
externalId - String The external ID of the charge.
failureCode - ChargeFailureCode The type of failure.
failureMessage - String The failure message.
id - GlobalID! The ID of the charge.
metadata - Metadata Unstructured key/value pairs.
paymentIntent - PaymentIntent! The associated payment intent.
recordStatus - RecordStatus The record status of charge.
refunds - [Refund!] The refunds associated with this charge.
source - ChargeSource The source of the charge.
status - ChargeStatus The charge's status.
updatedAt - ISO8601DateTime The time the charge was last updated.
Example
{
  "amount": Money,
  "chargeType": "AUTHORISE",
  "createdAt": ISO8601DateTime,
  "customer": Customer,
  "description": "xyz789",
  "externalId": "xyz789",
  "failureCode": "API_ERROR",
  "failureMessage": "abc123",
  "id": GlobalID,
  "metadata": Metadata,
  "paymentIntent": PaymentIntent,
  "recordStatus": "PROCESSED",
  "refunds": [Refund],
  "source": "SHOPIFY",
  "status": "FAILED",
  "updatedAt": ISO8601DateTime
}

Payment Intents

Queries

paymentIntent

Description

Find a Payment Intent by ID.

Response

Returns a PaymentIntent

Arguments
Name Description
id - GlobalID! The payment intent's ID.

Example

Query
query paymentIntent($id: GlobalID!) {
  paymentIntent(id: $id) {
    adjustments {
      ...PaymentIntentAdjustmentFragment
    }
    amount {
      ...MoneyFragment
    }
    amountPaid {
      ...MoneyFragment
    }
    amountRefunded {
      ...MoneyFragment
    }
    balanceOwing {
      ...MoneyFragment
    }
    charges {
      ...ChargeFragment
    }
    createdAt
    customer {
      ...CustomerFragment
    }
    finalisedAt
    flexible
    id
    metadata
    paymentMethod {
      ...PaymentMethodFragment
    }
    refunds {
      ...RefundFragment
    }
    status
    updatedAt
  }
}
Variables
{"id": GlobalID}
Response
{
  "data": {
    "paymentIntent": {
      "adjustments": [PaymentIntentAdjustment],
      "amount": Money,
      "amountPaid": Money,
      "amountRefunded": Money,
      "balanceOwing": Money,
      "charges": [Charge],
      "createdAt": ISO8601DateTime,
      "customer": Customer,
      "finalisedAt": ISO8601DateTime,
      "flexible": false,
      "id": GlobalID,
      "metadata": Metadata,
      "paymentMethod": PaymentMethod,
      "refunds": [Refund],
      "status": "CANCELLED",
      "updatedAt": ISO8601DateTime
    }
  }
}

paymentIntents

Description

List all payment intents.

Response

Returns a PaymentIntentConnection

Arguments
Name Description
after - String Returns the elements in the list that come after the specified cursor.
before - String Returns the elements in the list that come before the specified cursor.
first - Int Returns the first n elements from the list.
last - Int Returns the last n elements from the list.

Example

Query
query paymentIntents(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int
) {
  paymentIntents(
    after: $after,
    before: $before,
    first: $first,
    last: $last
  ) {
    edges {
      ...PaymentIntentEdgeFragment
    }
    nodes {
      ...PaymentIntentFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
    totalCount
  }
}
Variables
{
  "after": "abc123",
  "before": "xyz789",
  "first": 987,
  "last": 987
}
Response
{
  "data": {
    "paymentIntents": {
      "edges": [PaymentIntentEdge],
      "nodes": [PaymentIntent],
      "pageInfo": PageInfo,
      "totalCount": 987
    }
  }
}

Mutations

paymentIntentAdjustmentCreate

Description

Creates an adjustment to a payment intent.

Arguments
Name Description
input - PaymentIntentAdjustmentCreateInput! Input for creating a payment intent.

Example

Query
mutation paymentIntentAdjustmentCreate($input: PaymentIntentAdjustmentCreateInput!) {
  paymentIntentAdjustmentCreate(input: $input) {
    paymentIntentAdjustment {
      ...PaymentIntentAdjustmentFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PaymentIntentAdjustmentCreateInput}
Response
{
  "data": {
    "paymentIntentAdjustmentCreate": {
      "paymentIntentAdjustment": PaymentIntentAdjustment,
      "userErrors": [UserError]
    }
  }
}

paymentIntentCancel

Description

Cancels a payment intent.

Response

Returns a PaymentIntentCancelPayload

Arguments
Name Description
input - PaymentIntentCancelInput! Input for cancelling a payment intent.

Example

Query
mutation paymentIntentCancel($input: PaymentIntentCancelInput!) {
  paymentIntentCancel(input: $input) {
    paymentIntent {
      ...PaymentIntentFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PaymentIntentCancelInput}
Response
{
  "data": {
    "paymentIntentCancel": {
      "paymentIntent": PaymentIntent,
      "userErrors": [UserError]
    }
  }
}

paymentIntentCreate

Description

Creates a payment intent.

Response

Returns a PaymentIntentCreatePayload

Arguments
Name Description
input - PaymentIntentCreateInput! Input for creating a payment intent.

Example

Query
mutation paymentIntentCreate($input: PaymentIntentCreateInput!) {
  paymentIntentCreate(input: $input) {
    paymentIntent {
      ...PaymentIntentFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PaymentIntentCreateInput}
Response
{
  "data": {
    "paymentIntentCreate": {
      "paymentIntent": PaymentIntent,
      "userErrors": [UserError]
    }
  }
}

paymentIntentUpdate

Description

Updates a payment intent.

Response

Returns a PaymentIntentUpdatePayload

Arguments
Name Description
input - PaymentIntentUpdateInput! Input for updating a payment intent.

Example

Query
mutation paymentIntentUpdate($input: PaymentIntentUpdateInput!) {
  paymentIntentUpdate(input: $input) {
    paymentIntent {
      ...PaymentIntentFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PaymentIntentUpdateInput}
Response
{
  "data": {
    "paymentIntentUpdate": {
      "paymentIntent": PaymentIntent,
      "userErrors": [UserError]
    }
  }
}

Objects

PaymentIntent

Description

A payment intent.

Fields
Field Name Description
adjustments - [PaymentIntentAdjustment!] The adjustments made against this payment intent.
amount - Money The payment intent money amount
amountPaid - Money The payment intent money amount
amountRefunded - Money The payment intent money amount
balanceOwing - Money The payment intent money amount
charges - [Charge!] The charges made against this payment intent.
createdAt - ISO8601DateTime! PaymentIntent creation time
customer - Customer! The customer
finalisedAt - ISO8601DateTime PaymentIntent finalised time
flexible - Boolean The flexibility of a payment intent
id - GlobalID! The payment intent's ID.
metadata - Metadata Unstructured key/value pairs
paymentMethod - PaymentMethod! The associated payment method
refunds - [Refund!] The refunds made against this payment intent.
status - PaymentIntentStatus Status of the payment intent
updatedAt - ISO8601DateTime PaymentIntent last updated at
Example
{
  "adjustments": [PaymentIntentAdjustment],
  "amount": Money,
  "amountPaid": Money,
  "amountRefunded": Money,
  "balanceOwing": Money,
  "charges": [Charge],
  "createdAt": ISO8601DateTime,
  "customer": Customer,
  "finalisedAt": ISO8601DateTime,
  "flexible": false,
  "id": GlobalID,
  "metadata": Metadata,
  "paymentMethod": PaymentMethod,
  "refunds": [Refund],
  "status": "CANCELLED",
  "updatedAt": ISO8601DateTime
}

Payment Methods

Queries

paymentMethod

Description

Find a Payment Method by ID.

Response

Returns a PaymentMethod

Arguments
Name Description
id - GlobalID! The payment method's ID.

Example

Query
query paymentMethod($id: GlobalID!) {
  paymentMethod(id: $id) {
    activePaymentInstrument {
      ...PaymentInstrumentFragment
    }
    channel {
      ...ChannelFragment
    }
    createdAt
    customer {
      ...CustomerFragment
    }
    externalId
    id
    metadata
    paymentInstruments {
      ...PaymentInstrumentFragment
    }
    paymentIntents {
      ...PaymentIntentConnectionFragment
    }
    status
    updatedAt
  }
}
Variables
{"id": GlobalID}
Response
{
  "data": {
    "paymentMethod": {
      "activePaymentInstrument": PaymentInstrument,
      "channel": Channel,
      "createdAt": ISO8601DateTime,
      "customer": Customer,
      "externalId": "xyz789",
      "id": GlobalID,
      "metadata": Metadata,
      "paymentInstruments": [PaymentInstrument],
      "paymentIntents": PaymentIntentConnection,
      "status": "ACTIVE",
      "updatedAt": ISO8601DateTime
    }
  }
}

paymentMethods

Description

List all payment methods.

Response

Returns a PaymentMethodConnection

Arguments
Name Description
after - String Returns the elements in the list that come after the specified cursor.
before - String Returns the elements in the list that come before the specified cursor.
first - Int Returns the first n elements from the list.
last - Int Returns the last n elements from the list.

Example

Query
query paymentMethods(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int
) {
  paymentMethods(
    after: $after,
    before: $before,
    first: $first,
    last: $last
  ) {
    edges {
      ...PaymentMethodEdgeFragment
    }
    nodes {
      ...PaymentMethodFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
    totalCount
  }
}
Variables
{
  "after": "abc123",
  "before": "abc123",
  "first": 123,
  "last": 123
}
Response
{
  "data": {
    "paymentMethods": {
      "edges": [PaymentMethodEdge],
      "nodes": [PaymentMethod],
      "pageInfo": PageInfo,
      "totalCount": 987
    }
  }
}

Mutations

paymentMethodCancel

Description

Cancels a payment method.

Response

Returns a PaymentMethodCancelPayload

Arguments
Name Description
input - PaymentMethodCancelInput! Input for cancelling a payment method.

Example

Query
mutation paymentMethodCancel($input: PaymentMethodCancelInput!) {
  paymentMethodCancel(input: $input) {
    paymentMethod {
      ...PaymentMethodFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PaymentMethodCancelInput}
Response
{
  "data": {
    "paymentMethodCancel": {
      "paymentMethod": PaymentMethod,
      "userErrors": [UserError]
    }
  }
}

paymentMethodCreate

Description

Creates a payment method.

Response

Returns a PaymentMethodCreatePayload

Arguments
Name Description
input - PaymentMethodCreateInput! Input for creating a payment method.

Example

Query
mutation paymentMethodCreate($input: PaymentMethodCreateInput!) {
  paymentMethodCreate(input: $input) {
    paymentMethod {
      ...PaymentMethodFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PaymentMethodCreateInput}
Response
{
  "data": {
    "paymentMethodCreate": {
      "paymentMethod": PaymentMethod,
      "userErrors": [UserError]
    }
  }
}

paymentMethodUpdate

Description

Updates a payment method.

Response

Returns a PaymentMethodUpdatePayload

Arguments
Name Description
input - PaymentMethodUpdateInput! Input for updating a payment method.

Example

Query
mutation paymentMethodUpdate($input: PaymentMethodUpdateInput!) {
  paymentMethodUpdate(input: $input) {
    paymentMethod {
      ...PaymentMethodFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PaymentMethodUpdateInput}
Response
{
  "data": {
    "paymentMethodUpdate": {
      "paymentMethod": PaymentMethod,
      "userErrors": [UserError]
    }
  }
}

Objects

PaymentMethod

Description

A payment method.

Fields
Field Name Description
activePaymentInstrument - PaymentInstrument!
channel - Channel! The payment method's channel.
createdAt - ISO8601DateTime! The date and time when the payment method was created.
customer - Customer! The payment method's customer.
externalId - String The (optional) external ID of the payment method.
id - GlobalID! The payment method's ID.
metadata - Metadata Unstructured key/value pairs.
paymentInstruments - [PaymentInstrument!] The payment instruments associated to this payment method.
paymentIntents - PaymentIntentConnection The payment intents associated with this payment method.
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

status - PaymentMethodStatus The status of the payment method.
updatedAt - ISO8601DateTime The date and time when the payment method was last updated.
Example
{
  "activePaymentInstrument": PaymentInstrument,
  "channel": Channel,
  "createdAt": ISO8601DateTime,
  "customer": Customer,
  "externalId": "abc123",
  "id": GlobalID,
  "metadata": Metadata,
  "paymentInstruments": [PaymentInstrument],
  "paymentIntents": PaymentIntentConnection,
  "status": "ACTIVE",
  "updatedAt": ISO8601DateTime
}

Refunds

Queries

refund

Description

Find a Refund by ID.

Response

Returns a Refund

Arguments
Name Description
id - GlobalID! The refund's ID.

Example

Query
query refund($id: GlobalID!) {
  refund(id: $id) {
    amount {
      ...MoneyFragment
    }
    charge {
      ...ChargeFragment
    }
    createdAt
    customer {
      ...CustomerFragment
    }
    description
    externalId
    id
    metadata
    paymentIntent {
      ...PaymentIntentFragment
    }
    recordStatus
    source
    status
    updatedAt
  }
}
Variables
{"id": GlobalID}
Response
{
  "data": {
    "refund": {
      "amount": Money,
      "charge": Charge,
      "createdAt": ISO8601DateTime,
      "customer": Customer,
      "description": "abc123",
      "externalId": "abc123",
      "id": GlobalID,
      "metadata": Metadata,
      "paymentIntent": PaymentIntent,
      "recordStatus": "PROCESSED",
      "source": "SHOPIFY",
      "status": "FAILED",
      "updatedAt": ISO8601DateTime
    }
  }
}

refunds

Description

List all refunds.

Response

Returns a RefundConnection

Arguments
Name Description
after - String Returns the elements in the list that come after the specified cursor.
before - String Returns the elements in the list that come before the specified cursor.
first - Int Returns the first n elements from the list.
last - Int Returns the last n elements from the list.

Example

Query
query refunds(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int
) {
  refunds(
    after: $after,
    before: $before,
    first: $first,
    last: $last
  ) {
    edges {
      ...RefundEdgeFragment
    }
    nodes {
      ...RefundFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
    totalCount
  }
}
Variables
{
  "after": "abc123",
  "before": "xyz789",
  "first": 987,
  "last": 987
}
Response
{
  "data": {
    "refunds": {
      "edges": [RefundEdge],
      "nodes": [Refund],
      "pageInfo": PageInfo,
      "totalCount": 987
    }
  }
}

Mutations

refundProcess

Description

Processes a refund for a payment intent.

Response

Returns a RefundProcessPayload

Arguments
Name Description
input - RefundProcessInput! Input for processing a refund.

Example

Query
mutation refundProcess($input: RefundProcessInput!) {
  refundProcess(input: $input) {
    refund {
      ...RefundFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": RefundProcessInput}
Response
{
  "data": {
    "refundProcess": {
      "refund": Refund,
      "userErrors": [UserError]
    }
  }
}

refundRecord

Description

Record a refund for a payment intent.

Response

Returns a RefundRecordPayload

Arguments
Name Description
input - RefundRecordInput! Input for recording a refund.

Example

Query
mutation refundRecord($input: RefundRecordInput!) {
  refundRecord(input: $input) {
    refund {
      ...RefundFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": RefundRecordInput}
Response
{
  "data": {
    "refundRecord": {
      "refund": Refund,
      "userErrors": [UserError]
    }
  }
}

Objects

Refund

Description

A Refund

Fields
Field Name Description
amount - Money The amount the refund if for.
charge - Charge The refund's parent charge.
createdAt - ISO8601DateTime! The time the refund was created.
customer - Customer! The customer associated with the refund.
description - String The refund's description.
externalId - String The external ID of the refund.
id - GlobalID! The ID of the refund.
metadata - Metadata Unstructured key/value pairs/
paymentIntent - PaymentIntent! The associated payment intent.
recordStatus - RecordStatus The record status of refund.
source - ChargeSource The source of the refund.
status - RefundStatus The refund's status.
updatedAt - ISO8601DateTime The time the refund was last updated.
Example
{
  "amount": Money,
  "charge": Charge,
  "createdAt": ISO8601DateTime,
  "customer": Customer,
  "description": "abc123",
  "externalId": "abc123",
  "id": GlobalID,
  "metadata": Metadata,
  "paymentIntent": PaymentIntent,
  "recordStatus": "PROCESSED",
  "source": "SHOPIFY",
  "status": "FAILED",
  "updatedAt": ISO8601DateTime
}

Shopify Credentials

Mutations

shopifyCredentialsCreate

Description

Creates a set of Shopify credentials.

Response

Returns a ShopifyCredentialsCreatePayload

Arguments
Name Description
input - ShopifyCredentialsCreateInput! Input for creating shopify credentials.

Example

Query
mutation shopifyCredentialsCreate($input: ShopifyCredentialsCreateInput!) {
  shopifyCredentialsCreate(input: $input) {
    shopifyCredentials {
      ...ShopifyCredentialsFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": ShopifyCredentialsCreateInput}
Response
{
  "data": {
    "shopifyCredentialsCreate": {
      "shopifyCredentials": ShopifyCredentials,
      "userErrors": [UserError]
    }
  }
}

Campaign Orders

Queries

campaignOrder

Description

Find an campaign order by ID.

Response

Returns a CampaignOrder

Arguments
Name Description
id - GlobalID! The campaign order's ID.

Example

Query
query campaignOrder($id: GlobalID!) {
  campaignOrder(id: $id) {
    allocatedQuantity
    campaign {
      ... on CrowdfundingCampaign {
        ...CrowdfundingCampaignFragment
      }
      ... on PresaleCampaign {
        ...PresaleCampaignFragment
      }
    }
    campaignInventoryItem {
      ...CampaignInventoryItemFragment
    }
    campaignItem {
      ...CampaignItemFragment
    }
    campaignOrderGroup {
      ...CampaignOrderGroupFragment
    }
    cancelReason
    cancelledBy
    customer {
      ...CustomerFragment
    }
    financials {
      ...CampaignOrderFinancialsFragment
    }
    fulfilmentStatus
    id
    identifier
    milestones {
      ...CampaignOrderMilestonesFragment
    }
    originalQuantity
    paymentIntent {
      ...PaymentIntentFragment
    }
    paymentMethod {
      ...PaymentMethodFragment
    }
    paymentStatus
    product {
      ...ProductFragment
    }
    productVariant {
      ...ProductVariantFragment
    }
    quantity
    sequentialId
    status
  }
}
Variables
{"id": GlobalID}
Response
{
  "data": {
    "campaignOrder": {
      "allocatedQuantity": 123,
      "campaign": CrowdfundingCampaign,
      "campaignInventoryItem": CampaignInventoryItem,
      "campaignItem": CampaignItem,
      "campaignOrderGroup": CampaignOrderGroup,
      "cancelReason": "xyz789",
      "cancelledBy": "CUSTOMER",
      "customer": Customer,
      "financials": CampaignOrderFinancials,
      "fulfilmentStatus": "ALLOCATED",
      "id": GlobalID,
      "identifier": "abc123",
      "milestones": CampaignOrderMilestones,
      "originalQuantity": 987,
      "paymentIntent": PaymentIntent,
      "paymentMethod": PaymentMethod,
      "paymentStatus": "FAILED",
      "product": Product,
      "productVariant": ProductVariant,
      "quantity": 987,
      "sequentialId": 123,
      "status": "ALLOCATED"
    }
  }
}

campaignOrderPagination

Description

Next and previous campaign orders

Response

Returns a PaginationResult

Arguments
Name Description
campaignId - GlobalID Return only campaign orders belonging to this campaign.
campaignType - CampaignType Return only campaign orders of the given type.
customerId - [SharedGlobalID!] Return only campaign orders belonging to these customers.
fulfilmentStatus - [CampaignOrderFulfilmentStatus!] The campaign order's fulfilment status.
paymentStatus - [CampaignOrderPaymentStatus!] The campaign order's payment status.
productVariantId - [SharedGlobalID!] Return only campaign orders for these variants.
query - String A query string.
sortDirection - SortDirection The sort direction.
sortKey - CampaignOrderSortKey The key used to sort campaign orders.
status - [CampaignOrderStatus!] The campaign order's status.

Example

Query
query campaignOrderPagination(
  $campaignId: GlobalID,
  $campaignType: CampaignType,
  $customerId: [SharedGlobalID!],
  $fulfilmentStatus: [CampaignOrderFulfilmentStatus!],
  $paymentStatus: [CampaignOrderPaymentStatus!],
  $productVariantId: [SharedGlobalID!],
  $query: String,
  $sortDirection: SortDirection,
  $sortKey: CampaignOrderSortKey,
  $status: [CampaignOrderStatus!]
) {
  campaignOrderPagination(
    campaignId: $campaignId,
    campaignType: $campaignType,
    customerId: $customerId,
    fulfilmentStatus: $fulfilmentStatus,
    paymentStatus: $paymentStatus,
    productVariantId: $productVariantId,
    query: $query,
    sortDirection: $sortDirection,
    sortKey: $sortKey,
    status: $status
  ) {
    queryArguments
    nextCampaignOrders {
      ...CampaignOrderConnectionFragment
    }
    nextCrowdfundingCampaigns {
      ...CrowdfundingCampaignConnectionFragment
    }
    nextPresaleCampaigns {
      ...PresaleCampaignConnectionFragment
    }
    previousCampaignOrders {
      ...CampaignOrderConnectionFragment
    }
    previousCrowdfundingCampaigns {
      ...CrowdfundingCampaignConnectionFragment
    }
    previousPresaleCampaigns {
      ...PresaleCampaignConnectionFragment
    }
    nextSubscriptionOrders {
      ...SubscriptionOrderConnectionFragment
    }
    nextSubscriptionPlanGroups {
      ...SubscriptionPlanGroupConnectionFragment
    }
    nextSubscriptions {
      ...SubscriptionConnectionFragment
    }
    previousSubscriptionOrders {
      ...SubscriptionOrderConnectionFragment
    }
    previousSubscriptionPlanGroups {
      ...SubscriptionPlanGroupConnectionFragment
    }
    previousSubscriptions {
      ...SubscriptionConnectionFragment
    }
  }
}
Variables
{
  "campaignId": GlobalID,
  "campaignType": "CROWDFUNDING",
  "customerId": [SharedGlobalID],
  "fulfilmentStatus": ["ALLOCATED"],
  "paymentStatus": ["FAILED"],
  "productVariantId": [SharedGlobalID],
  "query": "xyz789",
  "sortDirection": "ASC",
  "sortKey": "CREATED_AT",
  "status": ["ALLOCATED"]
}
Response
{
  "data": {
    "campaignOrderPagination": {
      "queryArguments": "abc123",
      "nextCampaignOrders": CampaignOrderConnection,
      "nextCrowdfundingCampaigns": CrowdfundingCampaignConnection,
      "nextPresaleCampaigns": PresaleCampaignConnection,
      "previousCampaignOrders": CampaignOrderConnection,
      "previousCrowdfundingCampaigns": CrowdfundingCampaignConnection,
      "previousPresaleCampaigns": PresaleCampaignConnection,
      "nextSubscriptionOrders": SubscriptionOrderConnection,
      "nextSubscriptionPlanGroups": SubscriptionPlanGroupConnection,
      "nextSubscriptions": SubscriptionConnection,
      "previousSubscriptionOrders": SubscriptionOrderConnection,
      "previousSubscriptionPlanGroups": SubscriptionPlanGroupConnection,
      "previousSubscriptions": SubscriptionConnection
    }
  }
}

campaignOrders

Description

List all campaign orders.

Response

Returns a CampaignOrderConnection

Arguments
Name Description
after - String Returns the elements in the list that come after the specified cursor.
before - String Returns the elements in the list that come before the specified cursor.
first - Int Returns the first n elements from the list.
last - Int Returns the last n elements from the list.

Example

Query
query campaignOrders(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int
) {
  campaignOrders(
    after: $after,
    before: $before,
    first: $first,
    last: $last
  ) {
    edges {
      ...CampaignOrderEdgeFragment
    }
    nodes {
      ...CampaignOrderFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
    totalCount
  }
}
Variables
{
  "after": "xyz789",
  "before": "abc123",
  "first": 123,
  "last": 123
}
Response
{
  "data": {
    "campaignOrders": {
      "edges": [CampaignOrderEdge],
      "nodes": [CampaignOrder],
      "pageInfo": PageInfo,
      "totalCount": 987
    }
  }
}

searchCampaignOrders

Description

Search campaign orders

Response

Returns a SearchResult

Arguments
Name Description
campaignId - GlobalID Return only campaign orders belonging to this campaign.
campaignType - CampaignType Return only campaign orders of the given type.
customerId - [SharedGlobalID!] Return only campaign orders belonging to these customers.
fulfilmentStatus - [CampaignOrderFulfilmentStatus!] The campaign order's fulfilment status.
paymentStatus - [CampaignOrderPaymentStatus!] The campaign order's payment status.
productVariantId - [SharedGlobalID!] Return only campaign orders for these variants.
query - String A query string.
sortDirection - SortDirection The sort direction.
sortKey - CampaignOrderSortKey The key used to sort campaign orders.
status - [CampaignOrderStatus!] The campaign order's status.

Example

Query
query searchCampaignOrders(
  $campaignId: GlobalID,
  $campaignType: CampaignType,
  $customerId: [SharedGlobalID!],
  $fulfilmentStatus: [CampaignOrderFulfilmentStatus!],
  $paymentStatus: [CampaignOrderPaymentStatus!],
  $productVariantId: [SharedGlobalID!],
  $query: String,
  $sortDirection: SortDirection,
  $sortKey: CampaignOrderSortKey,
  $status: [CampaignOrderStatus!]
) {
  searchCampaignOrders(
    campaignId: $campaignId,
    campaignType: $campaignType,
    customerId: $customerId,
    fulfilmentStatus: $fulfilmentStatus,
    paymentStatus: $paymentStatus,
    productVariantId: $productVariantId,
    query: $query,
    sortDirection: $sortDirection,
    sortKey: $sortKey,
    status: $status
  ) {
    queryArguments
    campaignOrders {
      ...CampaignOrderConnectionFragment
    }
    crowdfundingCampaigns {
      ...CrowdfundingCampaignConnectionFragment
    }
    presaleCampaigns {
      ...PresaleCampaignConnectionFragment
    }
    subscriptionOrders {
      ...SubscriptionOrderConnectionFragment
    }
    subscriptionPlanGroups {
      ...SubscriptionPlanGroupConnectionFragment
    }
    subscriptions {
      ...SubscriptionConnectionFragment
    }
  }
}
Variables
{
  "campaignId": GlobalID,
  "campaignType": "CROWDFUNDING",
  "customerId": [SharedGlobalID],
  "fulfilmentStatus": ["ALLOCATED"],
  "paymentStatus": ["FAILED"],
  "productVariantId": [SharedGlobalID],
  "query": "xyz789",
  "sortDirection": "ASC",
  "sortKey": "CREATED_AT",
  "status": ["ALLOCATED"]
}
Response
{
  "data": {
    "searchCampaignOrders": {
      "queryArguments": "abc123",
      "campaignOrders": CampaignOrderConnection,
      "crowdfundingCampaigns": CrowdfundingCampaignConnection,
      "presaleCampaigns": PresaleCampaignConnection,
      "subscriptionOrders": SubscriptionOrderConnection,
      "subscriptionPlanGroups": SubscriptionPlanGroupConnection,
      "subscriptions": SubscriptionConnection
    }
  }
}

Mutations

campaignOrderCancel

Description

Cancels a campaign order.

Response

Returns a CampaignOrderCancelPayload

Arguments
Name Description
input - CampaignOrderCancelInput! Input for canceling the campaign order.

Example

Query
mutation campaignOrderCancel($input: CampaignOrderCancelInput!) {
  campaignOrderCancel(input: $input) {
    campaignOrder {
      ...CampaignOrderFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": CampaignOrderCancelInput}
Response
{
  "data": {
    "campaignOrderCancel": {
      "campaignOrder": CampaignOrder,
      "userErrors": [UserError]
    }
  }
}

campaignOrderCreate

Description

Creates a campaign order.

Response

Returns a CampaignOrderCreatePayload

Arguments
Name Description
input - CampaignOrderCreateInput! Input for creating a campaign order.

Example

Query
mutation campaignOrderCreate($input: CampaignOrderCreateInput!) {
  campaignOrderCreate(input: $input) {
    campaignOrder {
      ...CampaignOrderFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": CampaignOrderCreateInput}
Response
{
  "data": {
    "campaignOrderCreate": {
      "campaignOrder": CampaignOrder,
      "userErrors": [UserError]
    }
  }
}

campaignOrderDecreaseQuantity

Description

Decreases quantity on a campaign order.

Arguments
Name Description
input - CampaignOrderDecreaseQuantityInput! Input for updating the campaign order.

Example

Query
mutation campaignOrderDecreaseQuantity($input: CampaignOrderDecreaseQuantityInput!) {
  campaignOrderDecreaseQuantity(input: $input) {
    campaignOrder {
      ...CampaignOrderFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": CampaignOrderDecreaseQuantityInput}
Response
{
  "data": {
    "campaignOrderDecreaseQuantity": {
      "campaignOrder": CampaignOrder,
      "userErrors": [UserError]
    }
  }
}

Objects

CampaignOrder

Description

The order of a Campaign Order Group

Fields
Field Name Description
allocatedQuantity - Int! The allocated quantity.
campaign - Campaign! The parent campaign.
campaignInventoryItem - CampaignInventoryItem The inventory item.
campaignItem - CampaignItem The campaign item.
campaignOrderGroup - CampaignOrderGroup! The campaign order's group.
cancelReason - String The reason for cancellation.
cancelledBy - Persona The originator of the cancellation.
customer - Customer! The campaign order's customer.
financials - CampaignOrderFinancials
fulfilmentStatus - CampaignOrderFulfilmentStatus! The fulfilment status of the order
id - GlobalID! The ID of the campaign order
identifier - String! The campaign order's identifier
milestones - CampaignOrderMilestones
originalQuantity - Int! Original quantity of product in this order
paymentIntent - PaymentIntent The payment intent of the campaign order.
paymentMethod - PaymentMethod The payment method of the campaign order.
paymentStatus - CampaignOrderPaymentStatus The payment status of the campaign order.
product - Product! The product
productVariant - ProductVariant! The product variant
quantity - Int! Quantity of product in this order
sequentialId - Int! The ordered ID of the campaign order.
status - CampaignOrderStatus! The status of the campaign order.
Example
{
  "allocatedQuantity": 987,
  "campaign": CrowdfundingCampaign,
  "campaignInventoryItem": CampaignInventoryItem,
  "campaignItem": CampaignItem,
  "campaignOrderGroup": CampaignOrderGroup,
  "cancelReason": "abc123",
  "cancelledBy": "CUSTOMER",
  "customer": Customer,
  "financials": CampaignOrderFinancials,
  "fulfilmentStatus": "ALLOCATED",
  "id": GlobalID,
  "identifier": "xyz789",
  "milestones": CampaignOrderMilestones,
  "originalQuantity": 123,
  "paymentIntent": PaymentIntent,
  "paymentMethod": PaymentMethod,
  "paymentStatus": "FAILED",
  "product": Product,
  "productVariant": ProductVariant,
  "quantity": 987,
  "sequentialId": 987,
  "status": "ALLOCATED"
}

PaginationResult

Description

The previous and next objects in a connection.

Fields
Field Name Description
queryArguments - String! The query arguments as a JSON string
nextCampaignOrders - CampaignOrderConnection The next campaign orders
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

nextCrowdfundingCampaigns - CrowdfundingCampaignConnection The next crowdfunding campaigns
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

nextPresaleCampaigns - PresaleCampaignConnection The next presale campaigns
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

previousCampaignOrders - CampaignOrderConnection The previous campaign orders
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

previousCrowdfundingCampaigns - CrowdfundingCampaignConnection The previous crowdfunding campaigns
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

previousPresaleCampaigns - PresaleCampaignConnection The previous presale campaigns
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

nextSubscriptionOrders - SubscriptionOrderConnection The next subscription orders
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

nextSubscriptionPlanGroups - SubscriptionPlanGroupConnection The next subscription plan groups
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

nextSubscriptions - SubscriptionConnection The next subscriptions
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

previousSubscriptionOrders - SubscriptionOrderConnection The previous subscription orders
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

previousSubscriptionPlanGroups - SubscriptionPlanGroupConnection The previous subscription plan groups
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

previousSubscriptions - SubscriptionConnection The previous subscriptions
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

Example
{
  "queryArguments": "xyz789",
  "nextCampaignOrders": CampaignOrderConnection,
  "nextCrowdfundingCampaigns": CrowdfundingCampaignConnection,
  "nextPresaleCampaigns": PresaleCampaignConnection,
  "previousCampaignOrders": CampaignOrderConnection,
  "previousCrowdfundingCampaigns": CrowdfundingCampaignConnection,
  "previousPresaleCampaigns": PresaleCampaignConnection,
  "nextSubscriptionOrders": SubscriptionOrderConnection,
  "nextSubscriptionPlanGroups": SubscriptionPlanGroupConnection,
  "nextSubscriptions": SubscriptionConnection,
  "previousSubscriptionOrders": SubscriptionOrderConnection,
  "previousSubscriptionPlanGroups": SubscriptionPlanGroupConnection,
  "previousSubscriptions": SubscriptionConnection
}

SearchResult

Description

A search result.

Fields
Field Name Description
queryArguments - String! The query arguments as a JSON string
campaignOrders - CampaignOrderConnection The matching campaign orders
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

crowdfundingCampaigns - CrowdfundingCampaignConnection The matching crowdfunding campaigns
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

presaleCampaigns - PresaleCampaignConnection The matching presale campaigns
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

subscriptionOrders - SubscriptionOrderConnection
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

subscriptionPlanGroups - SubscriptionPlanGroupConnection
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

subscriptions - SubscriptionConnection
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

Example
{
  "queryArguments": "abc123",
  "campaignOrders": CampaignOrderConnection,
  "crowdfundingCampaigns": CrowdfundingCampaignConnection,
  "presaleCampaigns": PresaleCampaignConnection,
  "subscriptionOrders": SubscriptionOrderConnection,
  "subscriptionPlanGroups": SubscriptionPlanGroupConnection,
  "subscriptions": SubscriptionConnection
}

Campaign Order Groups

Queries

campaignOrderGroup

Description

Find an campaign order group by ID

Response

Returns a CampaignOrderGroup

Arguments
Name Description
id - SharedGlobalID! The campaign order group's ID

Example

Query
query campaignOrderGroup($id: SharedGlobalID!) {
  campaignOrderGroup(id: $id) {
    campaignOrders {
      ...CampaignOrderFragment
    }
    customer {
      ...CustomerFragment
    }
    externalId
    financials {
      ...CampaignOrderGroupFinancialsFragment
    }
    id
    identifier
    lineItemsCount
    milestones {
      ...CampaignOrderGroupMilestonesFragment
    }
    paymentIntent {
      ...PaymentIntentFragment
    }
    paymentMethod {
      ...PaymentMethodFragment
    }
    paymentStatus
    status
  }
}
Variables
{"id": SharedGlobalID}
Response
{
  "data": {
    "campaignOrderGroup": {
      "campaignOrders": [CampaignOrder],
      "customer": Customer,
      "externalId": "xyz789",
      "financials": CampaignOrderGroupFinancials,
      "id": GlobalID,
      "identifier": "xyz789",
      "lineItemsCount": 987,
      "milestones": CampaignOrderGroupMilestones,
      "paymentIntent": PaymentIntent,
      "paymentMethod": PaymentMethod,
      "paymentStatus": "FAILED",
      "status": "ALLOCATED"
    }
  }
}

campaignOrderGroups

Description

List all campaign order groups

Response

Returns a CampaignOrderGroupConnection

Arguments
Name Description
after - String Returns the elements in the list that come after the specified cursor.
before - String Returns the elements in the list that come before the specified cursor.
first - Int Returns the first n elements from the list.
last - Int Returns the last n elements from the list.

Example

Query
query campaignOrderGroups(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int
) {
  campaignOrderGroups(
    after: $after,
    before: $before,
    first: $first,
    last: $last
  ) {
    edges {
      ...CampaignOrderGroupEdgeFragment
    }
    nodes {
      ...CampaignOrderGroupFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
    totalCount
  }
}
Variables
{
  "after": "abc123",
  "before": "abc123",
  "first": 987,
  "last": 123
}
Response
{
  "data": {
    "campaignOrderGroups": {
      "edges": [CampaignOrderGroupEdge],
      "nodes": [CampaignOrderGroup],
      "pageInfo": PageInfo,
      "totalCount": 123
    }
  }
}

Mutations

campaignOrderGroupCancel

Description

Cancels a campaign order group.

Response

Returns a CampaignOrderGroupCancelPayload

Arguments
Name Description
input - CampaignOrderGroupCancelInput! Input for canceling the campaign order group.

Example

Query
mutation campaignOrderGroupCancel($input: CampaignOrderGroupCancelInput!) {
  campaignOrderGroupCancel(input: $input) {
    campaignOrderGroup {
      ...CampaignOrderGroupFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": CampaignOrderGroupCancelInput}
Response
{
  "data": {
    "campaignOrderGroupCancel": {
      "campaignOrderGroup": CampaignOrderGroup,
      "userErrors": [UserError]
    }
  }
}

Objects

CampaignOrderGroup

Description

The group of orders by a customer for a Campaign

Fields
Field Name Description
campaignOrders - [CampaignOrder!]! The campaign order group's orders.
customer - Customer! The campaign order group's customer.
externalId - String! The campaign order group's external ID.
financials - CampaignOrderGroupFinancials
id - GlobalID! The id of the campaign order group
identifier - String! The campaign order group's identifier
lineItemsCount - Int The campaign order group's total count of line items.
milestones - CampaignOrderGroupMilestones
paymentIntent - PaymentIntent The payment intent of the campaign order group.
paymentMethod - PaymentMethod The payment method of the campaign order group.
paymentStatus - CampaignOrderPaymentStatus The payment status of the campaign order group.
status - CampaignOrderGroupStatus! The status of the campaign order group.
Example
{
  "campaignOrders": [CampaignOrder],
  "customer": Customer,
  "externalId": "xyz789",
  "financials": CampaignOrderGroupFinancials,
  "id": GlobalID,
  "identifier": "xyz789",
  "lineItemsCount": 987,
  "milestones": CampaignOrderGroupMilestones,
  "paymentIntent": PaymentIntent,
  "paymentMethod": PaymentMethod,
  "paymentStatus": "FAILED",
  "status": "ALLOCATED"
}

Crowdfunding Campaign

Queries

crowdfundingCampaign

Description

Find a crowdfunding campaign by ID

Response

Returns a CrowdfundingCampaign

Arguments
Name Description
id - GlobalID! The crowdfunding campaign's ID.

Example

Query
query crowdfundingCampaign($id: GlobalID!) {
  crowdfundingCampaign(id: $id) {
    activeCampaignOrdersCount
    allocatedInventoryCount
    allocationStatus
    appliedInventoryCount
    archivedAt
    campaignEndTotalUnits
    campaignEndTotalValue {
      ...MoneyFragment
    }
    campaignInventoryItems {
      ...CampaignInventoryItemFragment
    }
    campaignItemType
    campaignItems {
      ...CampaignItemFragment
    }
    campaignOrders {
      ...CampaignOrderConnectionFragment
    }
    campaignOrdersCount
    campaignRunningTotalUnits
    campaignRunningTotalValue {
      ...MoneyFragment
    }
    cancelledAt
    channel {
      ...ChannelFragment
    }
    completedAt
    createdAt
    currency
    description
    dueAt
    endAt
    endedAt
    fulfilAt
    fulfillingAt
    goal {
      ... on TotalUnitsCrowdfundingGoal {
        ...TotalUnitsCrowdfundingGoalFragment
      }
      ... on TotalValueCrowdfundingGoal {
        ...TotalValueCrowdfundingGoalFragment
      }
    }
    goalProgress
    goalStatus
    gracePeriodHours
    id
    identifier
    inventoryApplications {
      ...InventoryApplicationFragment
    }
    launchAt
    launchedAt
    limit
    name
    productVariants {
      ...ProductVariantFragment
    }
    products {
      ...ProductFragment
    }
    reference
    reservedItemsCount
    sequentialId
    status
    updatedAt
  }
}
Variables
{"id": GlobalID}
Response
{
  "data": {
    "crowdfundingCampaign": {
      "activeCampaignOrdersCount": 123,
      "allocatedInventoryCount": 987,
      "allocationStatus": "ALLOCATED",
      "appliedInventoryCount": 123,
      "archivedAt": ISO8601DateTime,
      "campaignEndTotalUnits": 987,
      "campaignEndTotalValue": Money,
      "campaignInventoryItems": [CampaignInventoryItem],
      "campaignItemType": "PRODUCT",
      "campaignItems": [CampaignItem],
      "campaignOrders": CampaignOrderConnection,
      "campaignOrdersCount": 123,
      "campaignRunningTotalUnits": 987,
      "campaignRunningTotalValue": Money,
      "cancelledAt": ISO8601DateTime,
      "channel": Channel,
      "completedAt": ISO8601DateTime,
      "createdAt": ISO8601DateTime,
      "currency": "AED",
      "description": "xyz789",
      "dueAt": ISO8601DateTime,
      "endAt": ISO8601DateTime,
      "endedAt": ISO8601DateTime,
      "fulfilAt": ISO8601DateTime,
      "fulfillingAt": ISO8601DateTime,
      "goal": TotalUnitsCrowdfundingGoal,
      "goalProgress": 123.45,
      "goalStatus": "FAILED",
      "gracePeriodHours": 987,
      "id": GlobalID,
      "identifier": "xyz789",
      "inventoryApplications": [InventoryApplication],
      "launchAt": ISO8601DateTime,
      "launchedAt": ISO8601DateTime,
      "limit": 123,
      "name": "xyz789",
      "productVariants": [ProductVariant],
      "products": [Product],
      "reference": "abc123",
      "reservedItemsCount": 123,
      "sequentialId": 123,
      "status": "CANCELLED",
      "updatedAt": ISO8601DateTime
    }
  }
}

crowdfundingCampaigns

Description

List all crowdfunding campaigns

Response

Returns a CrowdfundingCampaignConnection

Arguments
Name Description
after - String Returns the elements in the list that come after the specified cursor.
before - String Returns the elements in the list that come before the specified cursor.
first - Int Returns the first n elements from the list.
last - Int Returns the last n elements from the list.

Example

Query
query crowdfundingCampaigns(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int
) {
  crowdfundingCampaigns(
    after: $after,
    before: $before,
    first: $first,
    last: $last
  ) {
    edges {
      ...CrowdfundingCampaignEdgeFragment
    }
    nodes {
      ...CrowdfundingCampaignFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
    totalCount
  }
}
Variables
{
  "after": "abc123",
  "before": "xyz789",
  "first": 987,
  "last": 987
}
Response
{
  "data": {
    "crowdfundingCampaigns": {
      "edges": [CrowdfundingCampaignEdge],
      "nodes": [CrowdfundingCampaign],
      "pageInfo": PageInfo,
      "totalCount": 123
    }
  }
}

searchCrowdfundingCampaigns

Description

Search crowdfunding campaigns

Response

Returns a SearchResult

Arguments
Name Description
allocationStatus - [CampaignAllocationStatus!] The campaign's allocation status.
goalType - [CrowdfundingGoalType!] The campaign's goal type.
isAllocating - Boolean Whether the campaign is allocating.
isArchived - Boolean Whether the campaign is archived.
productIds - [SharedGlobalID!] Return campaigns containing any of these product IDs
productVariantIds - [SharedGlobalID!] Return campaigns containing any of these product variant IDs.
query - String A query string.
sortDirection - SortDirection The sort direction.
sortKey - CrowdfundingCampaignSortKey The key used to sort campaigns.
status - [CampaignStatus!] The campaign's status.

Example

Query
query searchCrowdfundingCampaigns(
  $allocationStatus: [CampaignAllocationStatus!],
  $goalType: [CrowdfundingGoalType!],
  $isAllocating: Boolean,
  $isArchived: Boolean,
  $productIds: [SharedGlobalID!],
  $productVariantIds: [SharedGlobalID!],
  $query: String,
  $sortDirection: SortDirection,
  $sortKey: CrowdfundingCampaignSortKey,
  $status: [CampaignStatus!]
) {
  searchCrowdfundingCampaigns(
    allocationStatus: $allocationStatus,
    goalType: $goalType,
    isAllocating: $isAllocating,
    isArchived: $isArchived,
    productIds: $productIds,
    productVariantIds: $productVariantIds,
    query: $query,
    sortDirection: $sortDirection,
    sortKey: $sortKey,
    status: $status
  ) {
    queryArguments
    campaignOrders {
      ...CampaignOrderConnectionFragment
    }
    crowdfundingCampaigns {
      ...CrowdfundingCampaignConnectionFragment
    }
    presaleCampaigns {
      ...PresaleCampaignConnectionFragment
    }
    subscriptionOrders {
      ...SubscriptionOrderConnectionFragment
    }
    subscriptionPlanGroups {
      ...SubscriptionPlanGroupConnectionFragment
    }
    subscriptions {
      ...SubscriptionConnectionFragment
    }
  }
}
Variables
{
  "allocationStatus": ["ALLOCATED"],
  "goalType": ["TOTAL_UNITS"],
  "isAllocating": false,
  "isArchived": true,
  "productIds": [SharedGlobalID],
  "productVariantIds": [SharedGlobalID],
  "query": "abc123",
  "sortDirection": "ASC",
  "sortKey": "COMPLETED_AT",
  "status": ["CANCELLED"]
}
Response
{
  "data": {
    "searchCrowdfundingCampaigns": {
      "queryArguments": "abc123",
      "campaignOrders": CampaignOrderConnection,
      "crowdfundingCampaigns": CrowdfundingCampaignConnection,
      "presaleCampaigns": PresaleCampaignConnection,
      "subscriptionOrders": SubscriptionOrderConnection,
      "subscriptionPlanGroups": SubscriptionPlanGroupConnection,
      "subscriptions": SubscriptionConnection
    }
  }
}

Mutations

crowdfundingCampaignAddProductVariants

Description

Add product variants to an existing crowdfunding campaign.

Arguments
Name Description
input - CrowdfundingCampaignAddProductVariantsInput! Input for adding product variants to the crowdfunding campaign.

Example

Query
mutation crowdfundingCampaignAddProductVariants($input: CrowdfundingCampaignAddProductVariantsInput!) {
  crowdfundingCampaignAddProductVariants(input: $input) {
    crowdfundingCampaign {
      ...CrowdfundingCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": CrowdfundingCampaignAddProductVariantsInput}
Response
{
  "data": {
    "crowdfundingCampaignAddProductVariants": {
      "crowdfundingCampaign": CrowdfundingCampaign,
      "userErrors": [UserError]
    }
  }
}

crowdfundingCampaignAddProducts

Description

Add products to an existing crowdfunding campaign.

Arguments
Name Description
input - CrowdfundingCampaignAddProductsInput! Input for adding products to the crowdfunding campaign.

Example

Query
mutation crowdfundingCampaignAddProducts($input: CrowdfundingCampaignAddProductsInput!) {
  crowdfundingCampaignAddProducts(input: $input) {
    crowdfundingCampaign {
      ...CrowdfundingCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": CrowdfundingCampaignAddProductsInput}
Response
{
  "data": {
    "crowdfundingCampaignAddProducts": {
      "crowdfundingCampaign": CrowdfundingCampaign,
      "userErrors": [UserError]
    }
  }
}

crowdfundingCampaignApplyBulkInventory

Description

Apply bulk inventory to a crowdfunding campaign

Arguments
Name Description
input - CrowdfundingCampaignApplyBulkInventoryInput! Input for applying bulk inventory.

Example

Query
mutation crowdfundingCampaignApplyBulkInventory($input: CrowdfundingCampaignApplyBulkInventoryInput!) {
  crowdfundingCampaignApplyBulkInventory(input: $input) {
    crowdfundingCampaign {
      ...CrowdfundingCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": CrowdfundingCampaignApplyBulkInventoryInput}
Response
{
  "data": {
    "crowdfundingCampaignApplyBulkInventory": {
      "crowdfundingCampaign": CrowdfundingCampaign,
      "userErrors": [UserError]
    }
  }
}

crowdfundingCampaignApplyInventory

Description

Apply inventory to a crowdfunding campaign

Arguments
Name Description
input - CrowdfundingCampaignApplyInventoryInput! Input for applying inventory.

Example

Query
mutation crowdfundingCampaignApplyInventory($input: CrowdfundingCampaignApplyInventoryInput!) {
  crowdfundingCampaignApplyInventory(input: $input) {
    crowdfundingCampaign {
      ...CrowdfundingCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": CrowdfundingCampaignApplyInventoryInput}
Response
{
  "data": {
    "crowdfundingCampaignApplyInventory": {
      "crowdfundingCampaign": CrowdfundingCampaign,
      "userErrors": [UserError]
    }
  }
}

crowdfundingCampaignCancel

Description

Cancel an existing crowdfunding campaign.

Arguments
Name Description
input - CrowdfundingCampaignCancelInput! Input for Cancelling the crowdfunding campaign.

Example

Query
mutation crowdfundingCampaignCancel($input: CrowdfundingCampaignCancelInput!) {
  crowdfundingCampaignCancel(input: $input) {
    crowdfundingCampaign {
      ...CrowdfundingCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": CrowdfundingCampaignCancelInput}
Response
{
  "data": {
    "crowdfundingCampaignCancel": {
      "crowdfundingCampaign": CrowdfundingCampaign,
      "userErrors": [UserError]
    }
  }
}

crowdfundingCampaignCreate

Description

Create a existing campaign.

Arguments
Name Description
input - CrowdfundingCampaignCreateInput! Input for creating a crowdfunding campaign.

Example

Query
mutation crowdfundingCampaignCreate($input: CrowdfundingCampaignCreateInput!) {
  crowdfundingCampaignCreate(input: $input) {
    crowdfundingCampaign {
      ...CrowdfundingCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": CrowdfundingCampaignCreateInput}
Response
{
  "data": {
    "crowdfundingCampaignCreate": {
      "crowdfundingCampaign": CrowdfundingCampaign,
      "userErrors": [UserError]
    }
  }
}

crowdfundingCampaignDelete

Description

Delete an existing crowdfunding campaign.

Arguments
Name Description
input - CrowdfundingCampaignDeleteInput! Input for deleting the crowdfunding campaign.

Example

Query
mutation crowdfundingCampaignDelete($input: CrowdfundingCampaignDeleteInput!) {
  crowdfundingCampaignDelete(input: $input) {
    deletedCrowdfundingCampaignId
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": CrowdfundingCampaignDeleteInput}
Response
{
  "data": {
    "crowdfundingCampaignDelete": {
      "deletedCrowdfundingCampaignId": GlobalID,
      "userErrors": [UserError]
    }
  }
}

crowdfundingCampaignEnd

Description

End an existing campaign.

Response

Returns a CrowdfundingCampaignEndPayload

Arguments
Name Description
input - CrowdfundingCampaignEndInput! Input for ending the crowdfunding campaign.

Example

Query
mutation crowdfundingCampaignEnd($input: CrowdfundingCampaignEndInput!) {
  crowdfundingCampaignEnd(input: $input) {
    crowdfundingCampaign {
      ...CrowdfundingCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": CrowdfundingCampaignEndInput}
Response
{
  "data": {
    "crowdfundingCampaignEnd": {
      "crowdfundingCampaign": CrowdfundingCampaign,
      "userErrors": [UserError]
    }
  }
}

crowdfundingCampaignFulfil

Description

Fulfil an existing campaign.

Arguments
Name Description
input - CrowdfundingCampaignFulfilInput! Input for fulfilling the crowdfunding campaign.

Example

Query
mutation crowdfundingCampaignFulfil($input: CrowdfundingCampaignFulfilInput!) {
  crowdfundingCampaignFulfil(input: $input) {
    crowdfundingCampaign {
      ...CrowdfundingCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": CrowdfundingCampaignFulfilInput}
Response
{
  "data": {
    "crowdfundingCampaignFulfil": {
      "crowdfundingCampaign": CrowdfundingCampaign,
      "userErrors": [UserError]
    }
  }
}

crowdfundingCampaignLaunch

Description

Launch an existing campaign.

Arguments
Name Description
input - CrowdfundingCampaignLaunchInput! Input for launching the crowdfunding campaign.

Example

Query
mutation crowdfundingCampaignLaunch($input: CrowdfundingCampaignLaunchInput!) {
  crowdfundingCampaignLaunch(input: $input) {
    crowdfundingCampaign {
      ...CrowdfundingCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": CrowdfundingCampaignLaunchInput}
Response
{
  "data": {
    "crowdfundingCampaignLaunch": {
      "crowdfundingCampaign": CrowdfundingCampaign,
      "userErrors": [UserError]
    }
  }
}

crowdfundingCampaignRemoveProductVariants

Description

Removes product variants from an existing crowdfunding campaign.

Arguments
Name Description
input - CrowdfundingCampaignRemoveProductVariantsInput! Input for removing product variants from the crowdfunding campaign.

Example

Query
mutation crowdfundingCampaignRemoveProductVariants($input: CrowdfundingCampaignRemoveProductVariantsInput!) {
  crowdfundingCampaignRemoveProductVariants(input: $input) {
    crowdfundingCampaign {
      ...CrowdfundingCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": CrowdfundingCampaignRemoveProductVariantsInput}
Response
{
  "data": {
    "crowdfundingCampaignRemoveProductVariants": {
      "crowdfundingCampaign": CrowdfundingCampaign,
      "userErrors": [UserError]
    }
  }
}

crowdfundingCampaignRemoveProducts

Description

Removes products from an existing crowdfunding campaign.

Arguments
Name Description
input - CrowdfundingCampaignRemoveProductsInput! Input for removing products from the crowdfunding campaign.

Example

Query
mutation crowdfundingCampaignRemoveProducts($input: CrowdfundingCampaignRemoveProductsInput!) {
  crowdfundingCampaignRemoveProducts(input: $input) {
    crowdfundingCampaign {
      ...CrowdfundingCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": CrowdfundingCampaignRemoveProductsInput}
Response
{
  "data": {
    "crowdfundingCampaignRemoveProducts": {
      "crowdfundingCampaign": CrowdfundingCampaign,
      "userErrors": [UserError]
    }
  }
}

crowdfundingCampaignUpdate

Description

Update an existing campaign.

Arguments
Name Description
input - CrowdfundingCampaignUpdateInput! Input for updating a crowdfunding campaign.

Example

Query
mutation crowdfundingCampaignUpdate($input: CrowdfundingCampaignUpdateInput!) {
  crowdfundingCampaignUpdate(input: $input) {
    crowdfundingCampaign {
      ...CrowdfundingCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": CrowdfundingCampaignUpdateInput}
Response
{
  "data": {
    "crowdfundingCampaignUpdate": {
      "crowdfundingCampaign": CrowdfundingCampaign,
      "userErrors": [UserError]
    }
  }
}

Objects

CrowdfundingCampaign

Description

A Platform crowdfunding campaign

Fields
Field Name Description
activeCampaignOrdersCount - Int! The campaign's total count of active orders.
allocatedInventoryCount - Int! The campaign's count of inventory allocated.
allocationStatus - CampaignAllocationStatus! The allocation status of the campaign.
appliedInventoryCount - Int! The total amount of inventory currently applied to the campaign.
archivedAt - ISO8601DateTime The date the campaign was archived.
campaignEndTotalUnits - Int The campaign's total units when the campaign ends.
campaignEndTotalValue - Money The campaign's total value when the campaign ends.
campaignInventoryItems - [CampaignInventoryItem!]! The campaign's inventory items.
campaignItemType - CampaignItemType! The type of items in the campaign.
campaignItems - [CampaignItem!]! The campaign's items.
campaignOrders - CampaignOrderConnection! The campaign's orders.
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

campaignOrdersCount - Int! The campaign's total count of orders.
campaignRunningTotalUnits - Int The campaign's running total units.
campaignRunningTotalValue - Money The campaign's running total value.
cancelledAt - ISO8601DateTime The date the crowdfunding campaign was cancelled.
channel - Channel! The crowdfunding campaign's channel.
completedAt - ISO8601DateTime The date the crowdfunding campaign completed.
createdAt - ISO8601DateTime The date the crowdfunding campaign was created.
currency - CurrencyCode! The campaign currency.
description - String! The campaign description.
Arguments
interpolate - Boolean

Whether to replace the description's placeholders with actual values.

dueAt - ISO8601DateTime! The date the payment for the crowdfunding campaign is due.
endAt - ISO8601DateTime! The date the campaign will end
endedAt - ISO8601DateTime The date the crowdfunding campaign ended.
fulfilAt - ISO8601DateTime The date the campaign will be fulfilled
fulfillingAt - ISO8601DateTime The date the crowdfunding campaign started fulfilling.
goal - CrowdfundingGoal! The campaign's goal.
goalProgress - Float! The campaign's goal progress percentage.
goalStatus - CrowdfundingGoalStatus! The campaign's goal status.
gracePeriodHours - Int! The number of hours a customer has to rectify a failed campaign payment before their campaign order is cancelled.
id - GlobalID! The ID of the campaign
identifier - String! The identifier of the campaign.
inventoryApplications - [InventoryApplication!]! The campaign's inventory applications.
launchAt - ISO8601DateTime! The date the campaign will be launched
launchedAt - ISO8601DateTime The date the crowdfunding campaign launched.
limit - Int The maximum number of units of the linked products that can be sold
name - String! The name of the campaign.
Arguments
interpolate - Boolean

Whether to replace the name's placeholders with actual values.

productVariants - [ProductVariant!] The product IDs that are included in the campaign.
products - [Product!] The product IDs that are included in the campaign.
reference - String! The campaign reference.
reservedItemsCount - Int! The campaign's total count of reserved items.
sequentialId - Int! The ordered ID of the campaign.
status - CampaignStatus! The campaign's status (eg. active).
updatedAt - ISO8601DateTime The date the presale was last updated.
Example
{
  "activeCampaignOrdersCount": 123,
  "allocatedInventoryCount": 987,
  "allocationStatus": "ALLOCATED",
  "appliedInventoryCount": 987,
  "archivedAt": ISO8601DateTime,
  "campaignEndTotalUnits": 987,
  "campaignEndTotalValue": Money,
  "campaignInventoryItems": [CampaignInventoryItem],
  "campaignItemType": "PRODUCT",
  "campaignItems": [CampaignItem],
  "campaignOrders": CampaignOrderConnection,
  "campaignOrdersCount": 123,
  "campaignRunningTotalUnits": 123,
  "campaignRunningTotalValue": Money,
  "cancelledAt": ISO8601DateTime,
  "channel": Channel,
  "completedAt": ISO8601DateTime,
  "createdAt": ISO8601DateTime,
  "currency": "AED",
  "description": "abc123",
  "dueAt": ISO8601DateTime,
  "endAt": ISO8601DateTime,
  "endedAt": ISO8601DateTime,
  "fulfilAt": ISO8601DateTime,
  "fulfillingAt": ISO8601DateTime,
  "goal": TotalUnitsCrowdfundingGoal,
  "goalProgress": 123.45,
  "goalStatus": "FAILED",
  "gracePeriodHours": 123,
  "id": GlobalID,
  "identifier": "abc123",
  "inventoryApplications": [InventoryApplication],
  "launchAt": ISO8601DateTime,
  "launchedAt": ISO8601DateTime,
  "limit": 123,
  "name": "abc123",
  "productVariants": [ProductVariant],
  "products": [Product],
  "reference": "abc123",
  "reservedItemsCount": 123,
  "sequentialId": 123,
  "status": "CANCELLED",
  "updatedAt": ISO8601DateTime
}

SearchResult

Description

A search result.

Fields
Field Name Description
queryArguments - String! The query arguments as a JSON string
campaignOrders - CampaignOrderConnection The matching campaign orders
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

crowdfundingCampaigns - CrowdfundingCampaignConnection The matching crowdfunding campaigns
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

presaleCampaigns - PresaleCampaignConnection The matching presale campaigns
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

subscriptionOrders - SubscriptionOrderConnection
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

subscriptionPlanGroups - SubscriptionPlanGroupConnection
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

subscriptions - SubscriptionConnection
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

Example
{
  "queryArguments": "xyz789",
  "campaignOrders": CampaignOrderConnection,
  "crowdfundingCampaigns": CrowdfundingCampaignConnection,
  "presaleCampaigns": PresaleCampaignConnection,
  "subscriptionOrders": SubscriptionOrderConnection,
  "subscriptionPlanGroups": SubscriptionPlanGroupConnection,
  "subscriptions": SubscriptionConnection
}

Presale Campaign

Queries

presaleCampaign

Description

Find a presale campaign by ID

Response

Returns a PresaleCampaign

Arguments
Name Description
id - GlobalID! The presale campaign's ID.

Example

Query
query presaleCampaign($id: GlobalID!) {
  presaleCampaign(id: $id) {
    activeCampaignOrdersCount
    allocatedInventoryCount
    allocationStatus
    appliedInventoryCount
    archivedAt
    campaignInventoryItems {
      ...CampaignInventoryItemFragment
    }
    campaignItemType
    campaignItems {
      ...CampaignItemFragment
    }
    campaignOrders {
      ...CampaignOrderConnectionFragment
    }
    campaignOrdersCount
    cancelledAt
    channel {
      ...ChannelFragment
    }
    completedAt
    createdAt
    deposit {
      ...CampaignDepositFragment
    }
    description
    dueAt
    endAt
    endedAt
    fulfilAt
    fulfillingAt
    gracePeriodHours
    id
    identifier
    inventoryApplications {
      ...InventoryApplicationFragment
    }
    launchAt
    launchedAt
    limit
    name
    productVariants {
      ...ProductVariantFragment
    }
    products {
      ...ProductFragment
    }
    reference
    reservedItemsCount
    sequentialId
    status
    updatedAt
  }
}
Variables
{"id": GlobalID}
Response
{
  "data": {
    "presaleCampaign": {
      "activeCampaignOrdersCount": 123,
      "allocatedInventoryCount": 987,
      "allocationStatus": "ALLOCATED",
      "appliedInventoryCount": 123,
      "archivedAt": ISO8601DateTime,
      "campaignInventoryItems": [CampaignInventoryItem],
      "campaignItemType": "PRODUCT",
      "campaignItems": [CampaignItem],
      "campaignOrders": CampaignOrderConnection,
      "campaignOrdersCount": 123,
      "cancelledAt": ISO8601DateTime,
      "channel": Channel,
      "completedAt": ISO8601DateTime,
      "createdAt": ISO8601DateTime,
      "deposit": CampaignDeposit,
      "description": "You will be charged the remaining balance when the product is released.",
      "dueAt": ISO8601DateTime,
      "endAt": ISO8601DateTime,
      "endedAt": ISO8601DateTime,
      "fulfilAt": ISO8601DateTime,
      "fulfillingAt": ISO8601DateTime,
      "gracePeriodHours": 123,
      "id": GlobalID,
      "identifier": "xyz789",
      "inventoryApplications": [InventoryApplication],
      "launchAt": ISO8601DateTime,
      "launchedAt": ISO8601DateTime,
      "limit": 987,
      "name": "June Pre-order for Product.",
      "productVariants": [ProductVariant],
      "products": [Product],
      "reference": "Pre-order June Product #REF-021",
      "reservedItemsCount": 987,
      "sequentialId": 123,
      "status": "CANCELLED",
      "updatedAt": ISO8601DateTime
    }
  }
}

presaleCampaigns

Description

List all presale campaigns

Response

Returns a PresaleCampaignConnection

Arguments
Name Description
after - String Returns the elements in the list that come after the specified cursor.
before - String Returns the elements in the list that come before the specified cursor.
first - Int Returns the first n elements from the list.
last - Int Returns the last n elements from the list.

Example

Query
query presaleCampaigns(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int
) {
  presaleCampaigns(
    after: $after,
    before: $before,
    first: $first,
    last: $last
  ) {
    edges {
      ...PresaleCampaignEdgeFragment
    }
    nodes {
      ...PresaleCampaignFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
    totalCount
  }
}
Variables
{
  "after": "abc123",
  "before": "abc123",
  "first": 123,
  "last": 123
}
Response
{
  "data": {
    "presaleCampaigns": {
      "edges": [PresaleCampaignEdge],
      "nodes": [PresaleCampaign],
      "pageInfo": PageInfo,
      "totalCount": 123
    }
  }
}

searchPresaleCampaigns

Description

Search presale campaigns

Response

Returns a SearchResult

Arguments
Name Description
allocationStatus - [CampaignAllocationStatus!] The campaign's allocation status.
isAllocating - Boolean Whether the campaign is allocating.
isArchived - Boolean Whether the campaign is archived.
productIds - [SharedGlobalID!] Return campaigns containing any of these product IDs
productVariantIds - [SharedGlobalID!] Return campaigns containing any of these product variant IDs.
query - String A query string.
sortDirection - SortDirection The sort direction.
sortKey - PresaleCampaignSortKey The key used to sort campaigns.
status - [CampaignStatus!] The campaign's status.

Example

Query
query searchPresaleCampaigns(
  $allocationStatus: [CampaignAllocationStatus!],
  $isAllocating: Boolean,
  $isArchived: Boolean,
  $productIds: [SharedGlobalID!],
  $productVariantIds: [SharedGlobalID!],
  $query: String,
  $sortDirection: SortDirection,
  $sortKey: PresaleCampaignSortKey,
  $status: [CampaignStatus!]
) {
  searchPresaleCampaigns(
    allocationStatus: $allocationStatus,
    isAllocating: $isAllocating,
    isArchived: $isArchived,
    productIds: $productIds,
    productVariantIds: $productVariantIds,
    query: $query,
    sortDirection: $sortDirection,
    sortKey: $sortKey,
    status: $status
  ) {
    queryArguments
    campaignOrders {
      ...CampaignOrderConnectionFragment
    }
    crowdfundingCampaigns {
      ...CrowdfundingCampaignConnectionFragment
    }
    presaleCampaigns {
      ...PresaleCampaignConnectionFragment
    }
    subscriptionOrders {
      ...SubscriptionOrderConnectionFragment
    }
    subscriptionPlanGroups {
      ...SubscriptionPlanGroupConnectionFragment
    }
    subscriptions {
      ...SubscriptionConnectionFragment
    }
  }
}
Variables
{
  "allocationStatus": ["ALLOCATED"],
  "isAllocating": false,
  "isArchived": false,
  "productIds": [SharedGlobalID],
  "productVariantIds": [SharedGlobalID],
  "query": "xyz789",
  "sortDirection": "ASC",
  "sortKey": "COMPLETED_AT",
  "status": ["CANCELLED"]
}
Response
{
  "data": {
    "searchPresaleCampaigns": {
      "queryArguments": "xyz789",
      "campaignOrders": CampaignOrderConnection,
      "crowdfundingCampaigns": CrowdfundingCampaignConnection,
      "presaleCampaigns": PresaleCampaignConnection,
      "subscriptionOrders": SubscriptionOrderConnection,
      "subscriptionPlanGroups": SubscriptionPlanGroupConnection,
      "subscriptions": SubscriptionConnection
    }
  }
}

Mutations

presaleCampaignAddProductVariants

Description

Add product variants to an existing campaign.

Arguments
Name Description
input - PresaleCampaignAddProductVariantsInput! Input for adding product variants to the presale campaign.

Example

Query
mutation presaleCampaignAddProductVariants($input: PresaleCampaignAddProductVariantsInput!) {
  presaleCampaignAddProductVariants(input: $input) {
    presaleCampaign {
      ...PresaleCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PresaleCampaignAddProductVariantsInput}
Response
{
  "data": {
    "presaleCampaignAddProductVariants": {
      "presaleCampaign": PresaleCampaign,
      "userErrors": [UserError]
    }
  }
}

presaleCampaignAddProducts

Description

Add products to an existing campaign.

Arguments
Name Description
input - PresaleCampaignAddProductsInput! Input for adding products to the presale campaign.

Example

Query
mutation presaleCampaignAddProducts($input: PresaleCampaignAddProductsInput!) {
  presaleCampaignAddProducts(input: $input) {
    presaleCampaign {
      ...PresaleCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PresaleCampaignAddProductsInput}
Response
{
  "data": {
    "presaleCampaignAddProducts": {
      "presaleCampaign": PresaleCampaign,
      "userErrors": [UserError]
    }
  }
}

presaleCampaignApplyBulkInventory

Description

Apply bulk inventory to a presale campaign

Arguments
Name Description
input - PresaleCampaignApplyBulkInventoryInput! Input for applying bulk inventory.

Example

Query
mutation presaleCampaignApplyBulkInventory($input: PresaleCampaignApplyBulkInventoryInput!) {
  presaleCampaignApplyBulkInventory(input: $input) {
    presaleCampaign {
      ...PresaleCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PresaleCampaignApplyBulkInventoryInput}
Response
{
  "data": {
    "presaleCampaignApplyBulkInventory": {
      "presaleCampaign": PresaleCampaign,
      "userErrors": [UserError]
    }
  }
}

presaleCampaignApplyInventory

Description

Apply inventory to a presale campaign

Arguments
Name Description
input - PresaleCampaignApplyInventoryInput! Input for applying inventory.

Example

Query
mutation presaleCampaignApplyInventory($input: PresaleCampaignApplyInventoryInput!) {
  presaleCampaignApplyInventory(input: $input) {
    presaleCampaign {
      ...PresaleCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PresaleCampaignApplyInventoryInput}
Response
{
  "data": {
    "presaleCampaignApplyInventory": {
      "presaleCampaign": PresaleCampaign,
      "userErrors": [UserError]
    }
  }
}

presaleCampaignCancel

Description

Cancel an existing presale campaign.

Response

Returns a PresaleCampaignCancelPayload

Arguments
Name Description
input - PresaleCampaignCancelInput! Input for cancelling the presale campaign.

Example

Query
mutation presaleCampaignCancel($input: PresaleCampaignCancelInput!) {
  presaleCampaignCancel(input: $input) {
    presaleCampaign {
      ...PresaleCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PresaleCampaignCancelInput}
Response
{
  "data": {
    "presaleCampaignCancel": {
      "presaleCampaign": PresaleCampaign,
      "userErrors": [UserError]
    }
  }
}

presaleCampaignCreate

Description

Create a new presale campaign.

Response

Returns a PresaleCampaignCreatePayload

Arguments
Name Description
input - PresaleCampaignCreateInput! Input for creating a presale campaign.

Example

Query
mutation presaleCampaignCreate($input: PresaleCampaignCreateInput!) {
  presaleCampaignCreate(input: $input) {
    presaleCampaign {
      ...PresaleCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PresaleCampaignCreateInput}
Response
{
  "data": {
    "presaleCampaignCreate": {
      "presaleCampaign": PresaleCampaign,
      "userErrors": [UserError]
    }
  }
}

presaleCampaignDelete

Description

Delete an existing presale campaign.

Response

Returns a PresaleCampaignDeletePayload

Arguments
Name Description
input - PresaleCampaignDeleteInput! Input for deleting the presale campaign.

Example

Query
mutation presaleCampaignDelete($input: PresaleCampaignDeleteInput!) {
  presaleCampaignDelete(input: $input) {
    deletedPresaleCampaignId
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PresaleCampaignDeleteInput}
Response
{
  "data": {
    "presaleCampaignDelete": {
      "deletedPresaleCampaignId": GlobalID,
      "userErrors": [UserError]
    }
  }
}

presaleCampaignEnd

Description

End an existing campaign.

Response

Returns a PresaleCampaignEndPayload

Arguments
Name Description
input - PresaleCampaignEndInput! Input for ending the presale campaign.

Example

Query
mutation presaleCampaignEnd($input: PresaleCampaignEndInput!) {
  presaleCampaignEnd(input: $input) {
    presaleCampaign {
      ...PresaleCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PresaleCampaignEndInput}
Response
{
  "data": {
    "presaleCampaignEnd": {
      "presaleCampaign": PresaleCampaign,
      "userErrors": [UserError]
    }
  }
}

presaleCampaignFulfil

Description

Fulfil an existing campaign.

Response

Returns a PresaleCampaignFulfilPayload

Arguments
Name Description
input - PresaleCampaignFulfilInput! Input for fulfilling the presale campaign.

Example

Query
mutation presaleCampaignFulfil($input: PresaleCampaignFulfilInput!) {
  presaleCampaignFulfil(input: $input) {
    presaleCampaign {
      ...PresaleCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PresaleCampaignFulfilInput}
Response
{
  "data": {
    "presaleCampaignFulfil": {
      "presaleCampaign": PresaleCampaign,
      "userErrors": [UserError]
    }
  }
}

presaleCampaignLaunch

Description

Launch an existing campaign.

Response

Returns a PresaleCampaignLaunchPayload

Arguments
Name Description
input - PresaleCampaignLaunchInput! Input for launching the presale campaign.

Example

Query
mutation presaleCampaignLaunch($input: PresaleCampaignLaunchInput!) {
  presaleCampaignLaunch(input: $input) {
    presaleCampaign {
      ...PresaleCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PresaleCampaignLaunchInput}
Response
{
  "data": {
    "presaleCampaignLaunch": {
      "presaleCampaign": PresaleCampaign,
      "userErrors": [UserError]
    }
  }
}

presaleCampaignRemoveProductVariants

Description

Remove product variants from presale campaign

Arguments
Name Description
input - PresaleCampaignRemoveProductVariantsInput! Input for removing product variants from the presale campaign.

Example

Query
mutation presaleCampaignRemoveProductVariants($input: PresaleCampaignRemoveProductVariantsInput!) {
  presaleCampaignRemoveProductVariants(input: $input) {
    presaleCampaign {
      ...PresaleCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PresaleCampaignRemoveProductVariantsInput}
Response
{
  "data": {
    "presaleCampaignRemoveProductVariants": {
      "presaleCampaign": PresaleCampaign,
      "userErrors": [UserError]
    }
  }
}

presaleCampaignRemoveProducts

Description

Remove products from presale campaign

Arguments
Name Description
input - PresaleCampaignRemoveProductsInput! Input for removing products from the presale campaign.

Example

Query
mutation presaleCampaignRemoveProducts($input: PresaleCampaignRemoveProductsInput!) {
  presaleCampaignRemoveProducts(input: $input) {
    presaleCampaign {
      ...PresaleCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PresaleCampaignRemoveProductsInput}
Response
{
  "data": {
    "presaleCampaignRemoveProducts": {
      "presaleCampaign": PresaleCampaign,
      "userErrors": [UserError]
    }
  }
}

presaleCampaignUpdate

Description

Update a new presale campaign.

Response

Returns a PresaleCampaignUpdatePayload

Arguments
Name Description
input - PresaleCampaignUpdateInput! Input for updating the presale campaign.

Example

Query
mutation presaleCampaignUpdate($input: PresaleCampaignUpdateInput!) {
  presaleCampaignUpdate(input: $input) {
    presaleCampaign {
      ...PresaleCampaignFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": PresaleCampaignUpdateInput}
Response
{
  "data": {
    "presaleCampaignUpdate": {
      "presaleCampaign": PresaleCampaign,
      "userErrors": [UserError]
    }
  }
}

Objects

PresaleCampaign

Description

A Platform campaign of type Presale.

Fields
Field Name Description
activeCampaignOrdersCount - Int! The campaign's total count of active orders.
allocatedInventoryCount - Int! The campaign's count of inventory allocated.
allocationStatus - CampaignAllocationStatus! The allocation status of the campaign.
appliedInventoryCount - Int! The total amount of inventory currently applied to the campaign.
archivedAt - ISO8601DateTime The date the campaign was archived.
campaignInventoryItems - [CampaignInventoryItem!]! The campaign's inventory items.
campaignItemType - CampaignItemType! The type of items in the campaign.
campaignItems - [CampaignItem!]! The campaign's items.
campaignOrders - CampaignOrderConnection! The campaign's orders.
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

campaignOrdersCount - Int! The campaign's total count of orders.
cancelledAt - ISO8601DateTime The date the presale was cancelled.
channel - Channel! The presale campaign's channel.
completedAt - ISO8601DateTime The date the presale completed.
createdAt - ISO8601DateTime The date the presale created.
deposit - CampaignDeposit The amount to be collected at checkout.
description - String! The campaign description.
Arguments
interpolate - Boolean

Whether to replace the description's placeholders with actual values.

dueAt - ISO8601DateTime! The date the payment for the presale is due.
endAt - ISO8601DateTime! The date the presale will end.
endedAt - ISO8601DateTime The date the presale ended.
fulfilAt - ISO8601DateTime The date the presale will be fulfilled.
fulfillingAt - ISO8601DateTime The date the presale started fulfilling.
gracePeriodHours - Int! The number of hours a customer has to rectify a failed presale campaign payment before their campaign order is cancelled.
id - GlobalID! The ID of the campaign.
identifier - String! The identifier of the campaign.
inventoryApplications - [InventoryApplication!]! The campaign's inventory applications.
launchAt - ISO8601DateTime! The date the presale will be launched.
launchedAt - ISO8601DateTime The date the presale launched.
limit - Int! The maximum number of units of the linked products that can be sold.
name - String! The name of the campaign.
Arguments
interpolate - Boolean

Whether to replace the name's placeholders with actual values.

productVariants - [ProductVariant!] The product IDs that are included in the campaign.
products - [Product!] The product IDs that are included in the campaign.
reference - String! The campaign reference.
reservedItemsCount - Int! The campaign's total count of reserved items.
sequentialId - Int! The ordered ID of the campaign.
status - CampaignStatus! The campaign's status.
updatedAt - ISO8601DateTime The date the presale was last updated.
Example
{
  "activeCampaignOrdersCount": 123,
  "allocatedInventoryCount": 987,
  "allocationStatus": "ALLOCATED",
  "appliedInventoryCount": 123,
  "archivedAt": ISO8601DateTime,
  "campaignInventoryItems": [CampaignInventoryItem],
  "campaignItemType": "PRODUCT",
  "campaignItems": [CampaignItem],
  "campaignOrders": CampaignOrderConnection,
  "campaignOrdersCount": 987,
  "cancelledAt": ISO8601DateTime,
  "channel": Channel,
  "completedAt": ISO8601DateTime,
  "createdAt": ISO8601DateTime,
  "deposit": CampaignDeposit,
  "description": "You will be charged the remaining balance when the product is released.",
  "dueAt": ISO8601DateTime,
  "endAt": ISO8601DateTime,
  "endedAt": ISO8601DateTime,
  "fulfilAt": ISO8601DateTime,
  "fulfillingAt": ISO8601DateTime,
  "gracePeriodHours": 123,
  "id": GlobalID,
  "identifier": "abc123",
  "inventoryApplications": [InventoryApplication],
  "launchAt": ISO8601DateTime,
  "launchedAt": ISO8601DateTime,
  "limit": 987,
  "name": "June Pre-order for Product.",
  "productVariants": [ProductVariant],
  "products": [Product],
  "reference": "Pre-order June Product #REF-021",
  "reservedItemsCount": 987,
  "sequentialId": 123,
  "status": "CANCELLED",
  "updatedAt": ISO8601DateTime
}

SearchResult

Description

A search result.

Fields
Field Name Description
queryArguments - String! The query arguments as a JSON string
campaignOrders - CampaignOrderConnection The matching campaign orders
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

crowdfundingCampaigns - CrowdfundingCampaignConnection The matching crowdfunding campaigns
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

presaleCampaigns - PresaleCampaignConnection The matching presale campaigns
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

subscriptionOrders - SubscriptionOrderConnection
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

subscriptionPlanGroups - SubscriptionPlanGroupConnection
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

subscriptions - SubscriptionConnection
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

Example
{
  "queryArguments": "xyz789",
  "campaignOrders": CampaignOrderConnection,
  "crowdfundingCampaigns": CrowdfundingCampaignConnection,
  "presaleCampaigns": PresaleCampaignConnection,
  "subscriptionOrders": SubscriptionOrderConnection,
  "subscriptionPlanGroups": SubscriptionPlanGroupConnection,
  "subscriptions": SubscriptionConnection
}

Subscription Planning

Queries

subscriptionPlanGroup

Description

Find an subscription plan group by ID.

Response

Returns a SubscriptionPlanGroup

Arguments
Name Description
id - GlobalID! The subscription plan group's ID.

Example

Query
query subscriptionPlanGroup($id: GlobalID!) {
  subscriptionPlanGroup(id: $id) {
    billingBehaviour {
      ...SubscriptionBillingBehaviourFragment
    }
    channel {
      ...ChannelFragment
    }
    createdAt
    deliveryBehaviour {
      ...SubscriptionDeliveryBehaviourFragment
    }
    id
    identifier
    inventoryBehaviour {
      ...SubscriptionInventoryBehaviourFragment
    }
    name
    pricingBehaviour {
      ...SubscriptionPricingBehaviourFragment
    }
    productGroup {
      ...SubscriptionProductGroupFragment
    }
    reference
    status
    subscriptionPlans {
      ...SubscriptionPlanFragment
    }
    subscriptionPlansCount
    subscriptionsCount
    updatedAt
  }
}
Variables
{"id": GlobalID}
Response
{
  "data": {
    "subscriptionPlanGroup": {
      "billingBehaviour": SubscriptionBillingBehaviour,
      "channel": Channel,
      "createdAt": ISO8601DateTime,
      "deliveryBehaviour": SubscriptionDeliveryBehaviour,
      "id": GlobalID,
      "identifier": "xyz789",
      "inventoryBehaviour": SubscriptionInventoryBehaviour,
      "name": "xyz789",
      "pricingBehaviour": SubscriptionPricingBehaviour,
      "productGroup": SubscriptionProductGroup,
      "reference": "abc123",
      "status": "ACTIVE",
      "subscriptionPlans": [SubscriptionPlan],
      "subscriptionPlansCount": Count,
      "subscriptionsCount": Count,
      "updatedAt": ISO8601DateTime
    }
  }
}

subscriptionPlanGroups

Description

List all subscription plan groups.

Response

Returns a SubscriptionPlanGroupConnection

Arguments
Name Description
after - String Returns the elements in the list that come after the specified cursor.
before - String Returns the elements in the list that come before the specified cursor.
first - Int Returns the first n elements from the list.
last - Int Returns the last n elements from the list.

Example

Query
query subscriptionPlanGroups(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int
) {
  subscriptionPlanGroups(
    after: $after,
    before: $before,
    first: $first,
    last: $last
  ) {
    edges {
      ...SubscriptionPlanGroupEdgeFragment
    }
    nodes {
      ...SubscriptionPlanGroupFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
    totalCount
  }
}
Variables
{
  "after": "xyz789",
  "before": "xyz789",
  "first": 987,
  "last": 987
}
Response
{
  "data": {
    "subscriptionPlanGroups": {
      "edges": [SubscriptionPlanGroupEdge],
      "nodes": [SubscriptionPlanGroup],
      "pageInfo": PageInfo,
      "totalCount": 987
    }
  }
}

Mutations

subscriptionPlanGroupCreate

Description

Creates a subscription plan group.

Arguments
Name Description
input - SubscriptionPlanGroupCreateInput! Input for creating a subscription plan group.

Example

Query
mutation subscriptionPlanGroupCreate($input: SubscriptionPlanGroupCreateInput!) {
  subscriptionPlanGroupCreate(input: $input) {
    subscriptionPlanGroup {
      ...SubscriptionPlanGroupFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": SubscriptionPlanGroupCreateInput}
Response
{
  "data": {
    "subscriptionPlanGroupCreate": {
      "subscriptionPlanGroup": SubscriptionPlanGroup,
      "userErrors": [UserError]
    }
  }
}

Objects

SubscriptionPlanGroup

Fields
Field Name Description
billingBehaviour - SubscriptionBillingBehaviour!
channel - Channel! The subscription plan group's channel.
createdAt - ISO8601DateTime The date the subscription plan group was created.
deliveryBehaviour - SubscriptionDeliveryBehaviour!
id - GlobalID! The ID of the subscription plan group
identifier - String!
inventoryBehaviour - SubscriptionInventoryBehaviour!
name - String! The name of the subscription plan group.
pricingBehaviour - SubscriptionPricingBehaviour!
productGroup - SubscriptionProductGroup!
reference - String! The subscription plan group reference.
status - SubscriptionPlanGroupStatus! The subscription plan group's status.
subscriptionPlans - [SubscriptionPlan!]!
subscriptionPlansCount - Count!
subscriptionsCount - Count!
updatedAt - ISO8601DateTime The date the subscription plan group was last updated.
Example
{
  "billingBehaviour": SubscriptionBillingBehaviour,
  "channel": Channel,
  "createdAt": ISO8601DateTime,
  "deliveryBehaviour": SubscriptionDeliveryBehaviour,
  "id": GlobalID,
  "identifier": "abc123",
  "inventoryBehaviour": SubscriptionInventoryBehaviour,
  "name": "abc123",
  "pricingBehaviour": SubscriptionPricingBehaviour,
  "productGroup": SubscriptionProductGroup,
  "reference": "abc123",
  "status": "ACTIVE",
  "subscriptionPlans": [SubscriptionPlan],
  "subscriptionPlansCount": Count,
  "subscriptionsCount": Count,
  "updatedAt": ISO8601DateTime
}

Subscriptions

Queries

searchSubscriptionOrders

Description

Search subscriptions

Response

Returns a SearchResult

Arguments
Name Description
customerIds - [SharedGlobalID!]
paymentStatus - [SubscriptionOrderPaymentStatus!]
query - String A query string.
sortDirection - SortDirection The sort direction.
sortKey - SubscriptionOrderSortKey
status - [SubscriptionOrderStatus!] The subscription order's status.
subscriptionId - GlobalID
subscriptionPlanId - GlobalID

Example

Query
query searchSubscriptionOrders(
  $customerIds: [SharedGlobalID!],
  $paymentStatus: [SubscriptionOrderPaymentStatus!],
  $query: String,
  $sortDirection: SortDirection,
  $sortKey: SubscriptionOrderSortKey,
  $status: [SubscriptionOrderStatus!],
  $subscriptionId: GlobalID,
  $subscriptionPlanId: GlobalID
) {
  searchSubscriptionOrders(
    customerIds: $customerIds,
    paymentStatus: $paymentStatus,
    query: $query,
    sortDirection: $sortDirection,
    sortKey: $sortKey,
    status: $status,
    subscriptionId: $subscriptionId,
    subscriptionPlanId: $subscriptionPlanId
  ) {
    queryArguments
    campaignOrders {
      ...CampaignOrderConnectionFragment
    }
    crowdfundingCampaigns {
      ...CrowdfundingCampaignConnectionFragment
    }
    presaleCampaigns {
      ...PresaleCampaignConnectionFragment
    }
    subscriptionOrders {
      ...SubscriptionOrderConnectionFragment
    }
    subscriptionPlanGroups {
      ...SubscriptionPlanGroupConnectionFragment
    }
    subscriptions {
      ...SubscriptionConnectionFragment
    }
  }
}
Variables
{
  "customerIds": [SharedGlobalID],
  "paymentStatus": ["FAILED"],
  "query": "abc123",
  "sortDirection": "ASC",
  "sortKey": "CYCLE_INDEX",
  "status": ["CANCELLED"],
  "subscriptionId": GlobalID,
  "subscriptionPlanId": GlobalID
}
Response
{
  "data": {
    "searchSubscriptionOrders": {
      "queryArguments": "abc123",
      "campaignOrders": CampaignOrderConnection,
      "crowdfundingCampaigns": CrowdfundingCampaignConnection,
      "presaleCampaigns": PresaleCampaignConnection,
      "subscriptionOrders": SubscriptionOrderConnection,
      "subscriptionPlanGroups": SubscriptionPlanGroupConnection,
      "subscriptions": SubscriptionConnection
    }
  }
}

searchSubscriptionPlanGroups

Description

Search subscription plan groups

Response

Returns a SearchResult

Arguments
Name Description
productIds - [SharedGlobalID!] Return only subscription plan groups for these variants.
productVariantIds - [SharedGlobalID!] Return only subscription plan groups for these variants.
query - String A query string.
sortDirection - SortDirection The sort direction.
sortKey - SubscriptionPlanGroupSortKey
status - [SubscriptionPlanGroupStatus!] The subscription plan group's status.

Example

Query
query searchSubscriptionPlanGroups(
  $productIds: [SharedGlobalID!],
  $productVariantIds: [SharedGlobalID!],
  $query: String,
  $sortDirection: SortDirection,
  $sortKey: SubscriptionPlanGroupSortKey,
  $status: [SubscriptionPlanGroupStatus!]
) {
  searchSubscriptionPlanGroups(
    productIds: $productIds,
    productVariantIds: $productVariantIds,
    query: $query,
    sortDirection: $sortDirection,
    sortKey: $sortKey,
    status: $status
  ) {
    queryArguments
    campaignOrders {
      ...CampaignOrderConnectionFragment
    }
    crowdfundingCampaigns {
      ...CrowdfundingCampaignConnectionFragment
    }
    presaleCampaigns {
      ...PresaleCampaignConnectionFragment
    }
    subscriptionOrders {
      ...SubscriptionOrderConnectionFragment
    }
    subscriptionPlanGroups {
      ...SubscriptionPlanGroupConnectionFragment
    }
    subscriptions {
      ...SubscriptionConnectionFragment
    }
  }
}
Variables
{
  "productIds": [SharedGlobalID],
  "productVariantIds": [SharedGlobalID],
  "query": "xyz789",
  "sortDirection": "ASC",
  "sortKey": "CREATED_AT",
  "status": ["ACTIVE"]
}
Response
{
  "data": {
    "searchSubscriptionPlanGroups": {
      "queryArguments": "xyz789",
      "campaignOrders": CampaignOrderConnection,
      "crowdfundingCampaigns": CrowdfundingCampaignConnection,
      "presaleCampaigns": PresaleCampaignConnection,
      "subscriptionOrders": SubscriptionOrderConnection,
      "subscriptionPlanGroups": SubscriptionPlanGroupConnection,
      "subscriptions": SubscriptionConnection
    }
  }
}

searchSubscriptions

Description

Search subscriptions

Response

Returns a SearchResult

Arguments
Name Description
customerIds - [SharedGlobalID!] Return only subscriptions belonging to these customers.
query - String A query string.
sortDirection - SortDirection The sort direction.
sortKey - SubscriptionSortKey
status - [SubscriptionStatus!] The subscription's status.
subscriptionPlanId - GlobalID Return only subscriptions belonging to this subscription plan.

Example

Query
query searchSubscriptions(
  $customerIds: [SharedGlobalID!],
  $query: String,
  $sortDirection: SortDirection,
  $sortKey: SubscriptionSortKey,
  $status: [SubscriptionStatus!],
  $subscriptionPlanId: GlobalID
) {
  searchSubscriptions(
    customerIds: $customerIds,
    query: $query,
    sortDirection: $sortDirection,
    sortKey: $sortKey,
    status: $status,
    subscriptionPlanId: $subscriptionPlanId
  ) {
    queryArguments
    campaignOrders {
      ...CampaignOrderConnectionFragment
    }
    crowdfundingCampaigns {
      ...CrowdfundingCampaignConnectionFragment
    }
    presaleCampaigns {
      ...PresaleCampaignConnectionFragment
    }
    subscriptionOrders {
      ...SubscriptionOrderConnectionFragment
    }
    subscriptionPlanGroups {
      ...SubscriptionPlanGroupConnectionFragment
    }
    subscriptions {
      ...SubscriptionConnectionFragment
    }
  }
}
Variables
{
  "customerIds": [SharedGlobalID],
  "query": "abc123",
  "sortDirection": "ASC",
  "sortKey": "CREATED_AT",
  "status": ["ACTIVE"],
  "subscriptionPlanId": GlobalID
}
Response
{
  "data": {
    "searchSubscriptions": {
      "queryArguments": "abc123",
      "campaignOrders": CampaignOrderConnection,
      "crowdfundingCampaigns": CrowdfundingCampaignConnection,
      "presaleCampaigns": PresaleCampaignConnection,
      "subscriptionOrders": SubscriptionOrderConnection,
      "subscriptionPlanGroups": SubscriptionPlanGroupConnection,
      "subscriptions": SubscriptionConnection
    }
  }
}

subscription

Description

Find a subscription by ID.

Response

Returns a Subscription

Arguments
Name Description
id - GlobalID! The subscription's ID.

Example

Query
query subscription($id: GlobalID!) {
  subscription(id: $id) {
    availableSubscriptionPlans {
      ...SubscriptionPlanFragment
    }
    billingBehaviour {
      ...SubscriptionBillingBehaviourFragment
    }
    cancelledAt
    channel {
      ...ChannelFragment
    }
    createdAt
    currency
    customer {
      ...CustomerFragment
    }
    deliveryBehaviour {
      ...SubscriptionDeliveryBehaviourFragment
    }
    deliveryMethod {
      ...SubscriptionDeliveryMethodFragment
    }
    externalId
    id
    identifier
    inventoryBehaviour {
      ...SubscriptionInventoryBehaviourFragment
    }
    lastProcessedOrder {
      ...SubscriptionOrderFragment
    }
    nextBillingAt
    nextDeliveryAt
    nextScheduledOrder {
      ...SubscriptionOrderFragment
    }
    order {
      ...OrderFragment
    }
    paymentMethod {
      ...PaymentMethodFragment
    }
    pricingBehaviour {
      ...SubscriptionPricingBehaviourFragment
    }
    processedSubscriptionOrdersCount
    source
    status
    subscriptionGroup {
      ...SubscriptionGroupFragment
    }
    subscriptionItems {
      ...SubscriptionItemFragment
    }
    subscriptionOrders {
      ...SubscriptionOrderConnectionFragment
    }
    subscriptionPlan {
      ...SubscriptionPlanFragment
    }
    updatedAt
  }
}
Variables
{"id": GlobalID}
Response
{
  "data": {
    "subscription": {
      "availableSubscriptionPlans": [SubscriptionPlan],
      "billingBehaviour": SubscriptionBillingBehaviour,
      "cancelledAt": ISO8601DateTime,
      "channel": Channel,
      "createdAt": ISO8601DateTime,
      "currency": "AED",
      "customer": Customer,
      "deliveryBehaviour": SubscriptionDeliveryBehaviour,
      "deliveryMethod": SubscriptionDeliveryMethod,
      "externalId": "abc123",
      "id": GlobalID,
      "identifier": "xyz789",
      "inventoryBehaviour": SubscriptionInventoryBehaviour,
      "lastProcessedOrder": SubscriptionOrder,
      "nextBillingAt": ISO8601DateTime,
      "nextDeliveryAt": ISO8601DateTime,
      "nextScheduledOrder": SubscriptionOrder,
      "order": Order,
      "paymentMethod": PaymentMethod,
      "pricingBehaviour": SubscriptionPricingBehaviour,
      "processedSubscriptionOrdersCount": 123,
      "source": "API",
      "status": "ACTIVE",
      "subscriptionGroup": SubscriptionGroup,
      "subscriptionItems": [SubscriptionItem],
      "subscriptionOrders": SubscriptionOrderConnection,
      "subscriptionPlan": SubscriptionPlan,
      "updatedAt": ISO8601DateTime
    }
  }
}

subscriptionGroup

Description

Find a subscription group by ID.

Response

Returns a SubscriptionGroup

Arguments
Name Description
id - GlobalID! The subscription group's ID.

Example

Query
query subscriptionGroup($id: GlobalID!) {
  subscriptionGroup(id: $id) {
    createdAt
    id
    identifier
    subscriptions {
      ...SubscriptionFragment
    }
    updatedAt
  }
}
Variables
{"id": GlobalID}
Response
{
  "data": {
    "subscriptionGroup": {
      "createdAt": ISO8601DateTime,
      "id": GlobalID,
      "identifier": "xyz789",
      "subscriptions": [Subscription],
      "updatedAt": ISO8601DateTime
    }
  }
}

subscriptionGroups

Description

List all subscription groups.

Response

Returns a SubscriptionGroupConnection

Arguments
Name Description
after - String Returns the elements in the list that come after the specified cursor.
before - String Returns the elements in the list that come before the specified cursor.
first - Int Returns the first n elements from the list.
last - Int Returns the last n elements from the list.

Example

Query
query subscriptionGroups(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int
) {
  subscriptionGroups(
    after: $after,
    before: $before,
    first: $first,
    last: $last
  ) {
    edges {
      ...SubscriptionGroupEdgeFragment
    }
    nodes {
      ...SubscriptionGroupFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
    totalCount
  }
}
Variables
{
  "after": "abc123",
  "before": "abc123",
  "first": 123,
  "last": 987
}
Response
{
  "data": {
    "subscriptionGroups": {
      "edges": [SubscriptionGroupEdge],
      "nodes": [SubscriptionGroup],
      "pageInfo": PageInfo,
      "totalCount": 987
    }
  }
}

subscriptionOrder

Description

Find a subscription order by ID.

Response

Returns a SubscriptionOrder

Arguments
Name Description
id - GlobalID! The subscription's ID.

Example

Query
query subscriptionOrder($id: GlobalID!) {
  subscriptionOrder(id: $id) {
    billingBehaviour {
      ...SubscriptionBillingBehaviourFragment
    }
    cancelledAt
    createdAt
    customer {
      ...CustomerFragment
    }
    customised
    cycleEndAt
    cycleIndex
    cycleStartAt
    deliveryBehaviour {
      ...SubscriptionDeliveryBehaviourFragment
    }
    deliveryMethod {
      ...SubscriptionDeliveryMethodFragment
    }
    expectedBillingAt
    expectedDeliveryAt
    financials {
      ...SubscriptionOrderFinancialsFragment
    }
    id
    identifier
    order {
      ...OrderFragment
    }
    paymentIntent {
      ...PaymentIntentFragment
    }
    paymentMethod {
      ...PaymentMethodFragment
    }
    paymentStatus
    processedAt
    skipped
    skippedAt
    status
    subscription {
      ...SubscriptionFragment
    }
    subscriptionOrderItems {
      ...SubscriptionOrderItemFragment
    }
    updatedAt
  }
}
Variables
{"id": GlobalID}
Response
{
  "data": {
    "subscriptionOrder": {
      "billingBehaviour": SubscriptionBillingBehaviour,
      "cancelledAt": ISO8601DateTime,
      "createdAt": ISO8601DateTime,
      "customer": Customer,
      "customised": false,
      "cycleEndAt": ISO8601DateTime,
      "cycleIndex": Count,
      "cycleStartAt": ISO8601DateTime,
      "deliveryBehaviour": SubscriptionDeliveryBehaviour,
      "deliveryMethod": SubscriptionDeliveryMethod,
      "expectedBillingAt": ISO8601DateTime,
      "expectedDeliveryAt": ISO8601DateTime,
      "financials": SubscriptionOrderFinancials,
      "id": GlobalID,
      "identifier": "abc123",
      "order": Order,
      "paymentIntent": PaymentIntent,
      "paymentMethod": PaymentMethod,
      "paymentStatus": "FAILED",
      "processedAt": ISO8601DateTime,
      "skipped": false,
      "skippedAt": ISO8601DateTime,
      "status": "CANCELLED",
      "subscription": Subscription,
      "subscriptionOrderItems": [SubscriptionOrderItem],
      "updatedAt": ISO8601DateTime
    }
  }
}

subscriptionOrders

Description

List all subscription orders.

Response

Returns a SubscriptionOrderConnection

Arguments
Name Description
after - String Returns the elements in the list that come after the specified cursor.
before - String Returns the elements in the list that come before the specified cursor.
first - Int Returns the first n elements from the list.
last - Int Returns the last n elements from the list.

Example

Query
query subscriptionOrders(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int
) {
  subscriptionOrders(
    after: $after,
    before: $before,
    first: $first,
    last: $last
  ) {
    edges {
      ...SubscriptionOrderEdgeFragment
    }
    nodes {
      ...SubscriptionOrderFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
    totalCount
  }
}
Variables
{
  "after": "abc123",
  "before": "abc123",
  "first": 987,
  "last": 987
}
Response
{
  "data": {
    "subscriptionOrders": {
      "edges": [SubscriptionOrderEdge],
      "nodes": [SubscriptionOrder],
      "pageInfo": PageInfo,
      "totalCount": 987
    }
  }
}

subscriptions

Description

List all subscriptions.

Response

Returns a SubscriptionConnection

Arguments
Name Description
after - String Returns the elements in the list that come after the specified cursor.
before - String Returns the elements in the list that come before the specified cursor.
first - Int Returns the first n elements from the list.
last - Int Returns the last n elements from the list.

Example

Query
query subscriptions(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int
) {
  subscriptions(
    after: $after,
    before: $before,
    first: $first,
    last: $last
  ) {
    edges {
      ...SubscriptionEdgeFragment
    }
    nodes {
      ...SubscriptionFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
    totalCount
  }
}
Variables
{
  "after": "xyz789",
  "before": "abc123",
  "first": 987,
  "last": 123
}
Response
{
  "data": {
    "subscriptions": {
      "edges": [SubscriptionEdge],
      "nodes": [Subscription],
      "pageInfo": PageInfo,
      "totalCount": 987
    }
  }
}

Mutations

subscriptionItemAdd

Description

Adds an item to the subscription.

Response

Returns a SubscriptionItemAddPayload

Arguments
Name Description
input - SubscriptionItemAddInput! Input for adding a subscription item.

Example

Query
mutation subscriptionItemAdd($input: SubscriptionItemAddInput!) {
  subscriptionItemAdd(input: $input) {
    addedItem {
      ...SubscriptionItemFragment
    }
    subscription {
      ...SubscriptionFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": SubscriptionItemAddInput}
Response
{
  "data": {
    "subscriptionItemAdd": {
      "addedItem": SubscriptionItem,
      "subscription": Subscription,
      "userErrors": [UserError]
    }
  }
}

subscriptionOrderItemAdd

Description

Adds a subscription order item.

Response

Returns a SubscriptionOrderItemAddPayload

Arguments
Name Description
input - SubscriptionOrderItemAddInput! Input for adding a subscription order item.

Example

Query
mutation subscriptionOrderItemAdd($input: SubscriptionOrderItemAddInput!) {
  subscriptionOrderItemAdd(input: $input) {
    addedItem {
      ...SubscriptionOrderItemFragment
    }
    subscriptionOrder {
      ...SubscriptionOrderFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": SubscriptionOrderItemAddInput}
Response
{
  "data": {
    "subscriptionOrderItemAdd": {
      "addedItem": SubscriptionOrderItem,
      "subscriptionOrder": SubscriptionOrder,
      "userErrors": [UserError]
    }
  }
}

subscriptionOrderProcess

Description

Process a subscription order.

Response

Returns a SubscriptionOrderProcessPayload

Arguments
Name Description
input - SubscriptionOrderProcessInput! Input for processing a subscription order.

Example

Query
mutation subscriptionOrderProcess($input: SubscriptionOrderProcessInput!) {
  subscriptionOrderProcess(input: $input) {
    subscriptionOrder {
      ...SubscriptionOrderFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": SubscriptionOrderProcessInput}
Response
{
  "data": {
    "subscriptionOrderProcess": {
      "subscriptionOrder": SubscriptionOrder,
      "userErrors": [UserError]
    }
  }
}

subscriptionOrderSkip

Description

Skip a subscription order.

Response

Returns a SubscriptionOrderSkipPayload

Arguments
Name Description
input - SubscriptionOrderSkipInput! Input for skipping a subscription order.

Example

Query
mutation subscriptionOrderSkip($input: SubscriptionOrderSkipInput!) {
  subscriptionOrderSkip(input: $input) {
    skippedSubscriptionOrders {
      ...SubscriptionOrderFragment
    }
    subscriptionOrder {
      ...SubscriptionOrderFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": SubscriptionOrderSkipInput}
Response
{
  "data": {
    "subscriptionOrderSkip": {
      "skippedSubscriptionOrders": [SubscriptionOrder],
      "subscriptionOrder": SubscriptionOrder,
      "userErrors": [UserError]
    }
  }
}

subscriptionOrderUnskip

Description

Unskip a subscription order.

Response

Returns a SubscriptionOrderUnskipPayload

Arguments
Name Description
input - SubscriptionOrderUnskipInput! Input for unskip a subscription order.

Example

Query
mutation subscriptionOrderUnskip($input: SubscriptionOrderUnskipInput!) {
  subscriptionOrderUnskip(input: $input) {
    subscriptionOrder {
      ...SubscriptionOrderFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": SubscriptionOrderUnskipInput}
Response
{
  "data": {
    "subscriptionOrderUnskip": {
      "subscriptionOrder": SubscriptionOrder,
      "userErrors": [UserError]
    }
  }
}

subscriptionOrderUpdate

Description

Updates a subscription order.

Response

Returns a SubscriptionOrderUpdatePayload

Arguments
Name Description
input - SubscriptionOrderUpdateInput! Input for updating a subscription order.

Example

Query
mutation subscriptionOrderUpdate($input: SubscriptionOrderUpdateInput!) {
  subscriptionOrderUpdate(input: $input) {
    subscriptionOrder {
      ...SubscriptionOrderFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": SubscriptionOrderUpdateInput}
Response
{
  "data": {
    "subscriptionOrderUpdate": {
      "subscriptionOrder": SubscriptionOrder,
      "userErrors": [UserError]
    }
  }
}

subscriptionSetFrequency

Description

Sets the frequency of a subscription.

Response

Returns a SubscriptionSetFrequencyPayload

Arguments
Name Description
input - SubscriptionSetFrequencyInput! Input for setting subscription frequency.

Example

Query
mutation subscriptionSetFrequency($input: SubscriptionSetFrequencyInput!) {
  subscriptionSetFrequency(input: $input) {
    subscription {
      ...SubscriptionFragment
    }
    userErrors {
      ...UserErrorFragment
    }
  }
}
Variables
{"input": SubscriptionSetFrequencyInput}
Response
{
  "data": {
    "subscriptionSetFrequency": {
      "subscription": Subscription,
      "userErrors": [UserError]
    }
  }
}

Objects

SearchResult

Description

A search result.

Fields
Field Name Description
queryArguments - String! The query arguments as a JSON string
campaignOrders - CampaignOrderConnection The matching campaign orders
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

crowdfundingCampaigns - CrowdfundingCampaignConnection The matching crowdfunding campaigns
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

presaleCampaigns - PresaleCampaignConnection The matching presale campaigns
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

subscriptionOrders - SubscriptionOrderConnection
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

subscriptionPlanGroups - SubscriptionPlanGroupConnection
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

subscriptions - SubscriptionConnection
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

Example
{
  "queryArguments": "abc123",
  "campaignOrders": CampaignOrderConnection,
  "crowdfundingCampaigns": CrowdfundingCampaignConnection,
  "presaleCampaigns": PresaleCampaignConnection,
  "subscriptionOrders": SubscriptionOrderConnection,
  "subscriptionPlanGroups": SubscriptionPlanGroupConnection,
  "subscriptions": SubscriptionConnection
}

SubscriptionGroup

Fields
Field Name Description
createdAt - ISO8601DateTime The date the subscription group was created.
id - GlobalID! The ID of the subscription group.
identifier - String!
subscriptions - [Subscription!]!
updatedAt - ISO8601DateTime The date the subscription group was last updated.
Example
{
  "createdAt": ISO8601DateTime,
  "id": GlobalID,
  "identifier": "abc123",
  "subscriptions": [Subscription],
  "updatedAt": ISO8601DateTime
}

SubscriptionOrder

Fields
Field Name Description
billingBehaviour - SubscriptionBillingBehaviour!
cancelledAt - ISO8601DateTime
createdAt - ISO8601DateTime The date the subscription was created.
customer - Customer! The subscription's customer.
customised - Boolean!
cycleEndAt - ISO8601DateTime
cycleIndex - Count!
cycleStartAt - ISO8601DateTime
deliveryBehaviour - SubscriptionDeliveryBehaviour!
deliveryMethod - SubscriptionDeliveryMethod!
expectedBillingAt - ISO8601DateTime
expectedDeliveryAt - ISO8601DateTime
financials - SubscriptionOrderFinancials
id - GlobalID! The ID of the subscription.
identifier - String! The identifier of the subscription order.
order - Order The order ID of the subscription.
paymentIntent - PaymentIntent The payment intent of the subscription.
paymentMethod - PaymentMethod The payment method of the subscription.
paymentStatus - SubscriptionOrderPaymentStatus!
processedAt - ISO8601DateTime
skipped - Boolean!
skippedAt - ISO8601DateTime
status - SubscriptionOrderStatus! The subscription order's status.
subscription - Subscription!
subscriptionOrderItems - [SubscriptionOrderItem!]! The subscription order's items.
updatedAt - ISO8601DateTime The date the subscription was last updated.
Example
{
  "billingBehaviour": SubscriptionBillingBehaviour,
  "cancelledAt": ISO8601DateTime,
  "createdAt": ISO8601DateTime,
  "customer": Customer,
  "customised": true,
  "cycleEndAt": ISO8601DateTime,
  "cycleIndex": Count,
  "cycleStartAt": ISO8601DateTime,
  "deliveryBehaviour": SubscriptionDeliveryBehaviour,
  "deliveryMethod": SubscriptionDeliveryMethod,
  "expectedBillingAt": ISO8601DateTime,
  "expectedDeliveryAt": ISO8601DateTime,
  "financials": SubscriptionOrderFinancials,
  "id": GlobalID,
  "identifier": "xyz789",
  "order": Order,
  "paymentIntent": PaymentIntent,
  "paymentMethod": PaymentMethod,
  "paymentStatus": "FAILED",
  "processedAt": ISO8601DateTime,
  "skipped": true,
  "skippedAt": ISO8601DateTime,
  "status": "CANCELLED",
  "subscription": Subscription,
  "subscriptionOrderItems": [SubscriptionOrderItem],
  "updatedAt": ISO8601DateTime
}

Connections

CampaignOrderConnection

Description

The connection type for CampaignOrder.

Fields
Field Name Description
edges - [CampaignOrderEdge] A list of edges.
nodes - [CampaignOrder] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
totalCount - Int! The total number of items in the collection
Example
{
  "edges": [CampaignOrderEdge],
  "nodes": [CampaignOrder],
  "pageInfo": PageInfo,
  "totalCount": 123
}

CampaignOrderEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - CampaignOrder The item at the end of the edge.
Example
{
  "cursor": "xyz789",
  "node": CampaignOrder
}

CampaignOrderGroupConnection

Description

The connection type for CampaignOrderGroup.

Fields
Field Name Description
edges - [CampaignOrderGroupEdge] A list of edges.
nodes - [CampaignOrderGroup] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
totalCount - Int! The total number of items in the collection
Example
{
  "edges": [CampaignOrderGroupEdge],
  "nodes": [CampaignOrderGroup],
  "pageInfo": PageInfo,
  "totalCount": 123
}

CampaignOrderGroupEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - CampaignOrderGroup The item at the end of the edge.
Example
{
  "cursor": "abc123",
  "node": CampaignOrderGroup
}

ChannelConnection

Description

The connection type for Channel.

Fields
Field Name Description
edges - [ChannelEdge] A list of edges.
nodes - [Channel] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [ChannelEdge],
  "nodes": [Channel],
  "pageInfo": PageInfo
}

ChannelEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - Channel The item at the end of the edge.
Example
{
  "cursor": "xyz789",
  "node": Channel
}

ChargeConnection

Description

The connection type for Charge.

Fields
Field Name Description
edges - [ChargeEdge] A list of edges.
nodes - [Charge] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
totalCount - Int! The total number of items in the collection
Example
{
  "edges": [ChargeEdge],
  "nodes": [Charge],
  "pageInfo": PageInfo,
  "totalCount": 123
}

ChargeEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - Charge The item at the end of the edge.
Example
{
  "cursor": "abc123",
  "node": Charge
}

CrowdfundingCampaignConnection

Description

The connection type for CrowdfundingCampaign.

Fields
Field Name Description
edges - [CrowdfundingCampaignEdge] A list of edges.
nodes - [CrowdfundingCampaign] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
totalCount - Int! The total number of items in the collection
Example
{
  "edges": [CrowdfundingCampaignEdge],
  "nodes": [CrowdfundingCampaign],
  "pageInfo": PageInfo,
  "totalCount": 123
}

CrowdfundingCampaignEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - CrowdfundingCampaign The item at the end of the edge.
Example
{
  "cursor": "xyz789",
  "node": CrowdfundingCampaign
}

CustomerConnection

Description

The connection type for Customer.

Fields
Field Name Description
edges - [CustomerEdge] A list of edges.
nodes - [Customer] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [CustomerEdge],
  "nodes": [Customer],
  "pageInfo": PageInfo
}

CustomerEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - Customer The item at the end of the edge.
Example
{
  "cursor": "xyz789",
  "node": Customer
}

ExternalTokenConnection

Description

The connection type for ExternalToken.

Fields
Field Name Description
edges - [ExternalTokenEdge] A list of edges.
nodes - [ExternalToken] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [ExternalTokenEdge],
  "nodes": [ExternalToken],
  "pageInfo": PageInfo
}

ExternalTokenEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - ExternalToken The item at the end of the edge.
Example
{
  "cursor": "abc123",
  "node": ExternalToken
}

NotificationConnection

Description

The connection type for Notification.

Fields
Field Name Description
edges - [NotificationEdge] A list of edges.
nodes - [Notification] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [NotificationEdge],
  "nodes": [Notification],
  "pageInfo": PageInfo
}

NotificationEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - Notification The item at the end of the edge.
Example
{
  "cursor": "abc123",
  "node": Notification
}

NotificationScheduleConnection

Description

The connection type for NotificationSchedule.

Fields
Field Name Description
edges - [NotificationScheduleEdge] A list of edges.
nodes - [NotificationSchedule] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [NotificationScheduleEdge],
  "nodes": [NotificationSchedule],
  "pageInfo": PageInfo
}

NotificationScheduleEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - NotificationSchedule The item at the end of the edge.
Example
{
  "cursor": "xyz789",
  "node": NotificationSchedule
}

OrderConnection

Description

The connection type for Order.

Fields
Field Name Description
edges - [OrderEdge] A list of edges.
nodes - [Order] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [OrderEdge],
  "nodes": [Order],
  "pageInfo": PageInfo
}

OrderEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - Order The item at the end of the edge.
Example
{
  "cursor": "abc123",
  "node": Order
}

OrganisationConnection

Description

The connection type for Organisation.

Fields
Field Name Description
edges - [OrganisationEdge] A list of edges.
nodes - [Organisation] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [OrganisationEdge],
  "nodes": [Organisation],
  "pageInfo": PageInfo
}

OrganisationEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - Organisation The item at the end of the edge.
Example
{
  "cursor": "abc123",
  "node": Organisation
}

PaymentIntentConnection

Description

The connection type for PaymentIntent.

Fields
Field Name Description
edges - [PaymentIntentEdge] A list of edges.
nodes - [PaymentIntent] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
totalCount - Int! The total number of items in the collection
Example
{
  "edges": [PaymentIntentEdge],
  "nodes": [PaymentIntent],
  "pageInfo": PageInfo,
  "totalCount": 123
}

PaymentIntentEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - PaymentIntent The item at the end of the edge.
Example
{
  "cursor": "abc123",
  "node": PaymentIntent
}

PaymentMethodConnection

Description

The connection type for PaymentMethod.

Fields
Field Name Description
edges - [PaymentMethodEdge] A list of edges.
nodes - [PaymentMethod] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
totalCount - Int! The total number of items in the collection
Example
{
  "edges": [PaymentMethodEdge],
  "nodes": [PaymentMethod],
  "pageInfo": PageInfo,
  "totalCount": 123
}

PaymentMethodEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - PaymentMethod The item at the end of the edge.
Example
{
  "cursor": "xyz789",
  "node": PaymentMethod
}

PresaleCampaignConnection

Description

The connection type for PresaleCampaign.

Fields
Field Name Description
edges - [PresaleCampaignEdge] A list of edges.
nodes - [PresaleCampaign] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
totalCount - Int! The total number of items in the collection
Example
{
  "edges": [PresaleCampaignEdge],
  "nodes": [PresaleCampaign],
  "pageInfo": PageInfo,
  "totalCount": 987
}

PresaleCampaignEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - PresaleCampaign The item at the end of the edge.
Example
{
  "cursor": "xyz789",
  "node": PresaleCampaign
}

ProductConnection

Description

The connection type for Product.

Fields
Field Name Description
edges - [ProductEdge] A list of edges.
nodes - [Product] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [ProductEdge],
  "nodes": [Product],
  "pageInfo": PageInfo
}

ProductEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - Product The item at the end of the edge.
Example
{
  "cursor": "abc123",
  "node": Product
}

ProductVariantConnection

Description

The connection type for ProductVariant.

Fields
Field Name Description
edges - [ProductVariantEdge] A list of edges.
nodes - [ProductVariant] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [ProductVariantEdge],
  "nodes": [ProductVariant],
  "pageInfo": PageInfo
}

ProductVariantEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - ProductVariant The item at the end of the edge.
Example
{
  "cursor": "xyz789",
  "node": ProductVariant
}

RefundConnection

Description

The connection type for Refund.

Fields
Field Name Description
edges - [RefundEdge] A list of edges.
nodes - [Refund] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
totalCount - Int! The total number of items in the collection
Example
{
  "edges": [RefundEdge],
  "nodes": [Refund],
  "pageInfo": PageInfo,
  "totalCount": 987
}

RefundEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - Refund The item at the end of the edge.
Example
{
  "cursor": "xyz789",
  "node": Refund
}

ScheduledNotificationConnection

Description

The connection type for ScheduledNotification.

Fields
Field Name Description
edges - [ScheduledNotificationEdge] A list of edges.
nodes - [ScheduledNotification] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [ScheduledNotificationEdge],
  "nodes": [ScheduledNotification],
  "pageInfo": PageInfo
}

ScheduledNotificationEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - ScheduledNotification The item at the end of the edge.
Example
{
  "cursor": "abc123",
  "node": ScheduledNotification
}

SubscriptionConnection

Description

The connection type for Subscription.

Fields
Field Name Description
edges - [SubscriptionEdge] A list of edges.
nodes - [Subscription] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
totalCount - Int! The total number of items in the collection
Example
{
  "edges": [SubscriptionEdge],
  "nodes": [Subscription],
  "pageInfo": PageInfo,
  "totalCount": 987
}

SubscriptionEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - Subscription The item at the end of the edge.
Example
{
  "cursor": "abc123",
  "node": Subscription
}

SubscriptionGroupConnection

Description

The connection type for SubscriptionGroup.

Fields
Field Name Description
edges - [SubscriptionGroupEdge] A list of edges.
nodes - [SubscriptionGroup] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
totalCount - Int! The total number of items in the collection
Example
{
  "edges": [SubscriptionGroupEdge],
  "nodes": [SubscriptionGroup],
  "pageInfo": PageInfo,
  "totalCount": 123
}

SubscriptionGroupEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - SubscriptionGroup The item at the end of the edge.
Example
{
  "cursor": "xyz789",
  "node": SubscriptionGroup
}

SubscriptionOrderConnection

Description

The connection type for SubscriptionOrder.

Fields
Field Name Description
edges - [SubscriptionOrderEdge] A list of edges.
nodes - [SubscriptionOrder] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
totalCount - Int! The total number of items in the collection
Example
{
  "edges": [SubscriptionOrderEdge],
  "nodes": [SubscriptionOrder],
  "pageInfo": PageInfo,
  "totalCount": 987
}

SubscriptionOrderEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - SubscriptionOrder The item at the end of the edge.
Example
{
  "cursor": "abc123",
  "node": SubscriptionOrder
}

SubscriptionPlanGroupConnection

Description

The connection type for SubscriptionPlanGroup.

Fields
Field Name Description
edges - [SubscriptionPlanGroupEdge] A list of edges.
nodes - [SubscriptionPlanGroup] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
totalCount - Int! The total number of items in the collection
Example
{
  "edges": [SubscriptionPlanGroupEdge],
  "nodes": [SubscriptionPlanGroup],
  "pageInfo": PageInfo,
  "totalCount": 123
}

SubscriptionPlanGroupEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - SubscriptionPlanGroup The item at the end of the edge.
Example
{
  "cursor": "xyz789",
  "node": SubscriptionPlanGroup
}

WebhookConnection

Description

The connection type for Webhook.

Fields
Field Name Description
edges - [WebhookEdge] A list of edges.
nodes - [Webhook] A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [WebhookEdge],
  "nodes": [Webhook],
  "pageInfo": PageInfo
}

WebhookEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - Webhook The item at the end of the edge.
Example
{
  "cursor": "abc123",
  "node": Webhook
}

Enums

AccessTokenMode

Description

access token mode

Values
Enum Value Description

STATEFUL

stateful

STATELESS

stateless
Example
"STATEFUL"

AccessTokenType

Description

access token type

Values
Enum Value Description

CHANNEL

channel

CUSTOMER

customer
Example
"CHANNEL"

CampaignAllocationStatus

Description

The allocation status of a campaign.

Values
Enum Value Description

ALLOCATED

Allocation is complete.

ALLOCATING

Allocation is in progress.

ALLOCATION_QUEUED

Allocation is queued.

PARTIALLY_ALLOCATED

Campaign is partially allocated.

PENDING

Allocation is pending.
Example
"ALLOCATED"

CampaignDepositType

Description

The campaign deposit type.

Values
Enum Value Description

PERCENTAGE

Campaign deposit type is a percentage
Example
"PERCENTAGE"

CampaignItemType

Description

The possible item types.

Values
Enum Value Description

PRODUCT

The type is a product type.

PRODUCT_VARIANT

The type is a product variant type.
Example
"PRODUCT"

CampaignOrderFulfilmentStatus

Description

Fulfilment status of campaign order.

Values
Enum Value Description

ALLOCATED

Campaign order fulfilment is allocated

FAILED

Campaign order fulfilment is failed

FULFILLED

Campaign order fulfilment is fulfilled

ON_HOLD

Campaign order fulfilment is on hold

OPEN

Campaign order fulfilment is open

PENDING

Campaign order fulfilment is pending

RETURNED

Campaign order fulfilment is returned

SUBMITTED

Campaign order fulfilment is submitted
Example
"ALLOCATED"

CampaignOrderGroupStatus

Description

Status of campaign order group eg: (pending, paid)

Values
Enum Value Description

ALLOCATED

Campaign order group is allocated

CANCELLED

Campaign order group is cancelled

COMPLETED

Campaign order group is completed

PAID

Campaign order group is paid

PENDING

Campaign order group is pending
Example
"ALLOCATED"

CampaignOrderPaymentStatus

Description

Payment status of the campaign order.

Values
Enum Value Description

FAILED

Payment failed.

PAID

Payment captured..

PARTIALLY_REFUNDED

Payment partially refunded.

PENDING

Payment pending.

REFUNDED

Payment refunded.

SUBMITTED

Payment submitted.
Example
"FAILED"

CampaignOrderSortKey

Description

The key used to sort campaign orders.

Values
Enum Value Description

CREATED_AT

Sort by created at.

ID

Sort by ID.

IDENTIFIER

Sort by identifier.
Example
"CREATED_AT"

CampaignOrderStatus

Description

Status of campaign order eg: (pending, paid)

Values
Enum Value Description

ALLOCATED

Campaign order is allocated

CANCELLED

Campaign order is cancelled

COMPLETED

Campaign order is completed

PAID

Campaign order is paid

PENDING

Campaign order is pending
Example
"ALLOCATED"

CampaignPaymentTermsAlignment

Description

When should payments be captured when they are defined on a group?

Values
Enum Value Description

FIRST_CAMPAIGN

Payment terms are aligned to the first campaign.

LAST_CAMPAIGN

Payment terms are aligned to the last campaign.
Example
"FIRST_CAMPAIGN"

CampaignStatus

Description

The status of a campaign.

Values
Enum Value Description

CANCELLED

Campaign is cancelled

COMPLETED

Campaign is completed

ENDED

Campaign is ended

FULFILLING

Campaign is fulfilling

LAUNCHED

Campaign is launched

PENDING

Campaign is pending
Example
"CANCELLED"

CampaignType

Description

The possible campaign types.

Values
Enum Value Description

CROWDFUNDING

The campaign is a crowdfunding campaign.

PRESALE

The campaign is a presale campaign.
Example
"CROWDFUNDING"

CardBrand

Description

The card brands supported by Submarine.

Values
Enum Value Description

AMEX

American Express (Amex).

DISCOVER

Discover & Diners

JCB

Japan Credit Bureau (JCB)

MASTERCARD

Mastercard.

UNIONPAY

China UnionPay (CUP)

VISA

Visa.
Example
"AMEX"

ChannelStatus

Description

The possible channel statuses.

Values
Enum Value Description

ACTIVE

The channel is active.

INACTIVE

The channel is inactive.
Example
"ACTIVE"

ChannelType

Description

channel type

Values
Enum Value Description

SHOPIFY

shopify
Example
"SHOPIFY"

ChargeFailureCode

Description

Failure code

Values
Enum Value Description

API_ERROR

API error

CARD_DECLINED

Card declined
Example
"API_ERROR"

ChargeSource

Description

The source of a charge or refund.

Values
Enum Value Description

SHOPIFY

Shopify

SUBMARINE

Submarine

UNKNOWN

Unknown source
Example
"SHOPIFY"

ChargeStatus

Description

Status of charge eg: (pending)

Values
Enum Value Description

FAILED

Charge failed

PENDING

Charge pending

SUCCEEDED

Charge succeeded
Example
"FAILED"

ChargeType

Description

Type of charge (eg. verify)

Values
Enum Value Description

AUTHORISE

Authorise

CAPTURE

Capture

SALE

Sale

VERIFY

Verify
Example
"AUTHORISE"

CountryCode

Description

ISO-3166-1 country codes.

Values
Enum Value Description

AD

Andorra

AE

United Arab Emirates

AF

Afghanistan

AG

Antigua and Barbuda

AI

Anguilla

AL

Albania

AM

Armenia

AO

Angola

AQ

Antarctica

AR

Argentina

AS

American Samoa

AT

Austria

AU

Australia

AW

Aruba

AX

Åland Islands

AZ

Azerbaijan

BA

Bosnia and Herzegovina

BB

Barbados

BD

Bangladesh

BE

Belgium

BF

Burkina Faso

BG

Bulgaria

BH

Bahrain

BI

Burundi

BJ

Benin

BL

Saint Barthélemy

BM

Bermuda

BN

Brunei Darussalam

BO

Bolivia

BQ

Bonaire, Sint Eustatius and Saba

BR

Brazil

BS

Bahamas

BT

Bhutan

BV

Bouvet Island

BW

Botswana

BY

Belarus

BZ

Belize

CA

Canada

CC

Cocos (Keeling) Islands

CD

Congo, The Democratic Republic of the

CF

Central African Republic

CG

Congo

CH

Switzerland

CI

Côte d'Ivoire

CK

Cook Islands

CL

Chile

CM

Cameroon

CN

China

CO

Colombia

CR

Costa Rica

CU

Cuba

CV

Cabo Verde

CW

Curaçao

CX

Christmas Island

CY

Cyprus

CZ

Czechia

DE

Germany

DJ

Djibouti

DK

Denmark

DM

Dominica

DO

Dominican Republic

DZ

Algeria

EC

Ecuador

EE

Estonia

EG

Egypt

EH

Western Sahara

ER

Eritrea

ES

Spain

ET

Ethiopia

FI

Finland

FJ

Fiji

FK

Falkland Islands (Malvinas)

FM

Micronesia, Federated States of

FO

Faroe Islands

FR

France

GA

Gabon

GB

United Kingdom

GD

Grenada

GE

Georgia

GF

French Guiana

GG

Guernsey

GH

Ghana

GI

Gibraltar

GL

Greenland

GM

Gambia

GN

Guinea

GP

Guadeloupe

GQ

Equatorial Guinea

GR

Greece

GS

South Georgia and the South Sandwich Islands

GT

Guatemala

GU

Guam

GW

Guinea-Bissau

GY

Guyana

HK

Hong Kong

HM

Heard Island and McDonald Islands

HN

Honduras

HR

Croatia

HT

Haiti

HU

Hungary

ID

Indonesia

IE

Ireland

IL

Israel

IM

Isle of Man

IN

India

IO

British Indian Ocean Territory

IQ

Iraq

IR

Iran

IS

Iceland

IT

Italy

JE

Jersey

JM

Jamaica

JO

Jordan

JP

Japan

KE

Kenya

KG

Kyrgyzstan

KH

Cambodia

KI

Kiribati

KM

Comoros

KN

Saint Kitts and Nevis

KP

North Korea

KR

South Korea

KW

Kuwait

KY

Cayman Islands

KZ

Kazakhstan

LA

Lao People's Democratic Republic

LB

Lebanon

LC

Saint Lucia

LI

Liechtenstein

LK

Sri Lanka

LR

Liberia

LS

Lesotho

LT

Lithuania

LU

Luxembourg

LV

Latvia

LY

Libya

MA

Morocco

MC

Monaco

MD

Moldova

ME

Montenegro

MF

Saint Martin (French part)

MG

Madagascar

MH

Marshall Islands

MK

North Macedonia

ML

Mali

MM

Myanmar

MN

Mongolia

MO

Macao

MP

Northern Mariana Islands

MQ

Martinique

MR

Mauritania

MS

Montserrat

MT

Malta

MU

Mauritius

MV

Maldives

MW

Malawi

MX

Mexico

MY

Malaysia

MZ

Mozambique

NA

Namibia

NC

New Caledonia

NE

Niger

NF

Norfolk Island

NG

Nigeria

NI

Nicaragua

NL

Netherlands

NO

Norway

NP

Nepal

NR

Nauru

NU

Niue

NZ

New Zealand

OM

Oman

PA

Panama

PE

Peru

PF

French Polynesia

PG

Papua New Guinea

PH

Philippines

PK

Pakistan

PL

Poland

PM

Saint Pierre and Miquelon

PN

Pitcairn

PR

Puerto Rico

PS

Palestine, State of

PT

Portugal

PW

Palau

PY

Paraguay

QA

Qatar

RE

Réunion

RO

Romania

RS

Serbia

RU

Russian Federation

RW

Rwanda

SA

Saudi Arabia

SB

Solomon Islands

SC

Seychelles

SD

Sudan

SE

Sweden

SG

Singapore

SH

Saint Helena, Ascension and Tristan da Cunha

SI

Slovenia

SJ

Svalbard and Jan Mayen

SK

Slovakia

SL

Sierra Leone

SM

San Marino

SN

Senegal

SO

Somalia

SR

Suriname

SS

South Sudan

ST

Sao Tome and Principe

SV

El Salvador

SX

Sint Maarten (Dutch part)

SY

Syrian Arab Republic

SZ

Eswatini

TC

Turks and Caicos Islands

TD

Chad

TF

French Southern Territories

TG

Togo

TH

Thailand

TJ

Tajikistan

TK

Tokelau

TL

Timor-Leste

TM

Turkmenistan

TN

Tunisia

TO

Tonga

TR

Türkiye

TT

Trinidad and Tobago

TV

Tuvalu

TW

Taiwan

TZ

Tanzania

UA

Ukraine

UG

Uganda

UM

United States Minor Outlying Islands

US

United States

UY

Uruguay

UZ

Uzbekistan

VA

Holy See (Vatican City State)

VC

Saint Vincent and the Grenadines

VE

Venezuela

VG

Virgin Islands, British

VI

Virgin Islands, U.S.

VN

Vietnam

VU

Vanuatu

WF

Wallis and Futuna

WS

Samoa

YE

Yemen

YT

Mayotte

ZA

South Africa

ZM

Zambia

ZW

Zimbabwe
Example
"AD"

CrowdfundingCampaignSortKey

Description

The key used to sort crowdfunding campaigns.

Values
Enum Value Description

COMPLETED_AT

Sort by the crowdfunding campaigns completion date.

END_AT

Sort by the crowdfunding campaigns end date.

FULFIL_AT

Sort by the crowdfunding campaigns fulfilment date.

GOAL_PROGRESS

Sort by the crowdfunding campaigns goal_progress.

ID

Sort by the crowdfunding campaigns ID.

LAUNCH_AT

Sort by the crowdfunding campaigns launch date.
Example
"COMPLETED_AT"

CrowdfundingGoalStatus

Description

The goal status of a crowdfunding campaign.

Values
Enum Value Description

FAILED

Campaign has failed

PENDING

Campaign is pending

SUCCEEDED

Campaign has succeeded
Example
"FAILED"

CrowdfundingGoalType

Description

The possible crowdfunding campaign goal types.

Values
Enum Value Description

TOTAL_UNITS

The type is a total units type.

TOTAL_VALUE

The type is a total value type.
Example
"TOTAL_UNITS"

CurrencyCode

Description

The currency codes.

Values
Enum Value Description

AED

United Arab Emirates Dirham (AED).

AFN

Afghan Afghani (AFN).

ALL

Albanian Lek (ALL).

AMD

Armenian Dram (AMD).

ANG

Netherlands Antillean Guilder (ANG).

AOA

Angolan Kwanza (AOA).

ARS

Argentine Pesos (ARS).

AUD

Australian Dollar (AUD).

AWG

Aruban Florin (AWG).

AZN

Azerbaijani Manat (AZN).

BAM

Bosnia and Herzegovina Convertible Mark (BAM).

BBD

Barbadian Dollar (BBD).

BDT

Bangladesh Taka (BDT).

BGN

Bulgarian Lev (BGN).

BIF

Burundian Franc (BIF).

BMD

Bermudian Dollar (BMD).

BND

Brunei Dollar (BND).

BOB

Bolivian Boliviano (BOB).

BRL

Brazilian Real (BRL).

BSD

Bahamian Dollar (BSD).

BWP

Botswana Pula (BWP).

BZD

Belize Dollar (BZD).

CAD

Canadian Dollar (CAD).

CDF

Congolese Franc (CDF).

CHF

Swiss Francs (CHF).

CLP

Chilean Peso (CLP).

CNY

Chinese Yuan Renminbi (CNY).

COP

Colombian Peso (COP).

CRC

Costa Rican Colones (CRC).

CVE

Cape Verdean Escudo (CVE).

CZK

Czech Koruny (CZK).

DJF

Djiboutian Franc (DJF).

DKK

Danish Kroner (DKK).

DOP

Dominican Peso (DOP).

DZD

Algerian Dinar (DZD).

EGP

Egyptian Pound (EGP).

ETB

Ethiopian Birr (ETB).

EUR

Euro (EUR).

FJD

Fijian Dollar (FJD).

FKP

Falkland Islands Pounds (FKP).

GBP

United Kingdom Pounds (GBP).

GEL

Georgian Lari (GEL).

GIP

Gibraltar Pounds (GIP).

GMD

Gambian Dalasi (GMD).

GNF

Guinean Franc (GNF).

GTQ

Guatemalan Quetzal (GTQ).

GYD

Guyanese Dollar (GYD).

HKD

Hong Kong Dollar (HKD).

HNL

Honduran Lempira (HNL).

HTG

Haitian Gourde (HTG).

HUF

Hungarian Forint (HUF).

IDR

Indonesian Rupiah (IDR).

ILS

Israeli New Shekel (NIS).

INR

Indian Rupees (INR).

ISK

Icelandic Kronur (ISK).

JMD

Jamaican Dollar (JMD).

JPY

Japanese Yen (JPY).

KES

Kenyan Shilling (KES).

KGS

Kyrgyzstani Som (KGS).

KHR

Cambodian Riel. (KHR)

KMF

Comorian Franc (KMF).

KRW

South Korean Won (KRW).

KYD

Cayman Dollar (KYD).

KZT

Kazakhstani Tenge (KZT).

LAK

Laotian Kip (LAK).

LBP

Lebanese Pounds (LBP).

LKR

Sri Lankan Rupees (LKR).

LRD

Liberian Dollar (LRD).

LSL

Lesotho Loti (LSL).

MAD

Moroccan Dirham (MAD).

MDL

Moldovan Leu (MDL).

MGA

Malagasy Ariary (MGA).

MKD

Macedonia Denar (MKD).

MMK

Burmese Kyat (MMK).

MNT

Mongolian Tugrik (MNT).

MOP

Macanese Pataca (MOP).

MUR

Mauritian Rupee (MUR).

MVR

Maldivian Rufiyaa (MVR).

MWK

Malawian Kwacha (MWK).

MXN

Mexican Pesos (MXN).

MYR

Malaysian Ringgits (MYR).

MZN

Mozambican Metical (MZN).

NAD

Namibian Dollar (NAD).

NGN

Nigerian Naira (NGN).

NIO

Nicaraguan Córdoba (NIO).

NOK

Norwegian Kroner (NOK).

NPR

Nepalese Rupee (NPR).

NZD

New Zealand Dollar (NZD).

PAB

Panamian Balboa (PAB).

PEN

Peruvian Nuevo Sol (PEN).

PGK

Papua New Guinean Kina (PGK).

PHP

Philippine Peso (PHP).

PKR

Pakistani Rupee (PKR).

PLN

Polish Zlotych (PLN).

PYG

Paraguayan Guarani (PYG).

QAR

Qatari Rial (QAR).

RON

Romanian Lei (RON).

RSD

Serbian dinar (RSD).

RUB

Russian Rubles (RUB).

RWF

Rwandan Franc (RWF).

SAR

Saudi Riyal (SAR).

SBD

Solomon Islands Dollar (SBD).

SCR

Seychellois Rupee (SCR).

SEK

Swedish Kronor (SEK).

SGD

Singapore Dollar (SGD).

SHP

Saint Helena Pounds (SHP).

SLL

Sierra Leonean Leone (SLL).

SRD

Surinamese Dollar (SRD).

SZL

Swazi Lilangeni (SZL).

THB

Thai baht (THB).

TJS

Tajikistani Somoni (TJS).

TOP

Tongan Pa'anga (TOP).

TRY

Turkish Lira (TRY).

TTD

Trinidad and Tobago Dollar (TTD).

TWD

Taiwan Dollar (TWD).

TZS

Tanzanian Shilling (TZS).

UAH

Ukrainian Hryvnia (UAH).

UGX

Ugandan Shilling (UGX).

USD

United States Dollar (USD).

UYU

Uruguayan Pesos (UYU).

UZS

Uzbekistan som (UZS).

VND

Vietnamese đồng (VND).

VUV

Vanuatu Vatu (VUV).

WST

Samoan Tala (WST).

XAF

Central African CFA Franc (XAF).

XCD

East Caribbean Dollar (XCD).

XOF

West African CFA franc (XOF).

XPF

CFP Franc (XPF).

YER

Yemeni Rial (YER).

ZAR

South African Rand (ZAR).

ZMW

Zambian Kwacha (ZMW).
Example
"AED"

CustomerStatus

Description

The possible customer statuses.

Values
Enum Value Description

ACTIVE

The customer is active.

DELETED

The customer is deleted.

INACTIVE

The customer is inactive
Example
"ACTIVE"

DepositType

Description

The possible deposit types for a presale campaign.

Values
Enum Value Description

PERCENTAGE

The deposit is collected as percentage.
Example
"PERCENTAGE"

DiscountType

Values
Enum Value Description

AUTOMATIC

CODE

SCRIPT

Example
"AUTOMATIC"

MoneyRoundingMode

Description

The method used to round prices.

Values
Enum Value Description

ROUND_CEILING

Round toward positive infinity.

ROUND_DOWN

Round toward zero.

ROUND_FLOOR

Round toward negative infinity.

ROUND_HALF_DOWN

Round toward the nearest neighbour; if the neighbours are equidistant, round toward zero.

ROUND_HALF_EVEN

Round toward the nearest neighbour; if the neighbours are equidistant, round toward the even neighbour.

ROUND_HALF_UP

Round toward the nearest neighbour; if the neighbours are equidistant, round away from zero.

ROUND_UP

Round away from zero.
Example
"ROUND_CEILING"

NotificationDeliveryMechanism

Description

Delivery mechanism for a notification.

Values
Enum Value Description

EMAIL

Email

EXTERNAL

External

WEBHOOK

Webhook
Example
"EMAIL"

NotificationDeliveryStatus

Description

Delivery status of a notification.

Values
Enum Value Description

FAILED

Failed

PENDING

Pending

SUCCEEDED

Succeeded
Example
"FAILED"

NotificationScheduleTrigger

Description

The trigger event that the notification schedule is anchored to.

Values
Enum Value Description

CROWDFUND_END_AT

Crowdfund end at

PRESALE_DUE_AT

Presale due at

UPCOMING_CARD_EXPIRY

Upcoming card expiry
Example
"CROWDFUND_END_AT"

OrganisationStatus

Description

Status of organisation eg: (active)

Values
Enum Value Description

ACTIVE

Organisation is active

INACTIVE

Organisation is inactive
Example
"ACTIVE"

PaymentInstrumentType

Description

The types of payment instrument supported by Submarine.

Values
Enum Value Description

CARD

Card

PAYPAL_BILLING_AGREEMENT

Paypal billing agreement
Example
"CARD"

PaymentIntentStatus

Description

Status of the payment intent

Values
Enum Value Description

CANCELLED

Payment intent cancelled

PROCESSING

Payment intent processing

REQUIRES_ACTION

Payment intent requires_action

REQUIRES_CAPTURE

Payment intent requires_capture

SUCCEEDED

Payment intent succeeded
Example
"CANCELLED"

PaymentMethodStatus

Description

Status of the payment method

Values
Enum Value Description

ACTIVE

Payment method active

INACTIVE

Payment method inactive
Example
"ACTIVE"

PaymentProcessorType

Description

The types of payment processor supported by Submarine.

Values
Enum Value Description

SHOPIFY

Shopify Payments.
Example
"SHOPIFY"

Persona

Description

A Submarine persona.

Values
Enum Value Description

CUSTOMER

A customer.

MERCHANT

A merchant.

SUBMARINE

A Submarine service.
Example
"CUSTOMER"

PresaleCampaignSortKey

Description

The key used to sort presale campaigns.

Values
Enum Value Description

COMPLETED_AT

Sort by the presale campaigns completion date.

END_AT

Sort by the presale campaigns end date.

FULFIL_AT

Sort by the presale campaigns fulfilment date.

ID

Sort by the presale campaigns ID.

LAUNCH_AT

Sort by the presale campaigns launch date.
Example
"COMPLETED_AT"

PriceCalculationStatus

Description

The status of a price calculation.

Values
Enum Value Description

CALCULATED

Price calculation is calculated

CALCULATING

Price calculation is calculating

FAILED

Price calculation is failed

PENDING

Price calculation is pending
Example
"CALCULATED"

PriceEnginePolicy

Description

When to refresh an engine's price sources.

Values
Enum Value Description

ALWAYS

Always refresh the engine's price source.

ON_DEMAND

Only refresh the price source when the resource changes demand it.
Example
"ALWAYS"

PriceEngineProvider

Description

A trusted source of price information.

Values
Enum Value Description

SHOPIFY

Get price sources from Shopify.
Example
"SHOPIFY"

PriceEngineType

Description

The possible price engine types.

Values
Enum Value Description

SHOPIFY

The price engine type is Shopify.
Example
"SHOPIFY"

PricingResourceType

Description

The possible resource types.

Values
Enum Value Description

CAMPAIGN_ORDER_GROUP

The resource is a campaign order group

SUBSCRIPTION_ORDER

The resource is a subscription order
Example
"CAMPAIGN_ORDER_GROUP"

PricingSourceType

Description

The possible source types.

Values
Enum Value Description

CALCULATED_DRAFT_ORDER

GENERATED_ORDER

ORDER

Example
"CALCULATED_DRAFT_ORDER"

ProductCollectionItemStatus

Description

Status of product collection item eg: (active)

Values
Enum Value Description

ACTIVE

Product collection item has not been deleted

DELETED

Product collection item has been soft deleted
Example
"ACTIVE"

ProductCollectionStatus

Description

Status of product collection eg: (published)

Values
Enum Value Description

DELETED

Product collection is deleted

PUBLISHED

Product collection is published

UNPUBLISHED

Product collection is unpublished
Example
"DELETED"

ProductStatus

Description

Status of product eg: (published)

Values
Enum Value Description

DELETED

Product is deleted

PUBLISHED

Product is published

UNPUBLISHED

Product is unpublished
Example
"DELETED"

ProductVariantStatus

Description

Status of product variant eg: (published)

Values
Enum Value Description

DELETED

Product variant is deleted

PUBLISHED

Product variant is published

UNPUBLISHED

Product variant is unpublished
Example
"DELETED"

RecordStatus

Description

Record status of charge eg: (processed)

Values
Enum Value Description

PROCESSED

Charge processed

RECORDED

Charge recorded
Example
"PROCESSED"

RefundStatus

Description

Status of refund eg: (pending)

Values
Enum Value Description

FAILED

Refund failed

PENDING

Refund pending

SUCCEEDED

Refund succeeded
Example
"FAILED"

ScheduledNotificationStatus

Description

The status of a scheduled notification.

Values
Enum Value Description

DELETED

Deleted

ENQUEUED

Enqueued

SCHEDULED

Scheduled
Example
"DELETED"

SortDirection

Description

The sort direction.

Values
Enum Value Description

ASC

Sort in ascending order.

DESC

Sort in descending order.
Example
"ASC"

SubscriptionAnchorType

Values
Enum Value Description

MONTHDAY

WEEKDAY

YEARDAY

Example
"MONTHDAY"

SubscriptionBacklogInterval

Description

Translation missing: en.graphql.enums.subscription_backlog_interval.description

Values
Enum Value Description

CYCLE

Translation missing: en.graphql.enums.subscription_backlog_interval.values.cycle

DAY

Translation missing: en.graphql.enums.subscription_backlog_interval.values.day

HOUR

Translation missing: en.graphql.enums.subscription_backlog_interval.values.hour

MINUTE

Translation missing: en.graphql.enums.subscription_backlog_interval.values.minute

MONTH

Translation missing: en.graphql.enums.subscription_backlog_interval.values.month

WEEK

Translation missing: en.graphql.enums.subscription_backlog_interval.values.week

YEAR

Translation missing: en.graphql.enums.subscription_backlog_interval.values.year
Example
"CYCLE"

SubscriptionBasePricePolicy

Values
Enum Value Description

CUSTOM

FIXED

ON_BILLING_ATTEMPT

ON_SUBSCRIPTION_CREATE

Example
"CUSTOM"

SubscriptionDeliveryBehaviourType

Values
Enum Value Description

FIXED

FLEXIBLE

Example
"FIXED"

SubscriptionDeliveryMethodType

Values
Enum Value Description

LOCAL

PICKUP

SHIPPING

UNKNOWN

Example
"LOCAL"

SubscriptionDeliveryPreAnchorBehaviourType

Values
Enum Value Description

ASAP

NEXT

Example
"ASAP"

SubscriptionEngine

Description

Translation missing: en.graphql.enums.subscription_engine_type.description

Values
Enum Value Description

NOOP

Translation missing: en.graphql.enums.subscription_engine_type.values.noop

SHOPIFY

Translation missing: en.graphql.enums.subscription_engine_type.values.shopify

SUBMARINE

Translation missing: en.graphql.enums.subscription_engine_type.values.submarine
Example
"NOOP"

SubscriptionInterval

Description

Translation missing: en.graphql.enums.subscription_interval.description

Values
Enum Value Description

DAY

Translation missing: en.graphql.enums.subscription_interval.values.day

HOUR

Translation missing: en.graphql.enums.subscription_interval.values.hour

MINUTE

Translation missing: en.graphql.enums.subscription_interval.values.minute

MONTH

Translation missing: en.graphql.enums.subscription_interval.values.month

WEEK

Translation missing: en.graphql.enums.subscription_interval.values.week

YEAR

Translation missing: en.graphql.enums.subscription_interval.values.year
Example
"DAY"

SubscriptionInventoryDecrementPolicy

Values
Enum Value Description

NONE

ON_ORDER_CREATION

ON_ORDER_FULFILMENT

Example
"NONE"

SubscriptionInventoryOutOfStockPolicy

Values
Enum Value Description

PAUSE_SUBSCRIPTION

REPLACE_ITEM

SKIP_ITEM

SKIP_ORDER

Example
"PAUSE_SUBSCRIPTION"

SubscriptionLineItemDataItemType

Values
Enum Value Description

ONE_OFF

RECURRING

Example
"ONE_OFF"

SubscriptionOffsetInterval

Values
Enum Value Description

DAY

HOUR

Example
"DAY"

SubscriptionOffsetType

Values
Enum Value Description

BUSINESS

CALENDAR

Example
"BUSINESS"

SubscriptionOrderItemItem

Description

Translation missing: en.graphql.enums.subscription_order_item_item_type.description

Values
Enum Value Description

ONE_OFF

Translation missing: en.graphql.enums.subscription_order_item_item_type.values.one_off

RECURRING

Translation missing: en.graphql.enums.subscription_order_item_item_type.values.recurring
Example
"ONE_OFF"

SubscriptionOrderPaymentStatus

Values
Enum Value Description

FAILED

FINALISING

PENDING

SUBMITTED

SUCCEEDED

Example
"FAILED"

SubscriptionOrderSortKey

Description

The key used to sort subscription orders.

Values
Enum Value Description

CYCLE_INDEX

Sort by the subscription orders cycle index.

ID

Sort by the subscription orders ID.

IDENTIFIER

Example
"CYCLE_INDEX"

SubscriptionOrderStatus

Description

Status of subscription order eg: (pending, cancelled)

Values
Enum Value Description

CANCELLED

Subscription order is cancelled

PENDING

Subscription order is pending

PROCESSED

Subscription order is processed

PROCESSING

Subscription order is processing

SCHEDULED

Subscription order is scheduled
Example
"CANCELLED"

SubscriptionPlanGroupSortKey

Description

The key used to sort subscription plan groups.

Values
Enum Value Description

CREATED_AT

Sort by the subscription plan groups creation date.

ID

Sort by the subscription plan groups ID.

SUBSCRIPTIONS_COUNT

Example
"CREATED_AT"

SubscriptionPlanGroupStatus

Description

Status of subscription plan group eg: (active, inactive)

Values
Enum Value Description

ACTIVE

Subscription plan group is active

INACTIVE

Subscription plan group is inactive
Example
"ACTIVE"

SubscriptionPlanStatus

Description

Status of subscription plan eg: (active, inactive)

Values
Enum Value Description

ACTIVE

Subscription plan is active

INACTIVE

Subscription plan is inactive
Example
"ACTIVE"

SubscriptionPriceDiscountType

Values
Enum Value Description

FIXED_AMOUNT

PERCENTAGE

Example
"FIXED_AMOUNT"

SubscriptionPriceDiscountValueCapType

Values
Enum Value Description

INDIVIDUAL_ITEM

SUBSCRIPTION_ORDER

Example
"INDIVIDUAL_ITEM"

SubscriptionProductGroupItemSourceStatus

Description

Status of subscription product group item source eg: (active, inactive)

Values
Enum Value Description

ACTIVE

Subscription product group item source is active

INACTIVE

Subscription product group item source is inactive
Example
"ACTIVE"

SubscriptionProductGroupItemStatus

Description

Status of subscription product group item eg: (active, inactive)

Values
Enum Value Description

ACTIVE

Subscription product group item is active

INACTIVE

Subscription product group item is inactive
Example
"ACTIVE"

SubscriptionRetryInterval

Description

Translation missing: en.graphql.enums.subscription_retry_interval.description

Values
Enum Value Description

DAY

Translation missing: en.graphql.enums.subscription_retry_interval.values.day

HOUR

Translation missing: en.graphql.enums.subscription_retry_interval.values.hour

MINUTE

Translation missing: en.graphql.enums.subscription_retry_interval.values.minute
Example
"DAY"

SubscriptionSortKey

Description

The key used to sort subscriptions.

Values
Enum Value Description

CREATED_AT

Sort by the subscriptions creation date.

ID

Sort by the subscriptions ID.

IDENTIFIER

PROCESSED_SUBSCRIPTION_ORDERS_COUNT

Example
"CREATED_AT"

SubscriptionSource

Description

Source of subscription eg: (api, order)

Values
Enum Value Description

API

ORDER

Example
"API"

SubscriptionStatus

Description

Status of subscription eg: (active, stale)

Values
Enum Value Description

ACTIVE

Subscription is active

CANCELLED

Subscription order is cancelled

EXPIRED

Subscription order is expired

FAILED

Subscription order is failed

PAUSED

Subscription order is paused

STALE

Subscription order is stale
Example
"ACTIVE"

TaxBehaviour

Description

The tax behaviour of a Submarine resource.

Values
Enum Value Description

EXCLUSIVE

Prices are shown exclusive of tax.

INCLUSIVE

Prices are shown inclusive of tax.
Example
"EXCLUSIVE"

TimeOffsetDirection

Description

The direction to offset in.

Values
Enum Value Description

BEFORE

Before
Example
"BEFORE"

TimeOffsetUnit

Description

The unit of time to offset by.

Values
Enum Value Description

DAYS

Days

HOURS

Hours

MINUTES

Minutes
Example
"DAYS"

TokenStatus

Description

token status

Values
Enum Value Description

ACTIVE

active

INACTIVE

inactive
Example
"ACTIVE"

TokenTarget

Description

token target

Values
Enum Value Description

ANY

any

PAYMENTS

payments

PRICING

pricing
Example
"ANY"

WebhookStatus

Description

Status of webhook

Values
Enum Value Description

ACTIVE

Webhook is active

INACTIVE

Webhook is inactive
Example
"ACTIVE"

WebhookTopic

Description

A Webhook's topic

Values
Enum Value Description

CAMPAIGN_ORDER_CANCELLED

CAMPAIGN_ORDER_CREATED

CAMPAIGN_ORDER_FULFILLED

CAMPAIGN_ORDER_GROUP_DUE_DATE_UPDATED

CAMPAIGN_UPCOMING_CHARGE

CHARGE_FAILED

CHARGE_SUCCEEDED

CROWDFUNDING_CAMPAIGN_COMPLETED

CROWDFUNDING_CAMPAIGN_ENDED

CROWDFUNDING_CAMPAIGN_LAUNCHED

PAYMENT_METHOD_EXPIRING

PRESALE_CAMPAIGN_COMPLETED

PRESALE_CAMPAIGN_ENDED

PRESALE_CAMPAIGN_LAUNCHED

REFUND_SUCCEEDED

SUBSCRIPTION_CREATED

Example
"CAMPAIGN_ORDER_CANCELLED"

Input Objects

AccessTokenCreateInput

Description

Input for creating an access token.

Fields
Input Field Description
tokenMode - AccessTokenMode! The token's mode
tokenType - AccessTokenType! Type of token
Example
{"tokenMode": "STATEFUL", "tokenType": "CHANNEL"}

AddressInput

Fields
Input Field Description
address1 - String!
address2 - String
city - String!
countryCode - CountryCode!
provinceCode - String!
zip - String!
Example
{
  "address1": "abc123",
  "address2": "abc123",
  "city": "abc123",
  "countryCode": "AD",
  "provinceCode": "xyz789",
  "zip": "xyz789"
}

CampaignDataInput

Description

Campaign data.

Fields
Input Field Description
deposit - CampaignDepositInput
id - ID! The campaign's ID.
type - CampaignType! The campaign's type.
Example
{
  "deposit": CampaignDepositInput,
  "id": 4,
  "type": "CROWDFUNDING"
}

CampaignDepositInput

Description

Input for configuring a campaign deposit.

Fields
Input Field Description
type - CampaignDepositType!
value - Float!
Example
{"type": "PERCENTAGE", "value": 123.45}

CampaignOrderCancelInput

Description

Specifies the input fields required to cancel a campaign order.

Fields
Input Field Description
id - GlobalID! ID of the campaign order to cancel.
Example
{"id": GlobalID}

CampaignOrderCreateInput

Description

Specifies the input fields required to create a campaign order.

Fields
Input Field Description
campaignId - GlobalID! The campaign order's campaign ID.
campaignType - CampaignType! The campaign order's campaign type.
depositType - DepositType The type of deposit on the campaign order's campaign.
depositValue - Float The value of deposit on the campaign order's campaign
externalLineItemId - String! The ID of the campaign order line item
id - GlobalID ID of the campaign order to create.
paymentMethodId - GlobalID The campaign order's payment method ID.
productId - GlobalID! The campaign order's product ID.
productVariantId - GlobalID! The campaign order's product variant ID.
quantity - Int! The campaign order's quantity.
Example
{
  "campaignId": GlobalID,
  "campaignType": "CROWDFUNDING",
  "depositType": "PERCENTAGE",
  "depositValue": 123.45,
  "externalLineItemId": "xyz789",
  "id": GlobalID,
  "paymentMethodId": GlobalID,
  "productId": GlobalID,
  "productVariantId": GlobalID,
  "quantity": 987
}

CampaignOrderDataInput

Description

Specifies the input fields required for campaign order data.

Fields
Input Field Description
campaign - CampaignDataInput! The campaign order's campaign.
cancelled - Boolean! Indicates if the campaign order is cancelled.
id - ID! ID of the campaign order.
lineItem - LineItemDataInput! The campaign order's line item.
Example
{
  "campaign": CampaignDataInput,
  "cancelled": true,
  "id": 4,
  "lineItem": LineItemDataInput
}

CampaignOrderDecreaseQuantityInput

Description

Specifies the input fields required to update a campaign order.

Fields
Input Field Description
id - GlobalID! ID of the campaign order to update.
quantity - Int The desired new quantity of the campaign order
Example
{"id": GlobalID, "quantity": 987}

CampaignOrderGroupCancelInput

Description

Specifies the input fields required to cancel a campaign order group.

Fields
Input Field Description
id - GlobalID! ID of the campaign order group to cancel.
Example
{"id": GlobalID}

CampaignOrderGroupCreateInput

Description

Specifies the input fields required to create a campaign order group.

Fields
Input Field Description
campaignOrders - [CampaignOrderCreateInput!]! The products which are included in the campaign
customerId - GlobalID! The customer who owns this group
externalId - String! The campaign order group's external ID.
id - GlobalID ID of the campaign order to create.
identifier - String The identifier for the group.
paymentMethodId - GlobalID The campaign order's payment method ID.
Example
{
  "campaignOrders": [CampaignOrderCreateInput],
  "customerId": GlobalID,
  "externalId": "xyz789",
  "id": GlobalID,
  "identifier": "xyz789",
  "paymentMethodId": GlobalID
}

CampaignOrderGroupDataInput

Fields
Input Field Description
campaignOrders - [CampaignOrderDataInput!]! The products which are included in the campaign
cancelled - Boolean! Indicates if the resource is cancelled.
customerId - ID! The customer who owns this group
externalId - String! The campaign order group's external ID.
Example
{
  "campaignOrders": [CampaignOrderDataInput],
  "cancelled": true,
  "customerId": "4",
  "externalId": "xyz789"
}

CampaignOrderGroupRetryPaymentInput

Description

Specifies the input fields required to retry payment for a campaign order group.

Fields
Input Field Description
id - GlobalID! ID of the campaign order group to retry paying.
Example
{"id": GlobalID}

CampaignOrderRetryFulfilmentInput

Description

Specifies the input fields required to retry fulfilling a campaign order.

Fields
Input Field Description
id - GlobalID! ID of the campaign order to retry fulfilling.
Example
{"id": GlobalID}

CampaignOrderRetryPaymentInput

Description

Specifies the input fields required to retry payment for a campaign order.

Fields
Input Field Description
id - GlobalID! ID of the campaign order to retry paying.
Example
{"id": GlobalID}

CardCreateInput

Description

Specifies the input fields required to create a card.

Fields
Input Field Description
brand - CardBrand! The card brand.
expiry - CardExpiryInput! The card expiry.
externalId - String The (optional) external ID of the card.
last4 - String! The last four digits of the card number.
Example
{
  "brand": "AMEX",
  "expiry": CardExpiryInput,
  "externalId": "xyz789",
  "last4": "xyz789"
}

CardExpiryInput

Description

Expiry details of the card.

Fields
Input Field Description
month - Int! Expiry month (as an integer, starting at 1 for Janaury).
year - Int! Expiry year (as a four-digit integer, e.g. 2023).
Example
{"month": 987, "year": 123}

ChannelConfigSetInput

Description

Input for configuring a channel's settings.

Fields
Input Field Description
config - PlatformConfigSetInput! The Submarine configuration.
id - GlobalID! The channel ID.
Example
{
  "config": PlatformConfigSetInput,
  "id": GlobalID
}

ChannelCreateInput

Description

Input for creating a channel.

Fields
Input Field Description
channelType - ChannelType! The channel type.
externalId - String! The channel's external ID.
identifier - String! The channel's identifier
name - String! The channel's name
Example
{
  "channelType": "SHOPIFY",
  "externalId": "xyz789",
  "identifier": "xyz789",
  "name": "abc123"
}

ChannelUpdateInput

Description

Specifies the input fields required to update a channel.

Fields
Input Field Description
externalId - String The channel's external ID.
id - GlobalID! The ID of the channel to update.
identifier - String The channel's identifier
name - String The channel's name
status - ChannelStatus The channel's status.
Example
{
  "externalId": "abc123",
  "id": GlobalID,
  "identifier": "abc123",
  "name": "xyz789",
  "status": "ACTIVE"
}

ChargeCaptureInput

Description

The input required to capture a charge

Fields
Input Field Description
amount - MoneyInput The amount to be charged. If blank, the balance owing will be charged.
description - String The description of the charge.
externalId - String The external ID of the charge.
metadata - MetadataInput Unstructured key/value pairs.
paymentIntentId - GlobalID! The payment intent ID.
source - ChargeSource The source of the charge.
Example
{
  "amount": MoneyInput,
  "description": "abc123",
  "externalId": "xyz789",
  "metadata": MetadataInput,
  "paymentIntentId": GlobalID,
  "source": "SHOPIFY"
}

ChargeRecordInput

Description

The input required to record a charge

Fields
Input Field Description
amount - MoneyInput! The amount to be charged.
chargeType - ChargeType! The type of charge to record.
description - String The description of the charge.
externalId - String The external ID of the charge.
metadata - MetadataInput Unstructured key/value pairs.
paymentIntentId - GlobalID The payment intent ID.
source - ChargeSource The source of the charge.
Example
{
  "amount": MoneyInput,
  "chargeType": "AUTHORISE",
  "description": "abc123",
  "externalId": "abc123",
  "metadata": MetadataInput,
  "paymentIntentId": GlobalID,
  "source": "SHOPIFY"
}

CrowdfundingCampaignAddProductVariantsInput

Description

Input for adding product variants to a crowdfunding campaign.

Fields
Input Field Description
id - GlobalID The campaigns's ID.
productVariantIds - [SharedGlobalID!]! The product variants to be added to the campaign
Example
{
  "id": GlobalID,
  "productVariantIds": [SharedGlobalID]
}

CrowdfundingCampaignAddProductsInput

Description

Input for adding products to a crowdfunding campaign.

Fields
Input Field Description
id - GlobalID The campaigns's ID.
productIds - [SharedGlobalID!] The products that are included in the campaign
Example
{
  "id": GlobalID,
  "productIds": [SharedGlobalID]
}

CrowdfundingCampaignApplyBulkInventoryInput

Description

Specifies the input fields required to apply bulk inventory to a crowdfunding campaign.

Fields
Input Field Description
campaignId - GlobalID! The crowdfunding campaign ID.
inventoryApplications - [CrowdfundingCampaignApplyInventoryBaseInput!]! The campaign inventory items and quantities which should be applied
Example
{
  "campaignId": GlobalID,
  "inventoryApplications": [
    CrowdfundingCampaignApplyInventoryBaseInput
  ]
}

CrowdfundingCampaignApplyInventoryBaseInput

Description

Specifies the base input fields required to apply inventory to a crowdfunding campaign.

Fields
Input Field Description
campaignInventoryItemId - GlobalID! The campaign inventory item for which inventory is being applied
quantityReceived - Int! The number of units available to be allocated
Example
{
  "campaignInventoryItemId": GlobalID,
  "quantityReceived": 123
}

CrowdfundingCampaignApplyInventoryInput

Description

Specifies the input fields required to apply inventory to a crowdfunding campaign.

Fields
Input Field Description
campaignId - GlobalID! The crowdfunding campaign ID.
campaignInventoryItemId - GlobalID! The campaign inventory item for which inventory is being applied
quantityReceived - PositiveInteger! The number of units available to be allocated
Example
{
  "campaignId": GlobalID,
  "campaignInventoryItemId": GlobalID,
  "quantityReceived": PositiveInteger
}

CrowdfundingCampaignArchiveInput

Description

Specifies the input fields required to archive a crowdfunding campaign.

Fields
Input Field Description
id - GlobalID! ID of the crowdfunding campaign to archive.
Example
{"id": GlobalID}

CrowdfundingCampaignCancelInput

Description

Specifies the input fields required to cancel a crowdfunding campaign.

Fields
Input Field Description
id - GlobalID! ID of the crowdfunding campaign order to cancel.
Example
{"id": GlobalID}

CrowdfundingCampaignCreateInput

Description

Input for creating a crowdfunding campaign.

Fields
Input Field Description
description - String The campaign description
endAt - ISO8601DateTime! The date the crowdfunding campaign will end
fulfilAt - ISO8601DateTime The date the crowdfunding campaign will be fulfilled
goal - CrowdfundingGoalInput! The campaign's goal.
gracePeriodHours - Int! The number of hours a customer has to rectify a failed crowdfunding campaign payment before their campaign order is cancelled.
launchAt - ISO8601DateTime! The date the crowdfunding campaign will be launched
limit - Int The maximum number of units of the linked products that can be sold
name - String The name of the campaign
productIds - [SharedGlobalID!] The products that are included in the campaign
productVariantIds - [SharedGlobalID!] The product variants that are included in the campaign
reference - String! The campaign reference
Example
{
  "description": "abc123",
  "endAt": ISO8601DateTime,
  "fulfilAt": ISO8601DateTime,
  "goal": CrowdfundingGoalInput,
  "gracePeriodHours": 987,
  "launchAt": ISO8601DateTime,
  "limit": 123,
  "name": "xyz789",
  "productIds": [SharedGlobalID],
  "productVariantIds": [SharedGlobalID],
  "reference": "abc123"
}

CrowdfundingCampaignDeleteInput

Description

Specifies the input fields required to delete a crowdfunding campaign.

Fields
Input Field Description
id - GlobalID! ID of the crowdfunding campaign order to delete.
Example
{"id": GlobalID}

CrowdfundingCampaignEndInput

Description

Specifies the input fields required to end a crowdfunding campaign.

Fields
Input Field Description
id - GlobalID! ID of the crowdfunding campaign order to end.
Example
{"id": GlobalID}

CrowdfundingCampaignFulfilInput

Description

Specifies the input fields required to fulfil a crowdfunding campaign.

Fields
Input Field Description
id - GlobalID! ID of the crowdfunding campaign to fulfil.
Example
{"id": GlobalID}

CrowdfundingCampaignLaunchInput

Description

Specifies the input fields required to launch a crowdfunding campaign.

Fields
Input Field Description
id - GlobalID! ID of the crowdfunding campaign order to launch.
Example
{"id": GlobalID}

CrowdfundingCampaignRemoveProductVariantsInput

Description

Input for removing product variants from a crowdfunding campaign.

Fields
Input Field Description
id - GlobalID The campaigns's ID.
productVariantIds - [SharedGlobalID!] The product variants to be removed from the campaign
Example
{
  "id": GlobalID,
  "productVariantIds": [SharedGlobalID]
}

CrowdfundingCampaignRemoveProductsInput

Description

Input for removing products from a crowdfunding campaign.

Fields
Input Field Description
id - GlobalID The campaigns's ID.
productIds - [SharedGlobalID!] The products to be removed from the campaign
Example
{
  "id": GlobalID,
  "productIds": [SharedGlobalID]
}

CrowdfundingCampaignUnarchiveInput

Description

Specifies the input fields required to unarchive a crowdfunding campaign.

Fields
Input Field Description
id - GlobalID! ID of the crowdfunding campaign to unarchive.
Example
{"id": GlobalID}

CrowdfundingCampaignUpdateInput

Description

Input for updating a crowdfunding campaign.

Fields
Input Field Description
description - String The campaign description
endAt - ISO8601DateTime The date the crowdfunding campaign will end
fulfilAt - ISO8601DateTime The date the crowdfunding campaign will be fulfilled
goal - CrowdfundingGoalInput The campaign's goal.
gracePeriodHours - Int The number of hours a customer has to rectify a failed crowdfunding campaign payment before their campaign order is cancelled.
id - GlobalID! The campaign's ID.
launchAt - ISO8601DateTime The date the crowdfunding campaign will be launched
limit - Int The maximum number of units of the linked products that can be sold
name - String The name of the campaign
productIds - [SharedGlobalID!] The products that are included in the campaign
productVariantIds - [SharedGlobalID!] The product variants that are included in the campaign
reference - String The campaign reference
Example
{
  "description": "xyz789",
  "endAt": ISO8601DateTime,
  "fulfilAt": ISO8601DateTime,
  "goal": CrowdfundingGoalInput,
  "gracePeriodHours": 123,
  "id": GlobalID,
  "launchAt": ISO8601DateTime,
  "limit": 123,
  "name": "xyz789",
  "productIds": [SharedGlobalID],
  "productVariantIds": [SharedGlobalID],
  "reference": "abc123"
}

CrowdfundingGoalInput

Description

Specifies the input fields required to create a generic crowdfunding campaign goal.

Fields
Input Field Description
goalTotalUnits - Int The campaign's total active reserved items goal.
goalTotalValue - MoneyInput The campaign's total value goal.
goalType - CrowdfundingGoalType! The campaign goal type.
Example
{
  "goalTotalUnits": 123,
  "goalTotalValue": MoneyInput,
  "goalType": "TOTAL_UNITS"
}

CustomerCreateInput

Description

Input for creating a customer.

Fields
Input Field Description
email - String The customer's email.
externalId - String! The customer's external ID.
firstName - String The customer's first name.
id - GlobalID The customer's ID.
lastName - String The customer's last name.
phone - String The customer's phone.
taxable - Boolean! Whether the customer is liable for sales tax.
Example
{
  "email": "abc123",
  "externalId": "abc123",
  "firstName": "abc123",
  "id": GlobalID,
  "lastName": "xyz789",
  "phone": "xyz789",
  "taxable": false
}

CustomerUpdateInput

Description

Input for updating a customer.

Fields
Input Field Description
email - String The customer's email.
externalId - String The customer's external ID.
firstName - String The customer's first name.
id - GlobalID! The customer's ID.
lastName - String The customer's last name.
phone - String The customer's phone.
taxable - Boolean Whether the customer is liable for sales tax.
Example
{
  "email": "abc123",
  "externalId": "abc123",
  "firstName": "abc123",
  "id": GlobalID,
  "lastName": "xyz789",
  "phone": "xyz789",
  "taxable": true
}

CustomerUpsertInput

Description

Input for upserting a customer.

Fields
Input Field Description
email - String The customer's email.
externalId - String The customer's external ID.
firstName - String The customer's first name.
id - GlobalID The customer's ID.
lastName - String The customer's last name.
phone - String The customer's phone.
taxable - Boolean Whether the customer is liable for sales tax.
Example
{
  "email": "xyz789",
  "externalId": "abc123",
  "firstName": "xyz789",
  "id": GlobalID,
  "lastName": "xyz789",
  "phone": "abc123",
  "taxable": true
}

ExternalTokenCreateInput

Description

external token create input

Fields
Input Field Description
primary - Boolean primary. Default = false
target - TokenTarget target. Default = ANY
token - String! token
Example
{
  "primary": true,
  "target": "ANY",
  "token": "abc123"
}

ExternalTokenRevokeInput

Description

external token revoke input

Fields
Input Field Description
id - GlobalID! id
Example
{"id": GlobalID}

LineItemCreateInput

Description

Input for creating a line item.

Fields
Input Field Description
externalId - String! The line item's ID.
productId - GlobalID! The line item's product ID.
productVariantId - GlobalID! The line item's product variant ID.
Example
{
  "externalId": "xyz789",
  "productId": GlobalID,
  "productVariantId": GlobalID
}

LineItemDataInput

Description

Line item data.

Fields
Input Field Description
externalId - ID! The line item's external ID.
productId - ID! The line item's product ID.
productVariantId - ID! The line item's product variant ID.
quantity - Int! The line item's quantity.
Example
{
  "externalId": 4,
  "productId": "4",
  "productVariantId": 4,
  "quantity": 123
}

LineItemUpdateInput

Description

Input for updating a line item.

Fields
Input Field Description
externalId - String! The line item's ID.
productId - GlobalID The line item's product ID.
productVariantId - GlobalID The line item's product variant ID.
Example
{
  "externalId": "xyz789",
  "productId": GlobalID,
  "productVariantId": GlobalID
}

LineItemUpsertInput

Description

Input for upserting a line item.

Fields
Input Field Description
externalId - String! The line item's ID.
productId - GlobalID! The line item's product ID.
productVariantId - GlobalID! The line item's product variant ID.
Example
{
  "externalId": "abc123",
  "productId": GlobalID,
  "productVariantId": GlobalID
}

MailingAddressInput

Description

An organisation's mailing address.

Fields
Input Field Description
address1 - String! Line 1 of mailing address.
address2 - String Line 2 of mailing address.
city - String! The name of the city, district, village, or town.
company - String The name of the organisation's company.
countryCode - CountryCode! The two-letter code for the country of the address.
phone - String Phone number
province - String The region of the address
provinceCode - String The code for the region of the address
zip - String! The zip or postal code of the address.
Example
{
  "address1": "abc123",
  "address2": "xyz789",
  "city": "xyz789",
  "company": "abc123",
  "countryCode": "AD",
  "phone": "xyz789",
  "province": "xyz789",
  "provinceCode": "xyz789",
  "zip": "abc123"
}

MoneyInput

Description

A money object.

Fields
Input Field Description
amount - String! The money object's amount.
currency - CurrencyCode! The money object's currency code.
Example
{"amount": "abc123", "currency": "AED"}

NotificationScheduleCreateInput

Description

Input for creating a notification schedule.

Fields
Input Field Description
anchor - ISO8601DateTime! The schedule's anchor date.
customerId - String! The schedule's customer ID.
deliveryMechanism - NotificationDeliveryMechanism! The delivery mechanism.
event - String! The event to notify.
payload - JSON! The payload to deliver.
schedule - [TimeOffsetInput!]! The schedule.
Example
{
  "anchor": ISO8601DateTime,
  "customerId": "xyz789",
  "deliveryMechanism": "EMAIL",
  "event": "xyz789",
  "payload": {},
  "schedule": [TimeOffsetInput]
}

NotificationScheduleDeleteInput

Description

Input for deleting a notification schedule.

Fields
Input Field Description
id - GlobalID! The notification schedule's ID.
Example
{"id": GlobalID}

NotificationScheduleTemplateInput

Description

Input for creating an notification schedule.

Fields
Input Field Description
schedule - [TimeOffsetInput!]! The schedule.
trigger - NotificationScheduleTrigger! The trigger event that the notification schedule will be anchored to.
Example
{
  "schedule": [TimeOffsetInput],
  "trigger": "CROWDFUND_END_AT"
}

NotificationScheduleUpdateInput

Description

Input for updating a notification schedule.

Fields
Input Field Description
anchor - ISO8601DateTime! The schedule's anchor date.
id - GlobalID! The notification schedule's ID.
Example
{
  "anchor": ISO8601DateTime,
  "id": GlobalID
}

NotificationsConfigSetInput

Description

Input for configuring settings for notifications.

Fields
Input Field Description
emailCustomerWhenCampaignDueDateIsUpdated - Boolean
emailCustomerWhenCampaignIsOrdered - Boolean
emailMerchantOnWebhookFailure - Boolean
emailMerchantWhenCampaignOrderCannotBeFulfilled - Boolean
notificationSchedules - [NotificationScheduleTemplateInput!]
Example
{
  "emailCustomerWhenCampaignDueDateIsUpdated": true,
  "emailCustomerWhenCampaignIsOrdered": true,
  "emailMerchantOnWebhookFailure": false,
  "emailMerchantWhenCampaignOrderCannotBeFulfilled": false,
  "notificationSchedules": [
    NotificationScheduleTemplateInput
  ]
}

OrderCreateInput

Description

Input for creating an order.

Fields
Input Field Description
externalId - String! The order's external ID.
id - GlobalID The order's ID.
lineItems - [LineItemCreateInput!]! The input to create line items.
name - String! The order's name.
Example
{
  "externalId": "abc123",
  "id": GlobalID,
  "lineItems": [LineItemCreateInput],
  "name": "abc123"
}

OrderUpdateInput

Description

Input for updating an order.

Fields
Input Field Description
externalId - String The order's external ID.
id - GlobalID! The order's ID.
lineItems - [LineItemUpdateInput!] The input to update line items.
name - String The order's name.
Example
{
  "externalId": "xyz789",
  "id": GlobalID,
  "lineItems": [LineItemUpdateInput],
  "name": "xyz789"
}

OrderUpsertInput

Description

Input for upserting an order.

Fields
Input Field Description
externalId - String The order's external ID.
id - GlobalID! The order's ID.
lineItems - [LineItemUpsertInput!] The input to upsert line items.
name - String The order's name.
Example
{
  "externalId": "abc123",
  "id": GlobalID,
  "lineItems": [LineItemUpsertInput],
  "name": "xyz789"
}

OrganisationCreateInput

Description

Input for creating an organisation.

Fields
Input Field Description
address - MailingAddressInput The organisation's mailing address.
email - String! The organisation's email address.
name - String! The organisation's name.
Example
{
  "address": MailingAddressInput,
  "email": "abc123",
  "name": "abc123"
}

OrganisationUpdateInput

Description

Input for updating an organisation.

Fields
Input Field Description
address - MailingAddressInput The organisation's mailing address.
email - String The organisation's email address.
id - GlobalID! The organisation's ID.
name - String The organisation's name.
status - OrganisationStatus The organisation's status (eg. active).
Example
{
  "address": MailingAddressInput,
  "email": "abc123",
  "id": GlobalID,
  "name": "xyz789",
  "status": "ACTIVE"
}

PaymentInstrumentCreateInput

Description

Specifies the input fields required to create a payment instrument.

Fields
Input Field Description
card - CardCreateInput The card to be used for this payment method.
externalReference - String The (optional) external reference of the instrument.
manuallyCapturable - Boolean Whether payment can be captured manually.
paymentProcessor - PaymentProcessorType! The payment processor to be used for this payment method.
paypalBillingAgreement - PaypalBillingAgreementCreateInput The agreement to be used for this payment method.
type - PaymentInstrumentType! The type of payment instrument to create.
Example
{
  "card": CardCreateInput,
  "externalReference": "abc123",
  "manuallyCapturable": true,
  "paymentProcessor": "SHOPIFY",
  "paypalBillingAgreement": PaypalBillingAgreementCreateInput,
  "type": "CARD"
}

PaymentInstrumentUpdateInput

Description

Specifies the input fields required to update a payment instrument.

Fields
Input Field Description
card - CardCreateInput The card to be used for this payment method.
externalReference - String The (optional) external reference of the instrument.
paypalBillingAgreement - PaypalBillingAgreementCreateInput The agreement to be used for this payment method.
type - PaymentInstrumentType! The type of payment instrument to create.
Example
{
  "card": CardCreateInput,
  "externalReference": "abc123",
  "paypalBillingAgreement": PaypalBillingAgreementCreateInput,
  "type": "CARD"
}

PaymentIntentAdjustmentCreateInput

Description

The input values required to create an adjustment to a payment intent

Fields
Input Field Description
amount - MoneyInput! The money object
description - String The description of the charge
metadata - MetadataInput Unstructured key/value pairs
paymentIntentId - GlobalID! The payment intent ID
Example
{
  "amount": MoneyInput,
  "description": "abc123",
  "metadata": MetadataInput,
  "paymentIntentId": GlobalID
}

PaymentIntentCancelInput

Description

The input required to cancel a payment intent

Fields
Input Field Description
id - GlobalID! The payment intent ID
Example
{"id": GlobalID}

PaymentIntentCreateInput

Description

The input values required to create a new payment intent

Fields
Input Field Description
amount - MoneyInput! The amount to be collected.
flexible - Boolean! If payment intent is flexible and can be changed.
initialCharge - ChargeRecordInput An initial charge to be recorded against the intent.
metadata - MetadataInput Unstructured key/value pairs.
paymentMethodId - GlobalID! The payment method ID.
Example
{
  "amount": MoneyInput,
  "flexible": true,
  "initialCharge": ChargeRecordInput,
  "metadata": MetadataInput,
  "paymentMethodId": GlobalID
}

PaymentIntentFinaliseInput

Description

The input values required to finalise a payment intent

Fields
Input Field Description
amount - MoneyInput! The amount to be collected.
id - GlobalID! The PaymentIntent ID
Example
{
  "amount": MoneyInput,
  "id": GlobalID
}

PaymentIntentUpdateInput

Description

The input values required to update a payment intent

Fields
Input Field Description
id - GlobalID! The PaymentIntent ID
metadata - MetadataInput Unstructured key/value pairs
paymentMethodId - GlobalID The payment method ID
Example
{
  "id": GlobalID,
  "metadata": MetadataInput,
  "paymentMethodId": GlobalID
}

PaymentMethodCancelInput

Description

The input required to cancel a payment method

Fields
Input Field Description
id - GlobalID! The payment method ID
Example
{"id": GlobalID}

PaymentMethodCreateInput

Description

Specifies the input fields required to create a payment method.

Fields
Input Field Description
customerId - GlobalID! The ID of the customer.
paymentInstrument - PaymentInstrumentCreateInput! The payment instrument.
Example
{
  "customerId": GlobalID,
  "paymentInstrument": PaymentInstrumentCreateInput
}

PaymentMethodSendUpdateEmailInput

Description

Specifies the input fields required to send payment method update email to customer.

Fields
Input Field Description
id - GlobalID! The payment method ID of the order.
Example
{"id": GlobalID}

PaymentMethodUpdateInput

Description

Specifies the input fields required to update a payment method.

Fields
Input Field Description
id - GlobalID! The ID of the payment method.
paymentInstrument - PaymentInstrumentUpdateInput! The payment instrument.
Example
{
  "id": GlobalID,
  "paymentInstrument": PaymentInstrumentUpdateInput
}

PaypalBillingAgreementCreateInput

Description

Specifies the input fields required to create a Paypal billing agreement.

Fields
Input Field Description
accountEmail - String The account email.
accountName - String The account name.
externalId - String The (optional) external ID of the agreement.
Example
{
  "accountEmail": "abc123",
  "accountName": "xyz789",
  "externalId": "abc123"
}

PlatformConfigSetInput

Description

Input for configuring Submarine settings.

Fields
Input Field Description
notifications - NotificationsConfigSetInput
presales - PresalesConfigSetInput
pricing - PricingConfigSetInput
subscriptions - SubscriptionsConfigSetInput
Example
{
  "notifications": NotificationsConfigSetInput,
  "presales": PresalesConfigSetInput,
  "pricing": PricingConfigSetInput,
  "subscriptions": SubscriptionsConfigSetInput
}

PresaleCampaignAddProductVariantsInput

Description

Input for adding product variants to a presale campaign.

Fields
Input Field Description
id - GlobalID The campaigns's ID.
productVariantIds - [SharedGlobalID!]! The product variants to be added to the campaign
Example
{
  "id": GlobalID,
  "productVariantIds": [SharedGlobalID]
}

PresaleCampaignAddProductsInput

Description

Input for adding products to a presale campaign.

Fields
Input Field Description
id - GlobalID The campaigns's ID.
productIds - [SharedGlobalID!] The products that are included in the campaign
Example
{
  "id": GlobalID,
  "productIds": [SharedGlobalID]
}

PresaleCampaignApplyBulkInventoryInput

Description

Specifies the input fields required to apply bulk inventory to a presale campaign.

Fields
Input Field Description
campaignId - GlobalID! The presale campaign ID.
inventoryApplications - [PresaleCampaignApplyInventoryBaseInput!]! The campaign inventory items and quantities which should be applied
Example
{
  "campaignId": GlobalID,
  "inventoryApplications": [
    PresaleCampaignApplyInventoryBaseInput
  ]
}

PresaleCampaignApplyInventoryBaseInput

Description

Specifies the base input fields required to apply inventory to a presale campaign.

Fields
Input Field Description
campaignInventoryItemId - GlobalID! The campaign inventory item for which inventory is being applied
quantityReceived - Int! The number of units available to be allocated
Example
{
  "campaignInventoryItemId": GlobalID,
  "quantityReceived": 987
}

PresaleCampaignApplyInventoryInput

Description

Specifies the input fields required to apply inventory to a presale campaign.

Fields
Input Field Description
campaignId - GlobalID! The presale campaign ID.
campaignInventoryItemId - GlobalID! The campaign inventory item for which inventory is being applied
quantityReceived - PositiveInteger! The number of units available to be allocated
Example
{
  "campaignId": GlobalID,
  "campaignInventoryItemId": GlobalID,
  "quantityReceived": PositiveInteger
}

PresaleCampaignArchiveInput

Description

Specifies the input fields required to archive a presale campaign.

Fields
Input Field Description
id - GlobalID! ID of the presale campaign to archive.
Example
{"id": GlobalID}

PresaleCampaignCancelInput

Description

Specifies the input fields required to cancel a presale campaign.

Fields
Input Field Description
id - GlobalID! ID of the presale campaign to cancel.
Example
{"id": GlobalID}

PresaleCampaignCreateInput

Description

Input for creating a presale campaign.

Fields
Input Field Description
deposit - CampaignDepositInput The campaign deposit
description - String The campaign description
endAt - ISO8601DateTime! The date the presale will end
fulfilAt - ISO8601DateTime The date the presale will be fulfilled
gracePeriodHours - Int! The number of hours a customer has to rectify a failed presale campaign payment before their campaign order is cancelled.
launchAt - ISO8601DateTime! The date the presale will be launched
limit - Int! The maximum number of units of the linked products that can be sold
name - String The name of the campaign
productIds - [SharedGlobalID!] The products that are included in the campaign
productVariantIds - [SharedGlobalID!] The product variants that are included in the campaign
reference - String! The campaign reference
Example
{
  "deposit": CampaignDepositInput,
  "description": "xyz789",
  "endAt": ISO8601DateTime,
  "fulfilAt": ISO8601DateTime,
  "gracePeriodHours": 123,
  "launchAt": ISO8601DateTime,
  "limit": 123,
  "name": "abc123",
  "productIds": [SharedGlobalID],
  "productVariantIds": [SharedGlobalID],
  "reference": "abc123"
}

PresaleCampaignDeleteInput

Description

Specifies the input fields required to delete a presale campaign.

Fields
Input Field Description
id - GlobalID! ID of the presale campaign to delete.
Example
{"id": GlobalID}

PresaleCampaignEndInput

Description

Specifies the input fields required to end a presale campaign.

Fields
Input Field Description
id - GlobalID! ID of the presale campaign to end.
Example
{"id": GlobalID}

PresaleCampaignFulfilInput

Description

Specifies the input fields required to fulfil a presale campaign.

Fields
Input Field Description
id - GlobalID! ID of the presale campaign to fulfil.
Example
{"id": GlobalID}

PresaleCampaignLaunchInput

Description

Specifies the input fields required to launch a presale campaign.

Fields
Input Field Description
id - GlobalID! ID of the presale campaign to launch.
Example
{"id": GlobalID}

PresaleCampaignRemoveProductVariantsInput

Description

Input for removing product variants from a presale campaign.

Fields
Input Field Description
id - GlobalID The campaigns's ID.
productVariantIds - [SharedGlobalID!] The product variants to be removed from the campaign
Example
{
  "id": GlobalID,
  "productVariantIds": [SharedGlobalID]
}

PresaleCampaignRemoveProductsInput

Description

Input for removing products from a presale campaign.

Fields
Input Field Description
id - GlobalID The campaigns's ID.
productIds - [SharedGlobalID!] The products to be removed from the campaign
Example
{
  "id": GlobalID,
  "productIds": [SharedGlobalID]
}

PresaleCampaignUnarchiveInput

Description

Specifies the input fields required to unarchive a presale campaign.

Fields
Input Field Description
id - GlobalID! ID of the presale campaign to unarchive.
Example
{"id": GlobalID}

PresaleCampaignUpdateInput

Description

Input for updating a presale campaign.

Fields
Input Field Description
deposit - CampaignDepositInput The campaign deposit
description - String The campaign description
endAt - ISO8601DateTime The date the presale will end
fulfilAt - ISO8601DateTime The date the presale will be fulfilled
gracePeriodHours - Int The number of hours a customer has to rectify a failed presale campaign payment before their campaign order is cancelled.
id - GlobalID! The campaign's ID.
launchAt - ISO8601DateTime The date the presale will be launched
limit - Int The maximum number of units of the linked products that can be sold
name - String The name of the campaign
productIds - [SharedGlobalID!] The products that are included in the campaign
productVariantIds - [SharedGlobalID!] The product variants to be added to the campaign
reference - String The campaign reference
Example
{
  "deposit": CampaignDepositInput,
  "description": "abc123",
  "endAt": ISO8601DateTime,
  "fulfilAt": ISO8601DateTime,
  "gracePeriodHours": 123,
  "id": GlobalID,
  "launchAt": ISO8601DateTime,
  "limit": 123,
  "name": "abc123",
  "productIds": [SharedGlobalID],
  "productVariantIds": [SharedGlobalID],
  "reference": "xyz789"
}

PresalesConfigSetInput

Description

Input for configuring settings for presales.

Fields
Input Field Description
allowDepositUpdatesOnLaunchedPresales - Boolean
campaignPaymentTermsAlignment - CampaignPaymentTermsAlignment
defaultCurrency - CurrencyCode
defaultPresaleDeposit - CampaignDepositInput
metafieldUpdateInterval - Int
refundPresalesDepositsOnCancellation - Boolean
templateForCrowdfundSellingPlanDescription - String
templateForCrowdfundSellingPlanName - String
templateForPresaleSellingPlanDescription - String
templateForPresaleSellingPlanName - String
Example
{
  "allowDepositUpdatesOnLaunchedPresales": true,
  "campaignPaymentTermsAlignment": "FIRST_CAMPAIGN",
  "defaultCurrency": "AED",
  "defaultPresaleDeposit": CampaignDepositInput,
  "metafieldUpdateInterval": 123,
  "refundPresalesDepositsOnCancellation": false,
  "templateForCrowdfundSellingPlanDescription": "abc123",
  "templateForCrowdfundSellingPlanName": "xyz789",
  "templateForPresaleSellingPlanDescription": "abc123",
  "templateForPresaleSellingPlanName": "xyz789"
}

PriceCalculationCollectionPerformInput

Fields
Input Field Description
resources - [PricingResourceInput!]!
Example
{"resources": [PricingResourceInput]}

PriceCalculationPerformInput

Description

Specifies the input fields required to perform a price calculation.

Fields
Input Field Description
enginePolicy - PriceEnginePolicy The engine policy to perform the price calculation
engineType - PriceEngineType The engine type to perform the price calculation
id - GlobalID The ID of the price calculation
resource - PricingResourceInput! The price calculation's resource.
Example
{
  "enginePolicy": "ALWAYS",
  "engineType": "SHOPIFY",
  "id": GlobalID,
  "resource": PricingResourceInput
}

PriceEngineCreateInput

Description

Specifies the input fields required to create a price engine.

Fields
Input Field Description
config - ShopifyPriceEngineConfigInput! The price engine's config.
engineType - PriceEngineType! The price engine's type.
Example
{
  "config": ShopifyPriceEngineConfigInput,
  "engineType": "SHOPIFY"
}

PriceEngineUpdateInput

Description

Specifies the input fields required to update a price engine.

Fields
Input Field Description
config - ShopifyPriceEngineConfigInput The price engine's config.
id - GlobalID! The price engine's ID.
Example
{
  "config": ShopifyPriceEngineConfigInput,
  "id": GlobalID
}

PriceSourceRegisterInput

Description

Specifies the input fields required to register a price source.

Fields
Input Field Description
engineType - PriceEngineType The price source's engine type.
resource - PricingResourceInput! The price source's resource.
source - PricingSourceInput! The price source's source.
Example
{
  "engineType": "SHOPIFY",
  "resource": PricingResourceInput,
  "source": PricingSourceInput
}

PricingConfigSetInput

Description

Input for configuring settings for pricing.

Fields
Input Field Description
defaultPriceEngine - PriceEngineProvider
defaultPriceEnginePolicy - PriceEnginePolicy
moneyRoundingMode - MoneyRoundingMode
shippingTaxable - Boolean
taxBehaviour - TaxBehaviour
Example
{
  "defaultPriceEngine": "SHOPIFY",
  "defaultPriceEnginePolicy": "ALWAYS",
  "moneyRoundingMode": "ROUND_CEILING",
  "shippingTaxable": true,
  "taxBehaviour": "EXCLUSIVE"
}

PricingResourceInput

Description

Specifies the input fields required to create a pricing resource.

Fields
Input Field Description
campaignOrderGroup - CampaignOrderGroupDataInput
id - ID! The resource's ID
subscriptionOrder - SubscriptionOrderDataInput
type - PricingResourceType! The resource's type
Example
{
  "campaignOrderGroup": CampaignOrderGroupDataInput,
  "id": 4,
  "subscriptionOrder": SubscriptionOrderDataInput,
  "type": "CAMPAIGN_ORDER_GROUP"
}

PricingSourceInput

Description

Specifies the input fields required to create a pricing source.

Fields
Input Field Description
data - PricingSourceDataInput! The source's data
id - ID! The source's ID
type - PricingSourceType! The source's type
Example
{
  "data": PricingSourceDataInput,
  "id": "4",
  "type": "CALCULATED_DRAFT_ORDER"
}

ProductCollectionCreateInput

Description

Input for creating a product collection.

Fields
Input Field Description
externalId - String! The product collection's external ID.
id - GlobalID The product collection's ID.
imageUrl - String The product collection's image URL.
products - [ProductCollectionItemCreateInput!] The input to create product collection items.
status - ProductCollectionStatus! The product collection's status.
title - String The product collection's title.
Example
{
  "externalId": "xyz789",
  "id": GlobalID,
  "imageUrl": "xyz789",
  "products": [ProductCollectionItemCreateInput],
  "status": "DELETED",
  "title": "abc123"
}

ProductCollectionDeleteInput

Description

Input for deleting a product collection.

Fields
Input Field Description
id - GlobalID! The product collections's ID.
Example
{"id": GlobalID}

ProductCollectionItemCreateInput

Description

Input for creating product collection item.

Fields
Input Field Description
collectionItemExternalId - String The product collection item's external ID.
externalId - String! The product's external ID.
Example
{
  "collectionItemExternalId": "xyz789",
  "externalId": "abc123"
}

ProductCollectionItemUpdateInput

Description

Input for updating product collection item.

Fields
Input Field Description
collectionItemExternalId - String The product collection item's external ID.
externalId - String! The product's external ID.
Example
{
  "collectionItemExternalId": "abc123",
  "externalId": "xyz789"
}

ProductCollectionItemUpsertInput

Description

Input for upserting product collection item.

Fields
Input Field Description
collectionItemExternalId - String The product collection item's external ID.
externalId - String! The product's external ID.
Example
{
  "collectionItemExternalId": "abc123",
  "externalId": "abc123"
}

ProductCollectionUpdateInput

Description

Input for updating a product collection.

Fields
Input Field Description
externalId - String The product collection's external ID.
id - GlobalID! The product collection's ID.
imageUrl - String The product collection's image URL.
products - [ProductCollectionItemUpdateInput!] The input to update product collection items.
status - ProductCollectionStatus! The product collection's status.
title - String The product collection's title.
Example
{
  "externalId": "xyz789",
  "id": GlobalID,
  "imageUrl": "abc123",
  "products": [ProductCollectionItemUpdateInput],
  "status": "DELETED",
  "title": "xyz789"
}

ProductCollectionUpsertInput

Description

Input for upserting a product collection.

Fields
Input Field Description
externalId - String! The product collection's external ID.
id - GlobalID The product collection's ID.
imageUrl - String The product collection's image URL.
products - [ProductCollectionItemUpsertInput!]! The input to create product collection items.
status - ProductCollectionStatus! The product collection's status.
title - String The product collection's title.
Example
{
  "externalId": "xyz789",
  "id": GlobalID,
  "imageUrl": "abc123",
  "products": [ProductCollectionItemUpsertInput],
  "status": "DELETED",
  "title": "xyz789"
}

ProductCreateInput

Description

Input for creating a product.

Fields
Input Field Description
externalId - String! The product's external ID.
imageUrl - String The product's image URL.
productVariants - [ProductVariantCreateInput!] The product's variants.
status - ProductStatus! The product's status.
title - String The product's title.
Example
{
  "externalId": "xyz789",
  "imageUrl": "abc123",
  "productVariants": [ProductVariantCreateInput],
  "status": "DELETED",
  "title": "xyz789"
}

ProductDeleteInput

Description

Input for deleting a product.

Fields
Input Field Description
id - GlobalID! The product's ID.
Example
{"id": GlobalID}

ProductUpdateInput

Description

Input for updating a product.

Fields
Input Field Description
externalId - String The product's external ID.
id - GlobalID! The product's ID.
imageUrl - String The product's image URL.
title - String The product's title.
Example
{
  "externalId": "xyz789",
  "id": GlobalID,
  "imageUrl": "abc123",
  "title": "abc123"
}

ProductUpsertInput

Description

Input for upserting a product.

Fields
Input Field Description
externalId - String The product's external ID.
id - GlobalID The customer's ID.
imageUrl - String The product's image URL.
productVariants - [ProductVariantUpsertInput!] The product's variants.
status - ProductStatus The product's status.
title - String The product's title.
Example
{
  "externalId": "abc123",
  "id": GlobalID,
  "imageUrl": "abc123",
  "productVariants": [ProductVariantUpsertInput],
  "status": "DELETED",
  "title": "abc123"
}

ProductVariantCreateInput

Description

Input for creating a product variant.

Fields
Input Field Description
externalId - String! The variant's external ID.
imageUrl - String The variant's image URL.
productId - GlobalID The ID of the parent product.
shippable - Boolean! Whether the variant requires shipping.
sku - String The variant's SKU
status - ProductStatus The variant's status.
taxable - Boolean! Whether a tax is charged when the variant is sold.
title - String Whether the customer is liable for sales tax.
weightGrams - Int The variant's weight in grams.
Example
{
  "externalId": "abc123",
  "imageUrl": "abc123",
  "productId": GlobalID,
  "shippable": true,
  "sku": "abc123",
  "status": "DELETED",
  "taxable": true,
  "title": "abc123",
  "weightGrams": 123
}

ProductVariantDeleteInput

Description

Input for deleting a product variant.

Fields
Input Field Description
id - GlobalID! The variant's ID.
Example
{"id": GlobalID}

ProductVariantUpdateInput

Description

Input for updating a product variant.

Fields
Input Field Description
externalId - String The variant's external ID.
id - GlobalID! The product variant's ID.
imageUrl - String The variant's image URL.
shippable - Boolean Whether the variant requires shipping.
sku - String The variant's SKU
taxable - Boolean Whether a tax is charged when the variant is sold.
title - String The variant's title.
weightGrams - Int The variant's weight in grams.
Example
{
  "externalId": "xyz789",
  "id": GlobalID,
  "imageUrl": "abc123",
  "shippable": true,
  "sku": "xyz789",
  "taxable": false,
  "title": "abc123",
  "weightGrams": 987
}

ProductVariantUpsertInput

Description

Input for updating a product variant.

Fields
Input Field Description
externalId - String The variant's external ID.
id - GlobalID The product variant's ID.
imageUrl - String The variant's image URL.
price - MoneyInput The variant's price
shippable - Boolean Whether the variant requires shipping.
sku - String The variant's SKU
status - ProductVariantStatus The variant's status.
taxable - Boolean Whether a tax is charged when the variant is sold.
title - String The variant's title.
weightGrams - Int The variant's weight in grams.
Example
{
  "externalId": "abc123",
  "id": GlobalID,
  "imageUrl": "abc123",
  "price": MoneyInput,
  "shippable": false,
  "sku": "xyz789",
  "status": "DELETED",
  "taxable": true,
  "title": "abc123",
  "weightGrams": 123
}

RefundProcessInput

Description

The input required to process a refund

Fields
Input Field Description
amount - MoneyInput The money object
description - String The refund description
metadata - MetadataInput Unstructured key/value pairs
paymentIntentId - GlobalID! The payment intent ID
Example
{
  "amount": MoneyInput,
  "description": "xyz789",
  "metadata": MetadataInput,
  "paymentIntentId": GlobalID
}

RefundRecordInput

Description

The input required to record a refund

Fields
Input Field Description
amount - MoneyInput The money object
chargeId - GlobalID The parent charge ID
description - String The refund description
metadata - MetadataInput Unstructured key/value pairs
paymentIntentId - GlobalID! The payment intent ID
Example
{
  "amount": MoneyInput,
  "chargeId": GlobalID,
  "description": "xyz789",
  "metadata": MetadataInput,
  "paymentIntentId": GlobalID
}

ShopifyCredentialsCreateInput

Description

Input for storing Shopify credentials.

Fields
Input Field Description
accessToken - String! The Shopify access token.
shopifyDomain - String! The shop's shopify sub-domain.
Example
{
  "accessToken": "xyz789",
  "shopifyDomain": "abc123"
}

ShopifyPriceEngineConfigInput

Description

Specifies the input fields required to create a price engine config for Shopify.

Fields
Input Field Description
apiTokens - [String!]! The config's API tokens.
storeName - String! The config's store name.
Example
{
  "apiTokens": ["abc123"],
  "storeName": "abc123"
}

SubscriptionAnchorInput

Fields
Input Field Description
day - Int!
month - Int
time - String
type - SubscriptionAnchorType!
Example
{
  "day": 987,
  "month": 123,
  "time": "abc123",
  "type": "MONTHDAY"
}

SubscriptionBacklogInput

Description

Translation missing: en.graphql.inputs.subscription_backlog_input.description

Fields
Input Field Description
interval - SubscriptionBacklogInterval! Translation missing: en.graphql.inputs.subscription_backlog_input.arguments.interval
intervalCount - Int! Translation missing: en.graphql.inputs.subscription_backlog_input.arguments.interval_count
Example
{"interval": "CYCLE", "intervalCount": 987}

SubscriptionBillingBehaviourInput

Fields
Input Field Description
billingOffset - SubscriptionOffsetInput!
processingOffset - SubscriptionOffsetInput!
Example
{
  "billingOffset": SubscriptionOffsetInput,
  "processingOffset": SubscriptionOffsetInput
}

SubscriptionDataInput

Fields
Input Field Description
externalId - String!
id - ID!
Example
{
  "externalId": "abc123",
  "id": "4"
}

SubscriptionDeliveryBehaviourInput

Fields
Input Field Description
fixed - SubscriptionFixedDeliveryBehaviourInput
type - SubscriptionDeliveryBehaviourType!
Example
{
  "fixed": SubscriptionFixedDeliveryBehaviourInput,
  "type": "FIXED"
}

SubscriptionDeliveryMethodInput

Fields
Input Field Description
address - AddressInput
shippingOption - SubscriptionDeliveryShippingOptionInput
type - SubscriptionDeliveryMethodType!
Example
{
  "address": AddressInput,
  "shippingOption": SubscriptionDeliveryShippingOptionInput,
  "type": "LOCAL"
}

SubscriptionDeliveryShippingOptionInput

Fields
Input Field Description
code - String!
description - String
source - String!
title - String!
Example
{
  "code": "abc123",
  "description": "abc123",
  "source": "abc123",
  "title": "xyz789"
}

SubscriptionFixedDeliveryBehaviourInput

Fields
Input Field Description
anchor - SubscriptionAnchorInput!
cutoff - SubscriptionOffsetInput!
preAnchorBehaviour - SubscriptionDeliveryPreAnchorBehaviourType!
Example
{
  "anchor": SubscriptionAnchorInput,
  "cutoff": SubscriptionOffsetInput,
  "preAnchorBehaviour": "ASAP"
}

SubscriptionFrequencyInput

Fields
Input Field Description
interval - SubscriptionInterval!
intervalCount - Int!
maxCycles - Int
minCycles - Int
Example
{"interval": "DAY", "intervalCount": 123, "maxCycles": 123, "minCycles": 123}

SubscriptionInventoryBehaviourInput

Fields
Input Field Description
inventoryDecrementPolicy - SubscriptionInventoryDecrementPolicy!
outOfStockPolicy - SubscriptionInventoryOutOfStockPolicy!
Example
{"inventoryDecrementPolicy": "NONE", "outOfStockPolicy": "PAUSE_SUBSCRIPTION"}

SubscriptionItemAddInput

Description

Translation missing: en.graphql.inputs.subscription_item_add_input.description

Fields
Input Field Description
productVariantId - SharedGlobalID! Translation missing: en.graphql.inputs.subscription_item_add_input.arguments.product_variant_id
quantity - NonZeroCount! Translation missing: en.graphql.inputs.subscription_item_add_input.arguments.quantity
subscriptionId - GlobalID! Translation missing: en.graphql.inputs.subscription_item_add_input.arguments.subscription_id
Example
{
  "productVariantId": SharedGlobalID,
  "quantity": NonZeroCount,
  "subscriptionId": GlobalID
}

SubscriptionLineItemDataInput

Description

Subscription line item data.

Fields
Input Field Description
basePrice - MoneyInput
externalId - ID
itemType - SubscriptionLineItemDataItemType
parentExternalId - ID
productId - ID!
productVariantId - ID!
quantity - Int!
subscriptionOrderItemId - ID!
Example
{
  "basePrice": MoneyInput,
  "externalId": 4,
  "itemType": "ONE_OFF",
  "parentExternalId": 4,
  "productId": 4,
  "productVariantId": "4",
  "quantity": 987,
  "subscriptionOrderItemId": "4"
}

SubscriptionOffsetInput

Fields
Input Field Description
interval - SubscriptionOffsetInterval!
intervalCount - Int!
type - SubscriptionOffsetType!
Example
{"interval": "DAY", "intervalCount": 987, "type": "BUSINESS"}

SubscriptionOrderDataInput

Fields
Input Field Description
currency - CurrencyCode!
cycleIndex - CycleIndex!
deliveryMethod - SubscriptionDeliveryMethodInput!
lineItems - [SubscriptionLineItemDataInput!]!
pricingBehaviour - SubscriptionPricingBehaviourInput
subscription - SubscriptionDataInput!
Example
{
  "currency": "AED",
  "cycleIndex": CycleIndex,
  "deliveryMethod": SubscriptionDeliveryMethodInput,
  "lineItems": [SubscriptionLineItemDataInput],
  "pricingBehaviour": SubscriptionPricingBehaviourInput,
  "subscription": SubscriptionDataInput
}

SubscriptionOrderItemAddInput

Description

Translation missing: en.graphql.inputs.subscription_order_item_add_input.description

Fields
Input Field Description
productVariantId - SharedGlobalID! Translation missing: en.graphql.inputs.subscription_order_item_add_input.arguments.product_variant_id
quantity - NonZeroCount! Translation missing: en.graphql.inputs.subscription_order_item_add_input.arguments.quantity
subscriptionOrderId - GlobalID! Translation missing: en.graphql.inputs.subscription_order_item_add_input.arguments.subscription_order_id
Example
{
  "productVariantId": SharedGlobalID,
  "quantity": NonZeroCount,
  "subscriptionOrderId": GlobalID
}

SubscriptionOrderProcessInput

Description

Translation missing: en.graphql.inputs.subscription_order_process_input.description

Fields
Input Field Description
id - GlobalID! Translation missing: en.graphql.inputs.subscription_order_process_input.arguments.id
Example
{"id": GlobalID}

SubscriptionOrderSkipInput

Description

Translation missing: en.graphql.inputs.subscription_order_skip_input.description

Fields
Input Field Description
count - NonZeroCount Translation missing: en.graphql.inputs.subscription_order_skip_input.arguments.count. Default = 1
id - GlobalID! Translation missing: en.graphql.inputs.subscription_order_skip_input.arguments.id
reason - String Translation missing: en.graphql.inputs.subscription_order_skip_input.arguments.reason
Example
{
  "count": NonZeroCount,
  "id": GlobalID,
  "reason": "abc123"
}

SubscriptionOrderUnskipInput

Description

Translation missing: en.graphql.inputs.subscription_order_unskip_input.description

Fields
Input Field Description
id - GlobalID! Translation missing: en.graphql.inputs.subscription_order_unskip_input.arguments.id
Example
{"id": GlobalID}

SubscriptionOrderUpdateInput

Description

Translation missing: en.graphql.inputs.subscription_order_update_input.description

Fields
Input Field Description
id - GlobalID! Translation missing: en.graphql.inputs.subscription_order_update_input.arguments.id
paymentMethodId - GlobalID Translation missing: en.graphql.inputs.subscription_order_update_input.arguments.payment_method_id
Example
{
  "id": GlobalID,
  "paymentMethodId": GlobalID
}

SubscriptionPlanCreateInput

Fields
Input Field Description
billingBehaviour - SubscriptionBillingBehaviourInput
deliveryBehaviour - SubscriptionDeliveryBehaviourInput
frequency - SubscriptionFrequencyInput!
inventoryBehaviour - SubscriptionInventoryBehaviourInput
name - String!
position - Int The name of the subscription plan.
pricingBehaviour - SubscriptionPricingBehaviourInput
Example
{
  "billingBehaviour": SubscriptionBillingBehaviourInput,
  "deliveryBehaviour": SubscriptionDeliveryBehaviourInput,
  "frequency": SubscriptionFrequencyInput,
  "inventoryBehaviour": SubscriptionInventoryBehaviourInput,
  "name": "xyz789",
  "position": 987,
  "pricingBehaviour": SubscriptionPricingBehaviourInput
}

SubscriptionPlanGroupCreateInput

Description

Input for creating a subscription plan group.

Fields
Input Field Description
billingBehaviour - SubscriptionBillingBehaviourInput!
deliveryBehaviour - SubscriptionDeliveryBehaviourInput!
inventoryBehaviour - SubscriptionInventoryBehaviourInput!
name - String! The name of the subscription plan group.
pricingBehaviour - SubscriptionPricingBehaviourInput!
productGroup - SubscriptionProductGroupInput!
reference - String! The subscription plan group reference.
subscriptionPlans - [SubscriptionPlanCreateInput!]!
Example
{
  "billingBehaviour": SubscriptionBillingBehaviourInput,
  "deliveryBehaviour": SubscriptionDeliveryBehaviourInput,
  "inventoryBehaviour": SubscriptionInventoryBehaviourInput,
  "name": "xyz789",
  "pricingBehaviour": SubscriptionPricingBehaviourInput,
  "productGroup": SubscriptionProductGroupInput,
  "reference": "abc123",
  "subscriptionPlans": [SubscriptionPlanCreateInput]
}

SubscriptionPriceDiscountInput

Fields
Input Field Description
afterCycle - Count
value - SubscriptionPriceDiscountValueInput!
valueCap - SubscriptionPriceDiscountValueCapInput
Example
{
  "afterCycle": Count,
  "value": SubscriptionPriceDiscountValueInput,
  "valueCap": SubscriptionPriceDiscountValueCapInput
}

SubscriptionPriceDiscountValueCapInput

Fields
Input Field Description
cap - MoneyInput!
type - SubscriptionPriceDiscountValueCapType!
Example
{"cap": MoneyInput, "type": "INDIVIDUAL_ITEM"}

SubscriptionPriceDiscountValueInput

Fields
Input Field Description
fixedAmount - MoneyInput
percentage - Percentage
type - SubscriptionPriceDiscountType!
Example
{
  "fixedAmount": MoneyInput,
  "percentage": Percentage,
  "type": "FIXED_AMOUNT"
}

SubscriptionPricingBehaviourInput

Fields
Input Field Description
basePrice - MoneyInput
basePricePolicy - SubscriptionBasePricePolicy!
discounts - [SubscriptionPriceDiscountInput!]
Example
{
  "basePrice": MoneyInput,
  "basePricePolicy": "CUSTOM",
  "discounts": [SubscriptionPriceDiscountInput]
}

SubscriptionProductGroupInput

Fields
Input Field Description
itemSources - [SubscriptionProductGroupItemSourceInput!]!
Example
{"itemSources": [SubscriptionProductGroupItemSourceInput]}

SubscriptionProductGroupItemSourceInput

Fields
Input Field Description
productCollectionId - SharedGlobalID
productId - SharedGlobalID
productVariantId - SharedGlobalID
Example
{
  "productCollectionId": SharedGlobalID,
  "productId": SharedGlobalID,
  "productVariantId": SharedGlobalID
}

SubscriptionRetryPolicyInput

Description

Translation missing: en.graphql.inputs.subscription_retry_policy_input.description

Fields
Input Field Description
interval - SubscriptionRetryInterval! Translation missing: en.graphql.inputs.subscription_retry_policy_input.arguments.interval
intervalCount - Int! Translation missing: en.graphql.inputs.subscription_retry_policy_input.arguments.interval_count
maxAttempts - Int! Translation missing: en.graphql.inputs.subscription_retry_policy_input.arguments.max_attempts
Example
{"interval": "DAY", "intervalCount": 987, "maxAttempts": 987}

SubscriptionSetFrequencyInput

Description

Translation missing: en.graphql.inputs.subscription_set_frequency_input.description

Fields
Input Field Description
id - GlobalID! Translation missing: en.graphql.inputs.subscription_set_frequency_input.arguments.id
subscriptionPlanId - GlobalID! Translation missing: en.graphql.inputs.subscription_set_frequency_input.arguments.subscription_plan_id
Example
{
  "id": GlobalID,
  "subscriptionPlanId": GlobalID
}

SubscriptionsConfigSetInput

Description

Input for configuring settings for subscriptions.

Fields
Input Field Description
defaultPaymentRetryPolicy - SubscriptionRetryPolicyInput
defaultSubscriptionBacklogSize - SubscriptionBacklogInput
permittedFrequencyIntervals - [SubscriptionInterval!]
permittedRetryIntervals - [SubscriptionRetryInterval!]
subscriptionEngine - SubscriptionEngine
Example
{
  "defaultPaymentRetryPolicy": SubscriptionRetryPolicyInput,
  "defaultSubscriptionBacklogSize": SubscriptionBacklogInput,
  "permittedFrequencyIntervals": ["DAY"],
  "permittedRetryIntervals": ["DAY"],
  "subscriptionEngine": "NOOP"
}

TimeOffsetInput

Description

Input for creating a time offset in a notification schedule.

Fields
Input Field Description
direction - TimeOffsetDirection! The direction to offset in.
magnitude - Int! The magnitude to offset by.
unit - TimeOffsetUnit! The unit of time to offset by.
Example
{"direction": "BEFORE", "magnitude": 987, "unit": "DAYS"}

WebhookCreateInput

Description

Input for creating a webhook subscription.

Fields
Input Field Description
topic - WebhookTopic! The webhooks's topic (eg. CHARGE_FAILED).
url - Url! The webhooks url path
Example
{"topic": "CAMPAIGN_ORDER_CANCELLED", "url": Url}

WebhookDeleteInput

Description

Input for deleting a webhook subscription.

Fields
Input Field Description
id - GlobalID! The webhooks ID
Example
{"id": GlobalID}

WebhookUpdateInput

Description

Input for updating a webhook subscription.

Fields
Input Field Description
id - GlobalID! The ID of the webhook to update.
status - WebhookStatus The webhooks status
url - Url The webhooks url path
Example
{
  "id": GlobalID,
  "status": "ACTIVE",
  "url": Url
}

Objects

AccessToken

Description

An access token.

Fields
Field Name Description
token - String! Access token.
tokenType - AccessTokenType! The type of access token (eg. organisation).
Example
{"token": "abc123", "tokenType": "CHANNEL"}

Address

Fields
Field Name Description
address1 - String!
address2 - String
city - String!
countryCode - CountryCode!
provinceCode - String!
zip - String!
Example
{
  "address1": "xyz789",
  "address2": "abc123",
  "city": "xyz789",
  "countryCode": "AD",
  "provinceCode": "abc123",
  "zip": "abc123"
}

CampaignData

Description

Campaign data.

Fields
Field Name Description
deposit - CampaignDeposit!
id - ID! The campaign's ID.
type - CampaignType! The campaign's type.
Example
{
  "deposit": CampaignDeposit,
  "id": 4,
  "type": "CROWDFUNDING"
}

CampaignDeposit

Description

A campaign deposit.

Fields
Field Name Description
type - CampaignDepositType
value - Float
Example
{"type": "PERCENTAGE", "value": 987.65}

CampaignInventoryItem

Description

A campaign inventory item.

Fields
Field Name Description
allocatedCount - Int! The total amount of inventory currently allocated to the campaign inventory item.
appliedCount - Int! The total amount of inventory currently applied to the campaign inventory item.
campaignItem - CampaignItem! The campaign item.
id - ID! The ID of the campaign inventory item
inventoryApplications - [InventoryApplication!] The item's inventory applications.
productVariant - ProductVariant! The product variant
reservedCount - Int! The total amount of inventory currently reserved on the campaign inventory item.
Example
{
  "allocatedCount": 123,
  "appliedCount": 987,
  "campaignItem": CampaignItem,
  "id": 4,
  "inventoryApplications": [InventoryApplication],
  "productVariant": ProductVariant,
  "reservedCount": 123
}

CampaignItem

Description

A campaign item.

Fields
Field Name Description
allocatedCount - Int! The reserved count.
appliedCount - Int! The applied count.
campaignInventoryItems - [CampaignInventoryItem!] The campaign item's campaign inventory items.
id - GlobalID! The id of the campaign item
reservedCount - Int! The reserved count.
resource - CampaignItemResource! The campaign item resource.
Example
{
  "allocatedCount": 123,
  "appliedCount": 987,
  "campaignInventoryItems": [CampaignInventoryItem],
  "id": GlobalID,
  "reservedCount": 123,
  "resource": Product
}

CampaignOrderData

Description

Campaign order data.

Fields
Field Name Description
campaign - CampaignData! The campaign order's campaign.
cancelled - Boolean! Indicates if the campaign order is cancelled.
id - ID! ID of the campaign order.
lineItem - LineItemData! The campaign order's line item.
Example
{
  "campaign": CampaignData,
  "cancelled": false,
  "id": 4,
  "lineItem": LineItemData
}

CampaignOrderFinancials

Description

The financial details of a campaign order.

Fields
Field Name Description
currency - CurrencyCode!
discountedUnitPrice - Money!
discounts - DiscountFinancials!
itemPrice - Money!
shipping - ShippingFinancials!
subtotal - Money!
tax - TaxFinancials!
totalDeposit - Money!
totalPrice - Money!
unitPrice - Money!
Example
{
  "currency": "AED",
  "discountedUnitPrice": Money,
  "discounts": DiscountFinancials,
  "itemPrice": Money,
  "shipping": ShippingFinancials,
  "subtotal": Money,
  "tax": TaxFinancials,
  "totalDeposit": Money,
  "totalPrice": Money,
  "unitPrice": Money
}

CampaignOrderGroupData

Fields
Field Name Description
campaignOrders - [CampaignOrderData!]! The products which are included in the campaign
cancelled - Boolean! Indicates if the resource is cancelled.
customerId - ID! The customer who owns this group
externalId - String! The campaign order group's external ID.
Example
{
  "campaignOrders": [CampaignOrderData],
  "cancelled": false,
  "customerId": "4",
  "externalId": "abc123"
}

CampaignOrderGroupFinancials

Description

The financial details of a campaign order group.

Fields
Field Name Description
currency - CurrencyCode!
discounts - DiscountFinancials!
shipping - ShippingFinancials!
subtotal - Money!
tax - TaxFinancials!
totalDeposit - Money!
totalPrice - Money!
Example
{
  "currency": "AED",
  "discounts": DiscountFinancials,
  "shipping": ShippingFinancials,
  "subtotal": Money,
  "tax": TaxFinancials,
  "totalDeposit": Money,
  "totalPrice": Money
}

CampaignOrderGroupMilestones

Fields
Field Name Description
createdAt - ISO8601DateTime!
dueAt - ISO8601DateTime
updatedAt - ISO8601DateTime!
Example
{
  "createdAt": ISO8601DateTime,
  "dueAt": ISO8601DateTime,
  "updatedAt": ISO8601DateTime
}

CampaignOrderMilestones

Fields
Field Name Description
allocatedAt - ISO8601DateTime
cancelledAt - ISO8601DateTime
completedAt - ISO8601DateTime
createdAt - ISO8601DateTime!
dueAt - ISO8601DateTime
fulfilmentAllocatedAt - ISO8601DateTime
fulfilmentFailedAt - ISO8601DateTime
fulfilmentFulfilledAt - ISO8601DateTime
fulfilmentHeldAt - ISO8601DateTime
fulfilmentOpenedAt - ISO8601DateTime
fulfilmentReturnedAt - ISO8601DateTime
fulfilmentSubmittedAt - ISO8601DateTime
paidAt - ISO8601DateTime
paymentIntentFailedAt - ISO8601DateTime
paymentIntentPaidAt - ISO8601DateTime
paymentIntentPartiallyRefundedAt - ISO8601DateTime
paymentIntentRefundedAt - ISO8601DateTime
paymentIntentSubmittedAt - ISO8601DateTime
retryPaymentAt - ISO8601DateTime
updatedAt - ISO8601DateTime!
Example
{
  "allocatedAt": ISO8601DateTime,
  "cancelledAt": ISO8601DateTime,
  "completedAt": ISO8601DateTime,
  "createdAt": ISO8601DateTime,
  "dueAt": ISO8601DateTime,
  "fulfilmentAllocatedAt": ISO8601DateTime,
  "fulfilmentFailedAt": ISO8601DateTime,
  "fulfilmentFulfilledAt": ISO8601DateTime,
  "fulfilmentHeldAt": ISO8601DateTime,
  "fulfilmentOpenedAt": ISO8601DateTime,
  "fulfilmentReturnedAt": ISO8601DateTime,
  "fulfilmentSubmittedAt": ISO8601DateTime,
  "paidAt": ISO8601DateTime,
  "paymentIntentFailedAt": ISO8601DateTime,
  "paymentIntentPaidAt": ISO8601DateTime,
  "paymentIntentPartiallyRefundedAt": ISO8601DateTime,
  "paymentIntentRefundedAt": ISO8601DateTime,
  "paymentIntentSubmittedAt": ISO8601DateTime,
  "retryPaymentAt": ISO8601DateTime,
  "updatedAt": ISO8601DateTime
}

Card

Description

A credit/debit card.

Fields
Field Name Description
brand - CardBrand! The card brand.
expiry - CardExpiry! The card expiry.
externalId - String The (optional) external ID of the card.
last4 - String! The last four digits of the card number.
Example
{
  "brand": "AMEX",
  "expiry": CardExpiry,
  "externalId": "xyz789",
  "last4": "abc123"
}

CardExpiry

Description

Card expiry

Fields
Field Name Description
month - Int Expiry month
year - Int Expiry year
Example
{"month": 123, "year": 987}

Customer

Description

A customer.

Fields
Field Name Description
channel - Channel! The customer's channel.
email - String The customer's email
externalId - String! The customer's external ID.
firstName - String The customer's first name.
id - GlobalID! The customer's ID.
lastName - String The customer's last name.
phone - String The customer's phone
status - CustomerStatus! The customer's status.
taxable - Boolean! Whether the customer is liable for sales tax.
notifications - NotificationConnection Notifications relevant to this customer
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

campaignOrdersCount - Int The number of campaign orders the customer has.
subscriptionsCount - Count!
Example
{
  "channel": Channel,
  "email": "xyz789",
  "externalId": "xyz789",
  "firstName": "xyz789",
  "id": GlobalID,
  "lastName": "xyz789",
  "phone": "xyz789",
  "status": "ACTIVE",
  "taxable": true,
  "notifications": NotificationConnection,
  "campaignOrdersCount": 987,
  "subscriptionsCount": Count
}

DiscountFinancials

Fields
Field Name Description
breakdown - [DiscountLine!]!
total - Money!
Example
{
  "breakdown": [DiscountLine],
  "total": Money
}

DiscountLine

Fields
Field Name Description
price - Money!
title - String
type - DiscountType
Example
{
  "price": Money,
  "title": "abc123",
  "type": "AUTOMATIC"
}

ExternalToken

Description

external token

Fields
Field Name Description
id - GlobalID! id
primary - Boolean! primary
status - TokenStatus! status
target - TokenTarget! target
token - RedactedString! token
Example
{
  "id": GlobalID,
  "primary": false,
  "status": "ACTIVE",
  "target": "ANY",
  "token": RedactedString
}

InventoryApplication

Description

The inventory application of a campaign.

Fields
Field Name Description
campaignInventoryItem - CampaignInventoryItem! The parent inventory item
createdAt - ISO8601DateTime! The creation time
id - GlobalID! The id of the inventory application
quantityAllocated - Int! Number of units that have been allocated to orders
quantityReceived - Int! Number of units that have been received
sequentialId - Int! The ordered ID of the inventory application.
Example
{
  "campaignInventoryItem": CampaignInventoryItem,
  "createdAt": ISO8601DateTime,
  "id": GlobalID,
  "quantityAllocated": 987,
  "quantityReceived": 987,
  "sequentialId": 123
}

LineItem

Description

A line item.

Fields
Field Name Description
externalId - String! The line item's external ID.
id - GlobalID! The line item's ID.
order - Order! The order that this line item belongs to.
product - Product The product.
productVariant - ProductVariant The product variant.
Example
{
  "externalId": "xyz789",
  "id": GlobalID,
  "order": Order,
  "product": Product,
  "productVariant": ProductVariant
}

LineItemData

Description

Line item data.

Fields
Field Name Description
externalId - ID! The line item's external ID.
productId - ID! The line item's product ID.
productVariantId - ID! The line item's product variant ID.
quantity - Int! The line item's quantity.
Example
{
  "externalId": "4",
  "productId": "4",
  "productVariantId": 4,
  "quantity": 123
}

MailingAddress

Description

An organisation's mailing address.

Fields
Field Name Description
address1 - String! Line 1 of mailing address .
address2 - String Line 2 of mailing address.
city - String! The name of the city, district, village, or town.
company - String The name of the organisation's company.
country - String! The name of the country.
countryCode - CountryCode! The two-letter code for the country of the address.
phone - String Phone number
province - String The region of the address
provinceCode - String The code for the region of the address
zip - String! The zip or postal code of the address.
Example
{
  "address1": "xyz789",
  "address2": "abc123",
  "city": "abc123",
  "company": "xyz789",
  "country": "xyz789",
  "countryCode": "AD",
  "phone": "xyz789",
  "province": "xyz789",
  "provinceCode": "xyz789",
  "zip": "xyz789"
}

Money

Description

A money object.

Fields
Field Name Description
amount - String! The money object's amount.
currency - CurrencyCode! The money object's currency code.
Example
{"amount": "abc123", "currency": "AED"}

Notification

Description

A notification.

Fields
Field Name Description
channel - Channel! The channel this notification belongs to.
createdAt - ISO8601DateTime! The time the notification was created
customer - Customer! The customer this notification is for.
deliveredAt - ISO8601DateTime The time the notification was delivered
deliveryFailedAt - ISO8601DateTime The time the notification failed delivery
deliveryMechanism - NotificationDeliveryMechanism! The delivery mechanism.
deliveryStatus - NotificationDeliveryStatus! The delivery status.
errorMessage - String A notification delivery error message.
event - String! The event to notify
id - GlobalID! The notification's ID.
payload - JSON! The payload.
scheduledNotification - ScheduledNotification The scheduled notification that triggered this notification
updatedAt - ISO8601DateTime! The time the notification was last updated
Example
{
  "channel": Channel,
  "createdAt": ISO8601DateTime,
  "customer": Customer,
  "deliveredAt": ISO8601DateTime,
  "deliveryFailedAt": ISO8601DateTime,
  "deliveryMechanism": "EMAIL",
  "deliveryStatus": "FAILED",
  "errorMessage": "xyz789",
  "event": "abc123",
  "id": GlobalID,
  "payload": {},
  "scheduledNotification": ScheduledNotification,
  "updatedAt": ISO8601DateTime
}

NotificationSchedule

Description

A notification schedule.

Fields
Field Name Description
anchor - ISO8601DateTime! The schedule's anchor date.
channel - Channel! The channel this notification schedule belongs to.
createdAt - ISO8601DateTime! The time the notification schedule was created
customer - Customer! The customer this notification schedule is for.
deliveryMechanism - NotificationDeliveryMechanism! The delivery mechanism.
event - String! The event to notify
id - GlobalID! The schedule's ID.
payload - JSON! The payload to deliver.
schedule - [TimeOffset!]! The schedule.
scheduledNotifications - ScheduledNotificationConnection The scheduled notifications
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

before - String

Returns the elements in the list that come before the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

updatedAt - ISO8601DateTime! The time the notification schedule was last updated
Example
{
  "anchor": ISO8601DateTime,
  "channel": Channel,
  "createdAt": ISO8601DateTime,
  "customer": Customer,
  "deliveryMechanism": "EMAIL",
  "event": "xyz789",
  "id": GlobalID,
  "payload": {},
  "schedule": [TimeOffset],
  "scheduledNotifications": ScheduledNotificationConnection,
  "updatedAt": ISO8601DateTime
}

NotificationScheduleTemplate

Description

A notification schedule template.

Fields
Field Name Description
schedule - [TimeOffset!]! The schedule.
trigger - NotificationScheduleTrigger! The trigger event that the notification schedule is anchored to.
Example
{"schedule": [TimeOffset], "trigger": "CROWDFUND_END_AT"}

NotificationsConfig

Description

Channel configuration for Submarine notifications.

Fields
Field Name Description
emailCustomerWhenCampaignDueDateIsUpdated - Boolean
emailCustomerWhenCampaignIsOrdered - Boolean
emailMerchantOnWebhookFailure - Boolean
emailMerchantWhenCampaignOrderCannotBeFulfilled - Boolean
notificationSchedules - [NotificationScheduleTemplate!]
Example
{
  "emailCustomerWhenCampaignDueDateIsUpdated": false,
  "emailCustomerWhenCampaignIsOrdered": true,
  "emailMerchantOnWebhookFailure": false,
  "emailMerchantWhenCampaignOrderCannotBeFulfilled": false,
  "notificationSchedules": [NotificationScheduleTemplate]
}

Order

Description

An order.

Fields
Field Name Description
channel - Channel! The order's channel.
externalId - String! The order's external ID.
id - GlobalID! The order's ID.
lineItems - [LineItem!]! The order's line items.
name - String The order's name.
Example
{
  "channel": Channel,
  "externalId": "xyz789",
  "id": GlobalID,
  "lineItems": [LineItem],
  "name": "abc123"
}

PageInfo

Description

Pagination details for a connection.

Fields
Field Name Description
endCursor - String When paginating forwards, the cursor to continue.
hasNextPage - Boolean! When paginating forwards, are there more items?
hasPreviousPage - Boolean! When paginating backwards, are there more items?
startCursor - String When paginating backwards, the cursor to continue.
Example
{
  "endCursor": "xyz789",
  "hasNextPage": false,
  "hasPreviousPage": false,
  "startCursor": "xyz789"
}

PaymentInstrument

Description

A Submarine payment instrument.

Fields
Field Name Description
active - Boolean!
createdAt - ISO8601DateTime! The date and time when the payment instrument was created.
externalId - String The (optional) external ID of the instrument.
externalReference - String An optional reference to the external payment processor.
id - GlobalID! The ID of the payment instrument.
manuallyCapturable - Boolean! Whether payment can be captured manually.
metadata - Metadata Unstructured key/value pairs.
paymentInstrumentType - PaymentInstrumentType! The payment instrument's type.
paymentMethod - PaymentMethod! The parent payment method.
paymentProcessor - PaymentProcessor! The payment processor to be used for this instrument.
paymentSource - PaymentSource The source of the payment instrument.
updatedAt - ISO8601DateTime The date and time when the payment instrument was last updated.
Example
{
  "active": false,
  "createdAt": ISO8601DateTime,
  "externalId": "abc123",
  "externalReference": "abc123",
  "id": GlobalID,
  "manuallyCapturable": true,
  "metadata": Metadata,
  "paymentInstrumentType": "CARD",
  "paymentMethod": PaymentMethod,
  "paymentProcessor": PaymentProcessor,
  "paymentSource": Card,
  "updatedAt": ISO8601DateTime
}

PaymentIntentAdjustment

Description

A payment intent adjustment

Fields
Field Name Description
amount - Money The amount to adjust the payment intent by
createdAt - ISO8601DateTime! payment intent adjustment creation time
description - String Description of the payment intent adjustment
id - GlobalID! ID of the payment intent adjustment
metadata - Metadata Unstructured key/value pairs
paymentIntent - PaymentIntent! The associated payment intent
updatedAt - ISO8601DateTime payment intent adjustment last updated at
Example
{
  "amount": Money,
  "createdAt": ISO8601DateTime,
  "description": "abc123",
  "id": GlobalID,
  "metadata": Metadata,
  "paymentIntent": PaymentIntent,
  "updatedAt": ISO8601DateTime
}

PaymentProcessor

Description

A payment processor

Fields
Field Name Description
id - GlobalID! ID of the payment processor
name - String! Name of the payment processor
Example
{
  "id": GlobalID,
  "name": "xyz789"
}

PaypalBillingAgreement

Description

A Paypal billing agreement.

Fields
Field Name Description
accountEmail - String The account email.
accountName - String! The account name.
externalId - String The (optional) external ID of the agreement.
Example
{
  "accountEmail": "abc123",
  "accountName": "xyz789",
  "externalId": "abc123"
}

PlatformConfig

Description

Channel configuration for Submarine.

Fields
Field Name Description
channel - Channel! The config's channel.
notifications - NotificationsConfig
presales - PresalesConfig
pricing - PricingConfig
subscriptions - SubscriptionsConfig
Example
{
  "channel": Channel,
  "notifications": NotificationsConfig,
  "presales": PresalesConfig,
  "pricing": PricingConfig,
  "subscriptions": SubscriptionsConfig
}

PresalesConfig

Description

Channel configuration for Submarine presales.

Fields
Field Name Description
allowDepositUpdatesOnLaunchedPresales - Boolean
campaignPaymentTermsAlignment - CampaignPaymentTermsAlignment
defaultCurrency - CurrencyCode
defaultPresaleDeposit - CampaignDeposit
metafieldUpdateInterval - Int
refundPresalesDepositsOnCancellation - Boolean
templateForCrowdfundSellingPlanDescription - String
templateForCrowdfundSellingPlanName - String
templateForPresaleSellingPlanDescription - String
templateForPresaleSellingPlanName - String
templateForSellingPlanDescription - String
templateForSellingPlanName - String
Example
{
  "allowDepositUpdatesOnLaunchedPresales": true,
  "campaignPaymentTermsAlignment": "FIRST_CAMPAIGN",
  "defaultCurrency": "AED",
  "defaultPresaleDeposit": CampaignDeposit,
  "metafieldUpdateInterval": 123,
  "refundPresalesDepositsOnCancellation": true,
  "templateForCrowdfundSellingPlanDescription": "abc123",
  "templateForCrowdfundSellingPlanName": "abc123",
  "templateForPresaleSellingPlanDescription": "xyz789",
  "templateForPresaleSellingPlanName": "xyz789",
  "templateForSellingPlanDescription": "abc123",
  "templateForSellingPlanName": "abc123"
}

PriceCalculation

Description

A price calculation.

Fields
Field Name Description
id - GlobalID! The ID of the price calculation
priceSource - PriceSource! The price calculation's price source.
resource - PricingResource! The price calculation's resource.
sequentialId - Int! The ordered ID of the price calculation.
status - PriceCalculationStatus! The price calculation's status (eg. pending).
Example
{
  "id": GlobalID,
  "priceSource": PriceSource,
  "resource": PricingResource,
  "sequentialId": 987,
  "status": "CALCULATED"
}

PriceEngine

Description

A price engine.

Fields
Field Name Description
engineType - PriceEngineType! The price engine's type.
id - GlobalID! The ID of the price engine
shopifyEngineConfig - ShopifyPriceEngineConfig! The price engine's config for Shopify.
Example
{
  "engineType": "SHOPIFY",
  "id": GlobalID,
  "shopifyEngineConfig": ShopifyPriceEngineConfig
}

PriceSource

Description

A price source.

Fields
Field Name Description
engineType - PriceEngineType! The price source's engine type.
id - GlobalID! The price source's ID
resource - PricingResource! The price source's resource.
sequentialId - Int! The ordered ID of the price calculation.
source - PricingSource! The price source's source.
Example
{
  "engineType": "SHOPIFY",
  "id": GlobalID,
  "resource": PricingResource,
  "sequentialId": 123,
  "source": PricingSource
}

PricingConfig

Description

Channel configuration for Submarine pricing.

Fields
Field Name Description
defaultPriceEngine - PriceEngineProvider
defaultPriceEnginePolicy - PriceEnginePolicy
moneyRoundingMode - MoneyRoundingMode
shippingTaxable - Boolean
taxBehaviour - TaxBehaviour
Example
{
  "defaultPriceEngine": "SHOPIFY",
  "defaultPriceEnginePolicy": "ALWAYS",
  "moneyRoundingMode": "ROUND_CEILING",
  "shippingTaxable": true,
  "taxBehaviour": "EXCLUSIVE"
}

PricingResource

Description

The pricing resource

Fields
Field Name Description
data - PricingResourceData The resource's data
id - ID! The resource's ID
type - PricingResourceType! The resource's type
Example
{
  "data": CampaignOrderGroupData,
  "id": "4",
  "type": "CAMPAIGN_ORDER_GROUP"
}

PricingSource

Description

The pricing source

Fields
Field Name Description
data - PricingSourceData The source's data
id - ID! The source's ID
type - PricingSourceType! The source's type
Example
{
  "data": PricingSourceData,
  "id": 4,
  "type": "CALCULATED_DRAFT_ORDER"
}

ProductCollection

Description

A product collection.

Fields
Field Name Description
channel - Channel! The product collection's channel.
externalId - String! The product collection's external ID.
id - GlobalID! The product collection's ID.
imageUrl - String The product collection's image url.
items - [ProductCollectionItem!]! The product collection's items.
status - ProductCollectionStatus! The product collection's status.
title - String The product collection's title.
Example
{
  "channel": Channel,
  "externalId": "xyz789",
  "id": GlobalID,
  "imageUrl": "xyz789",
  "items": [ProductCollectionItem],
  "status": "DELETED",
  "title": "abc123"
}

ProductCollectionItem

Description

A product collection item.

Fields
Field Name Description
externalId - String The item's external ID.
id - GlobalID! The item's ID.
product - Product! The product this item belongs to.
productCollection - ProductCollection! The product collection this item belongs to.
status - ProductCollectionItemStatus! The item's status.
Example
{
  "externalId": "abc123",
  "id": GlobalID,
  "product": Product,
  "productCollection": ProductCollection,
  "status": "ACTIVE"
}

ScheduledNotification

Description

A scheduled notification.

Fields
Field Name Description
channel - Channel! The channel this scheduled notification belongs to.
createdAt - ISO8601DateTime! The time the scheduled notification was created
customer - Customer! The customer this scheduled notification is for.
deliverAt - ISO8601DateTime! The delivery date.
enqueuedAt - ISO8601DateTime! The date the notification was enqueued for delivery.
id - GlobalID! The scheduled notification's ID.
notificationSchedule - NotificationSchedule! The parent notification schedule.
status - ScheduledNotificationStatus! The status
updatedAt - ISO8601DateTime! The time the scheduled notification was last updated
Example
{
  "channel": Channel,
  "createdAt": ISO8601DateTime,
  "customer": Customer,
  "deliverAt": ISO8601DateTime,
  "enqueuedAt": ISO8601DateTime,
  "id": GlobalID,
  "notificationSchedule": NotificationSchedule,
  "status": "DELETED",
  "updatedAt": ISO8601DateTime
}

ShippingFinancials

Fields
Field Name Description
breakdown - [ShippingLine!]!
total - Money!
Example
{
  "breakdown": [ShippingLine],
  "total": Money
}

ShippingLine

Fields
Field Name Description
code - String!
price - Money!
source - String!
title - String!
Example
{
  "code": "abc123",
  "price": Money,
  "source": "xyz789",
  "title": "abc123"
}

ShopifyCredentials

Description

Shopify credentials

Fields
Field Name Description
createdAt - ISO8601DateTime! Shopify credentials creation time
id - GlobalID! The Shopify credentials's ID.
updatedAt - ISO8601DateTime! Shopify credentials update time
Example
{
  "createdAt": ISO8601DateTime,
  "id": GlobalID,
  "updatedAt": ISO8601DateTime
}

ShopifyPriceEngineConfig

Description

The price engine's config for Shopify.

Fields
Field Name Description
apiTokens - [String!]! The API tokens.
storeName - String! The store name.
Example
{
  "apiTokens": ["xyz789"],
  "storeName": "abc123"
}

SubscriptionAnchor

Fields
Field Name Description
day - Int!
month - Int
time - ISO8601DateTime
type - SubscriptionAnchorType!
Example
{
  "day": 123,
  "month": 987,
  "time": ISO8601DateTime,
  "type": "MONTHDAY"
}

SubscriptionBacklogSize

Description

Translation missing: en.graphql.objects.subscription_backlog_size.description

Fields
Field Name Description
interval - SubscriptionBacklogInterval! Translation missing: en.graphql.objects.subscription_backlog_size.fields.interval
intervalCount - Int! Translation missing: en.graphql.objects.subscription_backlog_size.fields.interval_count
Example
{"interval": "CYCLE", "intervalCount": 987}

SubscriptionBillingBehaviour

Fields
Field Name Description
billingOffset - SubscriptionOffset
processingOffset - SubscriptionOffset
Example
{
  "billingOffset": SubscriptionOffset,
  "processingOffset": SubscriptionOffset
}

SubscriptionData

Fields
Field Name Description
externalId - String
id - ID
Example
{"externalId": "abc123", "id": 4}

SubscriptionDeliveryBehaviour

Fields
Field Name Description
fixed - SubscriptionFixedDeliveryBehaviour!
type - SubscriptionDeliveryBehaviourType!
Example
{
  "fixed": SubscriptionFixedDeliveryBehaviour,
  "type": "FIXED"
}

SubscriptionDeliveryMethod

Fields
Field Name Description
address - Address
shippingOption - SubscriptionDeliveryShippingOption
type - SubscriptionDeliveryMethodType!
Example
{
  "address": Address,
  "shippingOption": SubscriptionDeliveryShippingOption,
  "type": "LOCAL"
}

SubscriptionDeliveryShippingOption

Fields
Field Name Description
code - String!
description - String
source - String!
title - String!
Example
{
  "code": "abc123",
  "description": "xyz789",
  "source": "abc123",
  "title": "abc123"
}

SubscriptionFixedDeliveryBehaviour

Fields
Field Name Description
anchor - SubscriptionAnchor
cutoff - SubscriptionOffset
preAnchorBehaviour - SubscriptionDeliveryPreAnchorBehaviourType
Example
{
  "anchor": SubscriptionAnchor,
  "cutoff": SubscriptionOffset,
  "preAnchorBehaviour": "ASAP"
}

SubscriptionFrequency

Fields
Field Name Description
interval - SubscriptionInterval!
intervalCount - Int!
maxCycles - Int
minCycles - Int
Example
{"interval": "DAY", "intervalCount": 987, "maxCycles": 987, "minCycles": 123}

SubscriptionInventoryBehaviour

Fields
Field Name Description
inventoryDecrementPolicy - SubscriptionInventoryDecrementPolicy!
outOfStockPolicy - SubscriptionInventoryOutOfStockPolicy!
Example
{"inventoryDecrementPolicy": "NONE", "outOfStockPolicy": "PAUSE_SUBSCRIPTION"}

SubscriptionItem

Fields
Field Name Description
basePrice - Money
createdAt - ISO8601DateTime The date the subscription was created.
id - GlobalID! The ID of the subscription item.
product - Product!
productVariant - ProductVariant!
quantity - Count!
subscription - Subscription!
updatedAt - ISO8601DateTime The date the subscription was last updated.
Example
{
  "basePrice": Money,
  "createdAt": ISO8601DateTime,
  "id": GlobalID,
  "product": Product,
  "productVariant": ProductVariant,
  "quantity": Count,
  "subscription": Subscription,
  "updatedAt": ISO8601DateTime
}

SubscriptionLineItemData

Description

Subscription line item data.

Fields
Field Name Description
basePrice - Money
externalId - ID
itemType - SubscriptionLineItemDataItemType
parentExternalId - ID
productId - ID!
productVariantId - ID!
quantity - Int!
subscriptionOrderItemId - ID!
Example
{
  "basePrice": Money,
  "externalId": "4",
  "itemType": "ONE_OFF",
  "parentExternalId": 4,
  "productId": 4,
  "productVariantId": "4",
  "quantity": 987,
  "subscriptionOrderItemId": 4
}

SubscriptionOffset

Fields
Field Name Description
interval - SubscriptionOffsetInterval!
intervalCount - Int!
type - SubscriptionOffsetType!
Example
{"interval": "DAY", "intervalCount": 123, "type": "BUSINESS"}

SubscriptionOrderData

Fields
Field Name Description
currency - CurrencyCode
cycleIndex - CycleIndex
deliveryMethod - SubscriptionDeliveryMethod
lineItems - [SubscriptionLineItemData!]
pricingBehaviour - SubscriptionPricingBehaviour
subscription - SubscriptionData
Example
{
  "currency": "AED",
  "cycleIndex": CycleIndex,
  "deliveryMethod": SubscriptionDeliveryMethod,
  "lineItems": [SubscriptionLineItemData],
  "pricingBehaviour": SubscriptionPricingBehaviour,
  "subscription": SubscriptionData
}

SubscriptionOrderFinancials

Description

The financial details of a subscription order.

Fields
Field Name Description
currency - CurrencyCode!
discounts - DiscountFinancials!
shipping - ShippingFinancials!
subtotal - Money!
tax - TaxFinancials!
totalPrice - Money!
Example
{
  "currency": "AED",
  "discounts": DiscountFinancials,
  "shipping": ShippingFinancials,
  "subtotal": Money,
  "tax": TaxFinancials,
  "totalPrice": Money
}

SubscriptionOrderItem

Fields
Field Name Description
createdAt - ISO8601DateTime The date the subscription was created.
financials - SubscriptionOrderItemFinancials
id - GlobalID! The ID of the subscription.
itemType - SubscriptionOrderItemItem!
lineItem - LineItem
product - Product!
productVariant - ProductVariant!
quantity - Count!
subscriptionItem - SubscriptionItem
subscriptionOrder - SubscriptionOrder!
updatedAt - ISO8601DateTime The date the subscription was last updated.
Example
{
  "createdAt": ISO8601DateTime,
  "financials": SubscriptionOrderItemFinancials,
  "id": GlobalID,
  "itemType": "ONE_OFF",
  "lineItem": LineItem,
  "product": Product,
  "productVariant": ProductVariant,
  "quantity": Count,
  "subscriptionItem": SubscriptionItem,
  "subscriptionOrder": SubscriptionOrder,
  "updatedAt": ISO8601DateTime
}

SubscriptionOrderItemFinancials

Description

The financial details of a subscription order item.

Fields
Field Name Description
currency - CurrencyCode!
discounts - DiscountFinancials!
itemPrice - Money!
Arguments
afterDiscounts - Boolean
afterTax - Boolean
tax - TaxFinancials!
unitPrice - Money!
Arguments
afterDiscounts - Boolean
afterTax - Boolean
Example
{
  "currency": "AED",
  "discounts": DiscountFinancials,
  "itemPrice": Money,
  "tax": TaxFinancials,
  "unitPrice": Money
}

SubscriptionPlan

Fields
Field Name Description
billingBehaviour - SubscriptionBillingBehaviour!
createdAt - ISO8601DateTime The date the subscription plan was created.
deliveryBehaviour - SubscriptionDeliveryBehaviour!
frequency - SubscriptionFrequency!
id - GlobalID! The ID of the subscription plan.
inventoryBehaviour - SubscriptionInventoryBehaviour!
name - String! The name of the subscription plan.
position - Int! The name of the subscription plan.
pricingBehaviour - SubscriptionPricingBehaviour!
status - SubscriptionPlanStatus! The subscription plan's status.
subscriptionPlanGroup - SubscriptionPlanGroup!
updatedAt - ISO8601DateTime The date the subscription plan was last updated.
Example
{
  "billingBehaviour": SubscriptionBillingBehaviour,
  "createdAt": ISO8601DateTime,
  "deliveryBehaviour": SubscriptionDeliveryBehaviour,
  "frequency": SubscriptionFrequency,
  "id": GlobalID,
  "inventoryBehaviour": SubscriptionInventoryBehaviour,
  "name": "abc123",
  "position": 123,
  "pricingBehaviour": SubscriptionPricingBehaviour,
  "status": "ACTIVE",
  "subscriptionPlanGroup": SubscriptionPlanGroup,
  "updatedAt": ISO8601DateTime
}

SubscriptionPriceDiscount

Fields
Field Name Description
afterCycle - Count
value - SubscriptionPriceDiscountValue
valueCap - SubscriptionPriceDiscountValueCap
Example
{
  "afterCycle": Count,
  "value": SubscriptionPriceDiscountValue,
  "valueCap": SubscriptionPriceDiscountValueCap
}

SubscriptionPriceDiscountValue

Fields
Field Name Description
fixedAmount - Money
percentage - Percentage
type - SubscriptionPriceDiscountType
Example
{
  "fixedAmount": Money,
  "percentage": Percentage,
  "type": "FIXED_AMOUNT"
}

SubscriptionPriceDiscountValueCap

Fields
Field Name Description
cap - Money
type - SubscriptionPriceDiscountValueCapType
Example
{"cap": Money, "type": "INDIVIDUAL_ITEM"}

SubscriptionPricingBehaviour

Fields
Field Name Description
basePrice - Money
basePricePolicy - SubscriptionBasePricePolicy!
discounts - [SubscriptionPriceDiscount!]
Example
{
  "basePrice": Money,
  "basePricePolicy": "CUSTOM",
  "discounts": [SubscriptionPriceDiscount]
}

SubscriptionProductGroup

Fields
Field Name Description
id - GlobalID!
itemSources - [SubscriptionProductGroupItemSource!]
Example
{
  "id": GlobalID,
  "itemSources": [SubscriptionProductGroupItemSource]
}

SubscriptionProductGroupItem

Example
{
  "id": GlobalID,
  "itemSource": SubscriptionProductGroupItemSource,
  "productGroup": SubscriptionProductGroup,
  "resource": Product,
  "status": "ACTIVE"
}

SubscriptionProductGroupItemSource

Example
{
  "id": GlobalID,
  "items": [SubscriptionProductGroupItem],
  "productGroup": SubscriptionProductGroup,
  "resource": Product,
  "status": "ACTIVE"
}

SubscriptionRetryPolicy

Description

Translation missing: en.graphql.objects.subscription_retry_policy.description

Fields
Field Name Description
interval - SubscriptionRetryInterval! Translation missing: en.graphql.objects.subscription_retry_policy.fields.interval
intervalCount - Int! Translation missing: en.graphql.objects.subscription_retry_policy.fields.interval_count
maxAttempts - Int! Translation missing: en.graphql.objects.subscription_retry_policy.fields.max_attempts
Example
{"interval": "DAY", "intervalCount": 987, "maxAttempts": 987}

SubscriptionsConfig

Description

Channel configuration for Submarine subscriptions.

Fields
Field Name Description
defaultPaymentRetryPolicy - SubscriptionRetryPolicy
defaultSubscriptionBacklogSize - SubscriptionBacklogSize
permittedFrequencyIntervals - [SubscriptionInterval!]
permittedRetryIntervals - [SubscriptionRetryInterval!]
subscriptionEngine - SubscriptionEngine
Example
{
  "defaultPaymentRetryPolicy": SubscriptionRetryPolicy,
  "defaultSubscriptionBacklogSize": SubscriptionBacklogSize,
  "permittedFrequencyIntervals": ["DAY"],
  "permittedRetryIntervals": ["DAY"],
  "subscriptionEngine": "NOOP"
}

TaxFinancials

Fields
Field Name Description
behaviour - TaxBehaviour!
breakdown - [TaxLine!]!
total - Money!
Example
{
  "behaviour": "EXCLUSIVE",
  "breakdown": [TaxLine],
  "total": Money
}

TaxLine

Fields
Field Name Description
price - Money!
rate - Float!
title - String!
Example
{
  "price": Money,
  "rate": 987.65,
  "title": "abc123"
}

TimeOffset

Description

A time offset in a notification schedule.

Fields
Field Name Description
direction - TimeOffsetDirection! The direction to offset in.
magnitude - Int! The magnitude to offset by.
unit - TimeOffsetUnit! The unit of time to offset by.
Example
{"direction": "BEFORE", "magnitude": 123, "unit": "DAYS"}

TotalUnitsCrowdfundingGoal

Description

A total units crowdfunding goal.

Fields
Field Name Description
goalTotalUnits - Int! The campaign's goal total units.
goalType - CrowdfundingGoalType! The campaign's goal type.
Example
{"goalTotalUnits": 987, "goalType": "TOTAL_UNITS"}

TotalValueCrowdfundingGoal

Description

A total value crowdfunding goal.

Fields
Field Name Description
goalTotalValue - Money! The campaign's goal total value.
goalType - CrowdfundingGoalType! The campaign's goal type.
Example
{"goalTotalValue": Money, "goalType": "TOTAL_UNITS"}

UserError

Description

A user-readable error.

Fields
Field Name Description
field - [String!]! The path to the input field that caused the error.
message - String! The error message.
Example
{
  "field": ["abc123"],
  "message": "abc123"
}

Payloads

AccessTokenCreatePayload

Description

Autogenerated return type of AccessTokenCreate.

Fields
Field Name Description
accessToken - AccessToken The newly created access token.
userErrors - [UserError!]! A list of errors from interactor.
Example
{
  "accessToken": AccessToken,
  "userErrors": [UserError]
}

CampaignOrderCancelPayload

Description

Autogenerated return type of CampaignOrderCancel.

Fields
Field Name Description
campaignOrder - CampaignOrder The cancelled campaign order.
userErrors - [UserError!]! A list of user errors.
Example
{
  "campaignOrder": CampaignOrder,
  "userErrors": [UserError]
}

CampaignOrderCreatePayload

Description

Autogenerated return type of CampaignOrderCreate.

Fields
Field Name Description
campaignOrder - CampaignOrder The newly created campaign order.
userErrors - [UserError!]! A list of user errors.
Example
{
  "campaignOrder": CampaignOrder,
  "userErrors": [UserError]
}

CampaignOrderDecreaseQuantityPayload

Description

Autogenerated return type of CampaignOrderDecreaseQuantity.

Fields
Field Name Description
campaignOrder - CampaignOrder The updated campaign order.
userErrors - [UserError!]! A list of user errors.
Example
{
  "campaignOrder": CampaignOrder,
  "userErrors": [UserError]
}

CampaignOrderGroupCancelPayload

Description

Autogenerated return type of CampaignOrderGroupCancel.

Fields
Field Name Description
campaignOrderGroup - CampaignOrderGroup The cancelled campaign order group.
userErrors - [UserError!]! A list of user errors.
Example
{
  "campaignOrderGroup": CampaignOrderGroup,
  "userErrors": [UserError]
}

CampaignOrderGroupCreatePayload

Description

Autogenerated return type of CampaignOrderGroupCreate.

Fields
Field Name Description
campaignOrderGroup - CampaignOrderGroup The newly created campaign order.
userErrors - [UserError!]! A list of user errors.
Example
{
  "campaignOrderGroup": CampaignOrderGroup,
  "userErrors": [UserError]
}

CampaignOrderGroupRetryPaymentPayload

Description

Autogenerated return type of CampaignOrderGroupRetryPayment.

Fields
Field Name Description
campaignOrderGroup - CampaignOrderGroup The campaign order group submitted for payment.
userErrors - [UserError!]! A list of user errors.
Example
{
  "campaignOrderGroup": CampaignOrderGroup,
  "userErrors": [UserError]
}

CampaignOrderRetryFulfilmentPayload

Description

Autogenerated return type of CampaignOrderRetryFulfilment.

Fields
Field Name Description
campaignOrder - CampaignOrder The campaign order submitted for fulfilment.
userErrors - [UserError!]! A list of user errors.
Example
{
  "campaignOrder": CampaignOrder,
  "userErrors": [UserError]
}

CampaignOrderRetryPaymentPayload

Description

Autogenerated return type of CampaignOrderRetryPayment.

Fields
Field Name Description
campaignOrder - CampaignOrder The campaign order submitted for payment.
userErrors - [UserError!]! A list of user errors.
Example
{
  "campaignOrder": CampaignOrder,
  "userErrors": [UserError]
}

ChannelConfigSetPayload

Description

Autogenerated return type of ChannelConfigSet.

Fields
Field Name Description
channel - Channel The channel whose config was set.
userErrors - [UserError!]! A list of user errors.
Example
{
  "channel": Channel,
  "userErrors": [UserError]
}

ChannelCreatePayload

Description

Autogenerated return type of ChannelCreate.

Fields
Field Name Description
channel - Channel The newly created channel.
userErrors - [UserError!]! A list of user errors.
Example
{
  "channel": Channel,
  "userErrors": [UserError]
}

ChannelUpdatePayload

Description

Autogenerated return type of ChannelUpdate.

Fields
Field Name Description
channel - Channel The updated channel.
userErrors - [UserError!]! The list of errors that occurred from executing the mutation.
Example
{
  "channel": Channel,
  "userErrors": [UserError]
}

ChargeCapturePayload

Description

Autogenerated return type of ChargeCapture.

Fields
Field Name Description
charge - Charge The newly created charge.
userErrors - [UserError!]! A list of user errors.
Example
{
  "charge": Charge,
  "userErrors": [UserError]
}

ChargeRecordPayload

Description

Autogenerated return type of ChargeRecord.

Fields
Field Name Description
charge - Charge The newly created charge.
userErrors - [UserError!]! A list of user errors.
Example
{
  "charge": Charge,
  "userErrors": [UserError]
}

CrowdfundingCampaignAddProductVariantsPayload

Description

Autogenerated return type of CrowdfundingCampaignAddProductVariants.

Fields
Field Name Description
crowdfundingCampaign - CrowdfundingCampaign The newly updated crowdfunding campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "crowdfundingCampaign": CrowdfundingCampaign,
  "userErrors": [UserError]
}

CrowdfundingCampaignAddProductsPayload

Description

Autogenerated return type of CrowdfundingCampaignAddProducts.

Fields
Field Name Description
crowdfundingCampaign - CrowdfundingCampaign The newly updated crowdfunding campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "crowdfundingCampaign": CrowdfundingCampaign,
  "userErrors": [UserError]
}

CrowdfundingCampaignApplyBulkInventoryPayload

Description

Autogenerated return type of CrowdfundingCampaignApplyBulkInventory.

Fields
Field Name Description
crowdfundingCampaign - CrowdfundingCampaign The crowdfunding campaign for which inventory should be applied.
userErrors - [UserError!]! A list of user errors.
Example
{
  "crowdfundingCampaign": CrowdfundingCampaign,
  "userErrors": [UserError]
}

CrowdfundingCampaignApplyInventoryPayload

Description

Autogenerated return type of CrowdfundingCampaignApplyInventory.

Fields
Field Name Description
crowdfundingCampaign - CrowdfundingCampaign The crowdfunding campaign for which inventory has been applied.
userErrors - [UserError!]! A list of user errors.
Example
{
  "crowdfundingCampaign": CrowdfundingCampaign,
  "userErrors": [UserError]
}

CrowdfundingCampaignArchivePayload

Description

Autogenerated return type of CrowdfundingCampaignArchive.

Fields
Field Name Description
crowdfundingCampaign - CrowdfundingCampaign The archived crowdfunding campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "crowdfundingCampaign": CrowdfundingCampaign,
  "userErrors": [UserError]
}

CrowdfundingCampaignCancelPayload

Description

Autogenerated return type of CrowdfundingCampaignCancel.

Fields
Field Name Description
crowdfundingCampaign - CrowdfundingCampaign The Canceled crowdfunding campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "crowdfundingCampaign": CrowdfundingCampaign,
  "userErrors": [UserError]
}

CrowdfundingCampaignCreatePayload

Description

Autogenerated return type of CrowdfundingCampaignCreate.

Fields
Field Name Description
crowdfundingCampaign - CrowdfundingCampaign The newly created crowdfunding campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "crowdfundingCampaign": CrowdfundingCampaign,
  "userErrors": [UserError]
}

CrowdfundingCampaignDeletePayload

Description

Autogenerated return type of CrowdfundingCampaignDelete.

Fields
Field Name Description
deletedCrowdfundingCampaignId - GlobalID The ID of the deleted crowdfunding campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "deletedCrowdfundingCampaignId": GlobalID,
  "userErrors": [UserError]
}

CrowdfundingCampaignEndPayload

Description

Autogenerated return type of CrowdfundingCampaignEnd.

Fields
Field Name Description
crowdfundingCampaign - CrowdfundingCampaign The ended crowdfunding campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "crowdfundingCampaign": CrowdfundingCampaign,
  "userErrors": [UserError]
}

CrowdfundingCampaignFulfilPayload

Description

Autogenerated return type of CrowdfundingCampaignFulfil.

Fields
Field Name Description
crowdfundingCampaign - CrowdfundingCampaign The fulfilling crowdfunding campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "crowdfundingCampaign": CrowdfundingCampaign,
  "userErrors": [UserError]
}

CrowdfundingCampaignLaunchPayload

Description

Autogenerated return type of CrowdfundingCampaignLaunch.

Fields
Field Name Description
crowdfundingCampaign - CrowdfundingCampaign The launched crowdfunding campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "crowdfundingCampaign": CrowdfundingCampaign,
  "userErrors": [UserError]
}

CrowdfundingCampaignRemoveProductVariantsPayload

Description

Autogenerated return type of CrowdfundingCampaignRemoveProductVariants.

Fields
Field Name Description
crowdfundingCampaign - CrowdfundingCampaign The updated crowdfunding campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "crowdfundingCampaign": CrowdfundingCampaign,
  "userErrors": [UserError]
}

CrowdfundingCampaignRemoveProductsPayload

Description

Autogenerated return type of CrowdfundingCampaignRemoveProducts.

Fields
Field Name Description
crowdfundingCampaign - CrowdfundingCampaign The updated crowdfunding campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "crowdfundingCampaign": CrowdfundingCampaign,
  "userErrors": [UserError]
}

CrowdfundingCampaignUnarchivePayload

Description

Autogenerated return type of CrowdfundingCampaignUnarchive.

Fields
Field Name Description
crowdfundingCampaign - CrowdfundingCampaign The unarchived crowdfunding campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "crowdfundingCampaign": CrowdfundingCampaign,
  "userErrors": [UserError]
}

CrowdfundingCampaignUpdatePayload

Description

Autogenerated return type of CrowdfundingCampaignUpdate.

Fields
Field Name Description
crowdfundingCampaign - CrowdfundingCampaign The newly updated crowdfunding campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "crowdfundingCampaign": CrowdfundingCampaign,
  "userErrors": [UserError]
}

CustomerCreatePayload

Description

Autogenerated return type of CustomerCreate.

Fields
Field Name Description
customer - Customer The newly created customer.
userErrors - [UserError!]! A list of user errors.
Example
{
  "customer": Customer,
  "userErrors": [UserError]
}

CustomerUpdatePayload

Description

Autogenerated return type of CustomerUpdate.

Fields
Field Name Description
customer - Customer The newly updated customer.
userErrors - [UserError!]! A list of user errors.
Example
{
  "customer": Customer,
  "userErrors": [UserError]
}

CustomerUpsertPayload

Description

Autogenerated return type of CustomerUpsert.

Fields
Field Name Description
customer - Customer The newly upserted customer.
userErrors - [UserError!]! A list of user errors.
Example
{
  "customer": Customer,
  "userErrors": [UserError]
}

ExternalTokenCreatePayload

Description

Autogenerated return type of ExternalTokenCreate.

Fields
Field Name Description
externalToken - ExternalToken The newly added token.
userErrors - [UserError!]! A list of user errors.
Example
{
  "externalToken": ExternalToken,
  "userErrors": [UserError]
}

ExternalTokenRevokePayload

Description

Autogenerated return type of ExternalTokenRevoke.

Fields
Field Name Description
externalToken - ExternalToken The revoked token.
userErrors - [UserError!]! A list of user errors.
Example
{
  "externalToken": ExternalToken,
  "userErrors": [UserError]
}

NotificationScheduleCreatePayload

Description

Autogenerated return type of NotificationScheduleCreate.

Fields
Field Name Description
notificationSchedule - NotificationSchedule The newly created notification schedule.
userErrors - [UserError!]! A list of user errors.
Example
{
  "notificationSchedule": NotificationSchedule,
  "userErrors": [UserError]
}

NotificationScheduleDeletePayload

Description

Autogenerated return type of NotificationScheduleDelete.

Fields
Field Name Description
deletedNotificationScheduleId - GlobalID The ID of the deleted notification schedule.
userErrors - [UserError!]! A list of user errors.
Example
{
  "deletedNotificationScheduleId": GlobalID,
  "userErrors": [UserError]
}

NotificationScheduleUpdatePayload

Description

Autogenerated return type of NotificationScheduleUpdate.

Fields
Field Name Description
notificationSchedule - NotificationSchedule The updated notification schedule.
userErrors - [UserError!]! A list of user errors.
Example
{
  "notificationSchedule": NotificationSchedule,
  "userErrors": [UserError]
}

OrderCreatePayload

Description

Autogenerated return type of OrderCreate.

Fields
Field Name Description
order - Order The newly created order.
userErrors - [UserError!]! A list of user errors.
Example
{
  "order": Order,
  "userErrors": [UserError]
}

OrderUpdatePayload

Description

Autogenerated return type of OrderUpdate.

Fields
Field Name Description
order - Order The updated order.
userErrors - [UserError!]! A list of user errors.
Example
{
  "order": Order,
  "userErrors": [UserError]
}

OrderUpsertPayload

Description

Autogenerated return type of OrderUpsert.

Fields
Field Name Description
order - Order The newly upserted order.
userErrors - [UserError!]! A list of user errors.
Example
{
  "order": Order,
  "userErrors": [UserError]
}

OrganisationCreatePayload

Description

Autogenerated return type of OrganisationCreate.

Fields
Field Name Description
organisation - Organisation The newly created organisation.
userErrors - [UserError!]! A list of user errors.
Example
{
  "organisation": Organisation,
  "userErrors": [UserError]
}

OrganisationUpdatePayload

Description

Autogenerated return type of OrganisationUpdate.

Fields
Field Name Description
organisation - Organisation The newly updated organisation.
userErrors - [UserError!]! A list of user errors.
Example
{
  "organisation": Organisation,
  "userErrors": [UserError]
}

PaymentIntentAdjustmentCreatePayload

Description

Autogenerated return type of PaymentIntentAdjustmentCreate.

Fields
Field Name Description
paymentIntentAdjustment - PaymentIntentAdjustment The newly created payment intent adjustment.
userErrors - [UserError!]! A list of user errors.
Example
{
  "paymentIntentAdjustment": PaymentIntentAdjustment,
  "userErrors": [UserError]
}

PaymentIntentCancelPayload

Description

Autogenerated return type of PaymentIntentCancel.

Fields
Field Name Description
paymentIntent - PaymentIntent The payment intent.
userErrors - [UserError!]! A list of user errors.
Example
{
  "paymentIntent": PaymentIntent,
  "userErrors": [UserError]
}

PaymentIntentCreatePayload

Description

Autogenerated return type of PaymentIntentCreate.

Fields
Field Name Description
paymentIntent - PaymentIntent The newly created payment intent.
userErrors - [UserError!]! A list of user errors.
Example
{
  "paymentIntent": PaymentIntent,
  "userErrors": [UserError]
}

PaymentIntentFinalisePayload

Description

Autogenerated return type of PaymentIntentFinalise.

Fields
Field Name Description
paymentIntent - PaymentIntent The finalised payment intent.
userErrors - [UserError!]! A list of user errors.
Example
{
  "paymentIntent": PaymentIntent,
  "userErrors": [UserError]
}

PaymentIntentUpdatePayload

Description

Autogenerated return type of PaymentIntentUpdate.

Fields
Field Name Description
paymentIntent - PaymentIntent The updated payment intent.
userErrors - [UserError!]! A list of user errors.
Example
{
  "paymentIntent": PaymentIntent,
  "userErrors": [UserError]
}

PaymentMethodCancelPayload

Description

Autogenerated return type of PaymentMethodCancel.

Fields
Field Name Description
paymentMethod - PaymentMethod The payment method.
userErrors - [UserError!]! A list of user errors.
Example
{
  "paymentMethod": PaymentMethod,
  "userErrors": [UserError]
}

PaymentMethodCreatePayload

Description

Autogenerated return type of PaymentMethodCreate.

Fields
Field Name Description
paymentMethod - PaymentMethod The newly created payment method.
userErrors - [UserError!]! A list of user errors.
Example
{
  "paymentMethod": PaymentMethod,
  "userErrors": [UserError]
}

PaymentMethodSendUpdateEmailPayload

Description

Autogenerated return type of PaymentMethodSendUpdateEmail.

Fields
Field Name Description
userErrors - [UserError!]! A list of user errors.
Example
{"userErrors": [UserError]}

PaymentMethodUpdatePayload

Description

Autogenerated return type of PaymentMethodUpdate.

Fields
Field Name Description
paymentMethod - PaymentMethod The updated payment method.
userErrors - [UserError!]! A list of user errors.
Example
{
  "paymentMethod": PaymentMethod,
  "userErrors": [UserError]
}

PresaleCampaignAddProductVariantsPayload

Description

Autogenerated return type of PresaleCampaignAddProductVariants.

Fields
Field Name Description
presaleCampaign - PresaleCampaign The newly updated presale campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "presaleCampaign": PresaleCampaign,
  "userErrors": [UserError]
}

PresaleCampaignAddProductsPayload

Description

Autogenerated return type of PresaleCampaignAddProducts.

Fields
Field Name Description
presaleCampaign - PresaleCampaign The newly updated presale campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "presaleCampaign": PresaleCampaign,
  "userErrors": [UserError]
}

PresaleCampaignApplyBulkInventoryPayload

Description

Autogenerated return type of PresaleCampaignApplyBulkInventory.

Fields
Field Name Description
presaleCampaign - PresaleCampaign The presale campaign for which inventory should be applied.
userErrors - [UserError!]! A list of user errors.
Example
{
  "presaleCampaign": PresaleCampaign,
  "userErrors": [UserError]
}

PresaleCampaignApplyInventoryPayload

Description

Autogenerated return type of PresaleCampaignApplyInventory.

Fields
Field Name Description
presaleCampaign - PresaleCampaign The presale campaign for which inventory has been applied.
userErrors - [UserError!]! A list of user errors.
Example
{
  "presaleCampaign": PresaleCampaign,
  "userErrors": [UserError]
}

PresaleCampaignArchivePayload

Description

Autogenerated return type of PresaleCampaignArchive.

Fields
Field Name Description
presaleCampaign - PresaleCampaign The archived presale campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "presaleCampaign": PresaleCampaign,
  "userErrors": [UserError]
}

PresaleCampaignCancelPayload

Description

Autogenerated return type of PresaleCampaignCancel.

Fields
Field Name Description
presaleCampaign - PresaleCampaign The cancelled presale campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "presaleCampaign": PresaleCampaign,
  "userErrors": [UserError]
}

PresaleCampaignCreatePayload

Description

Autogenerated return type of PresaleCampaignCreate.

Fields
Field Name Description
presaleCampaign - PresaleCampaign The newly created presale campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "presaleCampaign": PresaleCampaign,
  "userErrors": [UserError]
}

PresaleCampaignDeletePayload

Description

Autogenerated return type of PresaleCampaignDelete.

Fields
Field Name Description
deletedPresaleCampaignId - GlobalID The ID of the deleted presale campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "deletedPresaleCampaignId": GlobalID,
  "userErrors": [UserError]
}

PresaleCampaignEndPayload

Description

Autogenerated return type of PresaleCampaignEnd.

Fields
Field Name Description
presaleCampaign - PresaleCampaign The ended presale campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "presaleCampaign": PresaleCampaign,
  "userErrors": [UserError]
}

PresaleCampaignFulfilPayload

Description

Autogenerated return type of PresaleCampaignFulfil.

Fields
Field Name Description
presaleCampaign - PresaleCampaign The fulfilling presale campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "presaleCampaign": PresaleCampaign,
  "userErrors": [UserError]
}

PresaleCampaignLaunchPayload

Description

Autogenerated return type of PresaleCampaignLaunch.

Fields
Field Name Description
presaleCampaign - PresaleCampaign The launched presale campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "presaleCampaign": PresaleCampaign,
  "userErrors": [UserError]
}

PresaleCampaignRemoveProductVariantsPayload

Description

Autogenerated return type of PresaleCampaignRemoveProductVariants.

Fields
Field Name Description
presaleCampaign - PresaleCampaign The updated presale campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "presaleCampaign": PresaleCampaign,
  "userErrors": [UserError]
}

PresaleCampaignRemoveProductsPayload

Description

Autogenerated return type of PresaleCampaignRemoveProducts.

Fields
Field Name Description
presaleCampaign - PresaleCampaign The updated presale campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "presaleCampaign": PresaleCampaign,
  "userErrors": [UserError]
}

PresaleCampaignUnarchivePayload

Description

Autogenerated return type of PresaleCampaignUnarchive.

Fields
Field Name Description
presaleCampaign - PresaleCampaign The unarchived presale campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "presaleCampaign": PresaleCampaign,
  "userErrors": [UserError]
}

PresaleCampaignUpdatePayload

Description

Autogenerated return type of PresaleCampaignUpdate.

Fields
Field Name Description
presaleCampaign - PresaleCampaign The newly updated presale campaign.
userErrors - [UserError!]! A list of user errors.
Example
{
  "presaleCampaign": PresaleCampaign,
  "userErrors": [UserError]
}

PriceCalculationCollectionPerformPayload

Description

Autogenerated return type of PriceCalculationCollectionPerform.

Fields
Field Name Description
priceCalculations - [PriceCalculation!] The price calculation.
userErrors - [UserError!]! A list of user errors.
Example
{
  "priceCalculations": [PriceCalculation],
  "userErrors": [UserError]
}

PriceCalculationPerformPayload

Description

Autogenerated return type of PriceCalculationPerform.

Fields
Field Name Description
priceCalculation - PriceCalculation The price calculation.
userErrors - [UserError!]! A list of user errors.
Example
{
  "priceCalculation": PriceCalculation,
  "userErrors": [UserError]
}

PriceEngineCreatePayload

Description

Autogenerated return type of PriceEngineCreate.

Fields
Field Name Description
priceEngine - PriceEngine The newly created price engine.
userErrors - [UserError!]! A list of user errors.
Example
{
  "priceEngine": PriceEngine,
  "userErrors": [UserError]
}

PriceEngineUpdatePayload

Description

Autogenerated return type of PriceEngineUpdate.

Fields
Field Name Description
priceEngine - PriceEngine The newly updated price engine.
userErrors - [UserError!]! A list of user errors.
Example
{
  "priceEngine": PriceEngine,
  "userErrors": [UserError]
}

PriceSourceRegisterPayload

Description

Autogenerated return type of PriceSourceRegister.

Fields
Field Name Description
priceSource - PriceSource The newly registered price source.
userErrors - [UserError!]! A list of user errors.
Example
{
  "priceSource": PriceSource,
  "userErrors": [UserError]
}

ProductCollectionCreatePayload

Description

Autogenerated return type of ProductCollectionCreate.

Fields
Field Name Description
productCollection - ProductCollection The newly created product collection.
userErrors - [UserError!]! A list of user errors.
Example
{
  "productCollection": ProductCollection,
  "userErrors": [UserError]
}

ProductCollectionDeletePayload

Description

Autogenerated return type of ProductCollectionDelete.

Fields
Field Name Description
deletedProductCollectionId - GlobalID The ID of the deleted product collection.
userErrors - [UserError!]! A list of user errors.
Example
{
  "deletedProductCollectionId": GlobalID,
  "userErrors": [UserError]
}

ProductCollectionUpdatePayload

Description

Autogenerated return type of ProductCollectionUpdate.

Fields
Field Name Description
productCollection - ProductCollection The updated product collection.
userErrors - [UserError!]! A list of user errors.
Example
{
  "productCollection": ProductCollection,
  "userErrors": [UserError]
}

ProductCollectionUpsertPayload

Description

Autogenerated return type of ProductCollectionUpsert.

Fields
Field Name Description
productCollection - ProductCollection The upserted product collection.
userErrors - [UserError!]! A list of user errors.
Example
{
  "productCollection": ProductCollection,
  "userErrors": [UserError]
}

ProductCreatePayload

Description

Autogenerated return type of ProductCreate.

Fields
Field Name Description
product - Product The newly created product.
userErrors - [UserError!]! A list of user errors.
Example
{
  "product": Product,
  "userErrors": [UserError]
}

ProductDeletePayload

Description

Autogenerated return type of ProductDelete.

Fields
Field Name Description
deletedProductId - GlobalID The ID of the deleted product.
userErrors - [UserError!]! A list of user errors.
Example
{
  "deletedProductId": GlobalID,
  "userErrors": [UserError]
}

ProductUpdatePayload

Description

Autogenerated return type of ProductUpdate.

Fields
Field Name Description
product - Product The updated product.
userErrors - [UserError!]! A list of user errors.
Example
{
  "product": Product,
  "userErrors": [UserError]
}

ProductUpsertPayload

Description

Autogenerated return type of ProductUpsert.

Fields
Field Name Description
product - Product The newly upserted product.
userErrors - [UserError!]! A list of user errors.
Example
{
  "product": Product,
  "userErrors": [UserError]
}

ProductVariantCreatePayload

Description

Autogenerated return type of ProductVariantCreate.

Fields
Field Name Description
productVariant - ProductVariant The newly created product variant.
userErrors - [UserError!]! A list of user errors.
Example
{
  "productVariant": ProductVariant,
  "userErrors": [UserError]
}

ProductVariantDeletePayload

Description

Autogenerated return type of ProductVariantDelete.

Fields
Field Name Description
deletedProductVariantId - GlobalID The ID of the deleted product variant.
userErrors - [UserError!]! A list of user errors.
Example
{
  "deletedProductVariantId": GlobalID,
  "userErrors": [UserError]
}

ProductVariantUpdatePayload

Description

Autogenerated return type of ProductVariantUpdate.

Fields
Field Name Description
productVariant - ProductVariant The updated product variant.
userErrors - [UserError!]! A list of user errors.
Example
{
  "productVariant": ProductVariant,
  "userErrors": [UserError]
}

RefundProcessPayload

Description

Autogenerated return type of RefundProcess.

Fields
Field Name Description
refund - Refund The newly created refund.
userErrors - [UserError!]! A list of user errors.
Example
{
  "refund": Refund,
  "userErrors": [UserError]
}

RefundRecordPayload

Description

Autogenerated return type of RefundRecord.

Fields
Field Name Description
refund - Refund The newly created refund.
userErrors - [UserError!]! A list of user errors.
Example
{
  "refund": Refund,
  "userErrors": [UserError]
}

ShopifyCredentialsCreatePayload

Description

Autogenerated return type of ShopifyCredentialsCreate.

Fields
Field Name Description
shopifyCredentials - ShopifyCredentials The newly stored shopify credentials.
userErrors - [UserError!]! A list of user errors.
Example
{
  "shopifyCredentials": ShopifyCredentials,
  "userErrors": [UserError]
}

SubscriptionItemAddPayload

Description

Autogenerated return type of SubscriptionItemAdd.

Fields
Field Name Description
addedItem - SubscriptionItem The newly added subscription item.
subscription - Subscription The updated subscription.
userErrors - [UserError!]! A list of user errors.
Example
{
  "addedItem": SubscriptionItem,
  "subscription": Subscription,
  "userErrors": [UserError]
}

SubscriptionOrderItemAddPayload

Description

Autogenerated return type of SubscriptionOrderItemAdd.

Fields
Field Name Description
addedItem - SubscriptionOrderItem The newly created subscription order item.
subscriptionOrder - SubscriptionOrder The updated subscription order.
userErrors - [UserError!]! A list of user errors.
Example
{
  "addedItem": SubscriptionOrderItem,
  "subscriptionOrder": SubscriptionOrder,
  "userErrors": [UserError]
}

SubscriptionOrderProcessPayload

Description

Autogenerated return type of SubscriptionOrderProcess.

Fields
Field Name Description
subscriptionOrder - SubscriptionOrder The processed subscription order.
userErrors - [UserError!]! A list of user errors.
Example
{
  "subscriptionOrder": SubscriptionOrder,
  "userErrors": [UserError]
}

SubscriptionOrderSkipPayload

Description

Autogenerated return type of SubscriptionOrderSkip.

Fields
Field Name Description
skippedSubscriptionOrders - [SubscriptionOrder!] The skipped subscription orders.
subscriptionOrder - SubscriptionOrder The origin subscription order.
userErrors - [UserError!]! A list of user errors.
Example
{
  "skippedSubscriptionOrders": [SubscriptionOrder],
  "subscriptionOrder": SubscriptionOrder,
  "userErrors": [UserError]
}

SubscriptionOrderUnskipPayload

Description

Autogenerated return type of SubscriptionOrderUnskip.

Fields
Field Name Description
subscriptionOrder - SubscriptionOrder The subscription order to unskip.
userErrors - [UserError!]! A list of user errors.
Example
{
  "subscriptionOrder": SubscriptionOrder,
  "userErrors": [UserError]
}

SubscriptionOrderUpdatePayload

Description

Autogenerated return type of SubscriptionOrderUpdate.

Fields
Field Name Description
subscriptionOrder - SubscriptionOrder The updated subscription order.
userErrors - [UserError!]! A list of user errors.
Example
{
  "subscriptionOrder": SubscriptionOrder,
  "userErrors": [UserError]
}

SubscriptionPlanGroupCreatePayload

Description

Autogenerated return type of SubscriptionPlanGroupCreate.

Fields
Field Name Description
subscriptionPlanGroup - SubscriptionPlanGroup The newly created subscription plan group.
userErrors - [UserError!]! A list of user errors.
Example
{
  "subscriptionPlanGroup": SubscriptionPlanGroup,
  "userErrors": [UserError]
}

SubscriptionSetFrequencyPayload

Description

Autogenerated return type of SubscriptionSetFrequency.

Fields
Field Name Description
subscription - Subscription The updated subscription.
userErrors - [UserError!]! A list of user errors.
Example
{
  "subscription": Subscription,
  "userErrors": [UserError]
}

WebhookCreatePayload

Description

Autogenerated return type of WebhookCreate.

Fields
Field Name Description
userErrors - [UserError!]! A list of user errors.
webhook - Webhook The newly created webhook subscription.
Example
{
  "userErrors": [UserError],
  "webhook": Webhook
}

WebhookDeletePayload

Description

Autogenerated return type of WebhookDelete.

Fields
Field Name Description
deletedWebhookId - GlobalID The webhooks's ID.
userErrors - [UserError!]! A list of user errors.
Example
{
  "deletedWebhookId": GlobalID,
  "userErrors": [UserError]
}

WebhookUpdatePayload

Description

Autogenerated return type of WebhookUpdate.

Fields
Field Name Description
userErrors - [UserError!]! A list of user errors.
webhook - Webhook The newly updated webhook.
Example
{
  "userErrors": [UserError],
  "webhook": Webhook
}

Scalar

Boolean

Description

The Boolean scalar type represents true or false.

Example
true

Count

Description

A postive integer

Example
Count

CycleIndex

Example
CycleIndex

Float

Description

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

Example
987.65

GlobalID

Description

A global ID.

Example
GlobalID

ID

Description

The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.

Example
"4"

ISO8601DateTime

Description

An ISO 8601-encoded datetime

Example
ISO8601DateTime

Int

Description

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

Example
987

JSON

Description

Represents untyped JSON

Example
{}

Metadata

Description

A collection of key/value pairs.

Example
Metadata

MetadataInput

Description

A collection of key/value pairs.

Example
MetadataInput

NonZeroCount

Description

A postive integer

Example
NonZeroCount

Percentage

Description

A percentage value

Example
Percentage

PositiveInteger

Description

A postive integer

Example
PositiveInteger

PricingSourceData

Description

A collection of key/value pairs.

Example
PricingSourceData

PricingSourceDataInput

Description

A collection of key/value pairs.

Example
PricingSourceDataInput

RedactedString

Description

redacted string

Example
RedactedString

SharedGlobalID

Description

A shared global Submarine ID.

Example
SharedGlobalID

String

Description

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

Example
"abc123"

Url

Description

A valid URL, transported as a string

Example
Url

Union

Campaign

Description

A generic campaign.

Example
CrowdfundingCampaign

CampaignItemResource

Description

A generic campaign item resource.

Types
Union Types

Product

ProductVariant

Example
Product

CrowdfundingGoal

Description

A generic crowdfunding campaign goal.

Example
TotalUnitsCrowdfundingGoal

PaymentSource

Description

A generic payment source.

Types
Union Types

Card

PaypalBillingAgreement

Example
Card

PricingResourceData

Example
CampaignOrderGroupData

SubscriptionProductGroupItemResource

Types
Union Types

Product

ProductVariant

Example
Product

SubscriptionProductGroupItemSourceResource

Example
Product