RevSend GraphQL Reference

Production API

API Endpoints
https://graph.v2.revsend.com
Headers
# Your API Token
Authorization: <YOUR_TOKEN_HERE>

Queries

Authentication

All requests must include a Bearer token in the Authorization header.

Generate an API key in the RevSend dashboard: Integrations tab → API Keys card, at rewards.revsend.com/integrations/api-keys.

Example header: Authorization: Bearer <YOUR_API_KEY>

_empty

Response

Returns a Boolean

Example

Query
query _empty {
  _empty
}
Response
{"data": {"_empty": true}}

campaigns

Response

Returns a Campaigns!

Arguments
Name Description
skip - Int!
take - Int!
sort - CampaignSortKey
query - CampaignQuery

Example

Query
query Campaigns(
  $skip: Int!,
  $take: Int!,
  $sort: CampaignSortKey,
  $query: CampaignQuery
) {
  campaigns(
    skip: $skip,
    take: $take,
    sort: $sort,
    query: $query
  ) {
    totalCount
    nodes {
      id
      ref
      createdAt
      type
      name
      brands {
        ...DigitalBrandFragment
      }
      gifts {
        ...PhysicalGiftFragment
      }
    }
  }
}
Variables
{
  "skip": 123,
  "take": 123,
  "sort": "CREATED_AT_ASC",
  "query": CampaignQuery
}
Response
{
  "data": {
    "campaigns": {"totalCount": 987, "nodes": [Campaign]}
  }
}

categories

Response

Returns [Category!]!

Example

Query
query Categories {
  categories {
    id
    name
    icon
  }
}
Response
{
  "data": {
    "categories": [
      {
        "id": 4,
        "name": "xyz789",
        "icon": "abc123"
      }
    ]
  }
}

charges

Response

Returns a Charges!

Arguments
Name Description
page - String
query - ChargeQuery

Example

Query
query Charges(
  $page: String,
  $query: ChargeQuery
) {
  charges(
    page: $page,
    query: $query
  ) {
    totalCount
    nextPage
    nodes {
      id
      amount
      created
      description
      receiptUrl
    }
  }
}
Variables
{
  "page": "xyz789",
  "query": ChargeQuery
}
Response
{
  "data": {
    "charges": {
      "totalCount": 123,
      "nextPage": "xyz789",
      "nodes": [Charge]
    }
  }
}

checkEmailProvider

Response

Returns an EmailProviderCheck!

Arguments
Name Description
email - String!

Example

Query
query CheckEmailProvider($email: String!) {
  checkEmailProvider(email: $email) {
    exists
    provider
  }
}
Variables
{"email": "xyz789"}
Response
{
  "data": {
    "checkEmailProvider": {
      "exists": true,
      "provider": "abc123"
    }
  }
}

creditCharges

Response

Returns [Charge!]!

Example

Query
query CreditCharges {
  creditCharges {
    id
    amount
    created
    description
    receiptUrl
  }
}
Response
{
  "data": {
    "creditCharges": [
      {
        "id": "4",
        "amount": 987,
        "created": "2007-12-03T10:15:30Z",
        "description": "xyz789",
        "receiptUrl": "xyz789"
      }
    ]
  }
}

customer

Response

Returns a Customer

Example

Query
query Customer {
  customer {
    id
    name
    email
    bank {
      id
      last4
      name
    }
    card {
      id
      last4
      brand
    }
    balance
    spendableBalance
    defaultPaymentMethodId
  }
}
Response
{
  "data": {
    "customer": {
      "id": 4,
      "name": "abc123",
      "email": "xyz789",
      "bank": Bank,
      "card": Card,
      "balance": 987,
      "spendableBalance": 987,
      "defaultPaymentMethodId": "abc123"
    }
  }
}

digitalBarcode

Response

Returns a DigitalBarcode

Arguments
Name Description
digitalOrderCode - ID!

Example

Query
query DigitalBarcode($digitalOrderCode: ID!) {
  digitalBarcode(digitalOrderCode: $digitalOrderCode) {
    id
    number
    csc
    barcodeKind
    barcodeValue
    viewCardUrl
  }
}
Variables
{"digitalOrderCode": 4}
Response
{
  "data": {
    "digitalBarcode": {
      "id": "4",
      "number": "abc123",
      "csc": "xyz789",
      "barcodeKind": "abc123",
      "barcodeValue": "abc123",
      "viewCardUrl": "xyz789"
    }
  }
}

digitalBrands

Response

Returns [DigitalBrand!]!

Arguments
Name Description
query - DigitalBrandQuery

Example

Query
query DigitalBrands($query: DigitalBrandQuery) {
  digitalBrands(query: $query) {
    id
    name
    iconUrl
    faceplateUrl
    legalTerms
    description
    availableCountries
    supportedCharities
    redemptionDisclaimer
    redemptionMethods
    denominations
    increment
    maxValue
    minValue
    vendorId
    currency
    isFavorite
  }
}
Variables
{"query": DigitalBrandQuery}
Response
{
  "data": {
    "digitalBrands": [
      {
        "id": "4",
        "name": "abc123",
        "iconUrl": "xyz789",
        "faceplateUrl": "xyz789",
        "legalTerms": "abc123",
        "description": "xyz789",
        "availableCountries": "xyz789",
        "supportedCharities": "abc123",
        "redemptionDisclaimer": "abc123",
        "redemptionMethods": ["xyz789"],
        "denominations": [987],
        "increment": 123,
        "maxValue": 123,
        "minValue": 987,
        "vendorId": 4,
        "currency": "USD",
        "isFavorite": true
      }
    ]
  }
}

digitalCampaign

Response

Returns a DigitalCampaign

Arguments
Name Description
id - ID!

Example

Query
query DigitalCampaign($id: ID!) {
  digitalCampaign(id: $id) {
    id
    createdAt
    ref
    name
    rewardValue
    brands
    brandDetails {
      id
      name
      iconUrl
      faceplateUrl
      legalTerms
      description
      availableCountries
      supportedCharities
      redemptionDisclaimer
      redemptionMethods
      denominations
      increment
      maxValue
      minValue
      vendorId
      currency
      isFavorite
    }
    messageTemplate
    headlineTemplate
    allowCharity
    brandsSummary
    isArchived
    requireEmail
    currency
    team {
      id
      name
      defaultPaymentMethodId
      users {
        ...UserFragment
      }
      isAdmin
    }
    private
    isRevSendCurated
    brandTemplateId
  }
}
Variables
{"id": "4"}
Response
{
  "data": {
    "digitalCampaign": {
      "id": "4",
      "createdAt": "2007-12-03T10:15:30Z",
      "ref": "abc123",
      "name": "xyz789",
      "rewardValue": 123,
      "brands": [4],
      "brandDetails": [DigitalBrand],
      "messageTemplate": "abc123",
      "headlineTemplate": "xyz789",
      "allowCharity": true,
      "brandsSummary": "xyz789",
      "isArchived": true,
      "requireEmail": false,
      "currency": "USD",
      "team": Team,
      "private": false,
      "isRevSendCurated": false,
      "brandTemplateId": "4"
    }
  }
}

digitalCampaigns

Response

Returns a DigitalCampaigns!

Arguments
Name Description
skip - Int!
take - Int!
sort - DigitalCampaignSortKey
query - DigitalCampaignQuery

Example

Query
query DigitalCampaigns(
  $skip: Int!,
  $take: Int!,
  $sort: DigitalCampaignSortKey,
  $query: DigitalCampaignQuery
) {
  digitalCampaigns(
    skip: $skip,
    take: $take,
    sort: $sort,
    query: $query
  ) {
    totalCount
    nodes {
      id
      createdAt
      ref
      name
      rewardValue
      brands
      brandDetails {
        ...DigitalBrandFragment
      }
      messageTemplate
      headlineTemplate
      allowCharity
      brandsSummary
      isArchived
      requireEmail
      currency
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
  }
}
Variables
{
  "skip": 987,
  "take": 987,
  "sort": "CREATED_AT_ASC",
  "query": DigitalCampaignQuery
}
Response
{
  "data": {
    "digitalCampaigns": {
      "totalCount": 987,
      "nodes": [DigitalCampaign]
    }
  }
}

digitalOrder

Response

Returns a DigitalOrder

Arguments
Name Description
orderRef - ID!

Example

Query
query DigitalOrder($orderRef: ID!) {
  digitalOrder(orderRef: $orderRef) {
    id
    ref
    createdAt
    rewardValue
    status
    rewardLink
    recipient {
      id
      org {
        ...OrgFragment
      }
      email
      name
      salesForceContactId
      salesForceAccountId
      hubSpotContactId
      hubSpotCompanyId
      orgName
    }
    creator {
      id
      name
      email
      role
      budget {
        ...BudgetFragment
      }
      salesForceUserId
      hubSpotUserId
      teams {
        ...UserTeamsFragment
      }
      org {
        ...OrgFragment
      }
      status
      googleEmail
      microsoftEmail
      hideOnboardingModal
      userOnboardingRole
      hubSpotToken {
        ...HubSpotTokenFragment
      }
      apiKeys {
        ...ApiKeyFragment
      }
      budgetReminderEnabled
      shippingUpdatesEnabled
      inviteCode
    }
    campaign {
      id
      createdAt
      ref
      name
      rewardValue
      brands
      brandDetails {
        ...DigitalBrandFragment
      }
      messageTemplate
      headlineTemplate
      allowCharity
      brandsSummary
      isArchived
      requireEmail
      currency
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    description
    deliveryMethod
    events {
      id
      createdAt
      code
    }
    cancelledAt
    expiresAt
    teamId
  }
}
Variables
{"orderRef": 4}
Response
{
  "data": {
    "digitalOrder": {
      "id": "4",
      "ref": "xyz789",
      "createdAt": "2007-12-03T10:15:30Z",
      "rewardValue": 123,
      "status": "PAYMENT_PENDING",
      "rewardLink": "xyz789",
      "recipient": Recipient,
      "creator": User,
      "campaign": DigitalCampaign,
      "description": "xyz789",
      "deliveryMethod": "LINK",
      "events": [DigitalOrderEvent],
      "cancelledAt": "2007-12-03T10:15:30Z",
      "expiresAt": "2007-12-03T10:15:30Z",
      "teamId": "abc123"
    }
  }
}

digitalOrderBatch

Response

Returns a DigitalOrderBatch

Arguments
Name Description
orderBatchRef - ID!

Example

Query
query DigitalOrderBatch($orderBatchRef: ID!) {
  digitalOrderBatch(orderBatchRef: $orderBatchRef) {
    id
    ref
    creator {
      id
      name
      email
      role
      budget {
        ...BudgetFragment
      }
      salesForceUserId
      hubSpotUserId
      teams {
        ...UserTeamsFragment
      }
      org {
        ...OrgFragment
      }
      status
      googleEmail
      microsoftEmail
      hideOnboardingModal
      userOnboardingRole
      hubSpotToken {
        ...HubSpotTokenFragment
      }
      apiKeys {
        ...ApiKeyFragment
      }
      budgetReminderEnabled
      shippingUpdatesEnabled
      inviteCode
    }
    createdAt
    totalOrders
    totalDelivered
    totalPaid
    digitalOrders {
      totalCount
      nodes {
        ...DigitalOrderFragment
      }
    }
  }
}
Variables
{"orderBatchRef": "4"}
Response
{
  "data": {
    "digitalOrderBatch": {
      "id": 4,
      "ref": "xyz789",
      "creator": User,
      "createdAt": "2007-12-03T10:15:30Z",
      "totalOrders": 123,
      "totalDelivered": 123,
      "totalPaid": 123,
      "digitalOrders": DigitalOrders
    }
  }
}

digitalOrderBatches

Response

Returns a DigitalOrderBatches!

Arguments
Name Description
skip - Int!
take - Int!
sort - DigitalOrderBatchSortKey
query - DigitalOrderBatchQuery

Example

Query
query DigitalOrderBatches(
  $skip: Int!,
  $take: Int!,
  $sort: DigitalOrderBatchSortKey,
  $query: DigitalOrderBatchQuery
) {
  digitalOrderBatches(
    skip: $skip,
    take: $take,
    sort: $sort,
    query: $query
  ) {
    totalCount
    nodes {
      id
      ref
      creator {
        ...UserFragment
      }
      createdAt
      totalOrders
      totalDelivered
      totalPaid
      digitalOrders {
        ...DigitalOrdersFragment
      }
    }
  }
}
Variables
{
  "skip": 123,
  "take": 987,
  "sort": "CREATED_AT_ASC",
  "query": DigitalOrderBatchQuery
}
Response
{
  "data": {
    "digitalOrderBatches": {
      "totalCount": 123,
      "nodes": [DigitalOrderBatch]
    }
  }
}

digitalOrders

Response

Returns a DigitalOrders!

Arguments
Name Description
skip - Int!
take - Int!
sort - DigitalOrderSortKey
query - DigitalOrderQuery

Example

Query
query DigitalOrders(
  $skip: Int!,
  $take: Int!,
  $sort: DigitalOrderSortKey,
  $query: DigitalOrderQuery
) {
  digitalOrders(
    skip: $skip,
    take: $take,
    sort: $sort,
    query: $query
  ) {
    totalCount
    nodes {
      id
      ref
      createdAt
      rewardValue
      status
      rewardLink
      recipient {
        ...RecipientFragment
      }
      creator {
        ...UserFragment
      }
      campaign {
        ...DigitalCampaignFragment
      }
      description
      deliveryMethod
      events {
        ...DigitalOrderEventFragment
      }
      cancelledAt
      expiresAt
      teamId
    }
  }
}
Variables
{
  "skip": 123,
  "take": 123,
  "sort": "CREATED_AT_ASC",
  "query": DigitalOrderQuery
}
Response
{
  "data": {
    "digitalOrders": {
      "totalCount": 987,
      "nodes": [DigitalOrder]
    }
  }
}

digitalReward

Response

Returns a DigitalReward

Arguments
Name Description
orderRef - ID!

Example

Query
query DigitalReward($orderRef: ID!) {
  digitalReward(orderRef: $orderRef) {
    orderRef
    value
    hasOrderCode
    barcode {
      id
      number
      csc
      barcodeKind
      barcodeValue
      viewCardUrl
    }
    messageTemplate
    headlineTemplate
    orgName
    logoUrl
    logoBackgroundColor
    logoPrimaryColor
    recipientName
    recipientEmail
    recipientOrgName
    creatorName
    creatorEmail
    allowsCharity
    brands {
      id
      name
      iconUrl
      faceplateUrl
      legalTerms
      description
      availableCountries
      supportedCharities
      redemptionDisclaimer
      redemptionMethods
      denominations
      increment
      maxValue
      minValue
      vendorId
      currency
      isFavorite
    }
    brand {
      id
      name
      iconUrl
      faceplateUrl
      legalTerms
      description
      availableCountries
      supportedCharities
      redemptionDisclaimer
      redemptionMethods
      denominations
      increment
      maxValue
      minValue
      vendorId
      currency
      isFavorite
    }
    code
    tremendousUrl
    currency
    cancelledAt
    isExpired
    expiresAt
  }
}
Variables
{"orderRef": 4}
Response
{
  "data": {
    "digitalReward": {
      "orderRef": "4",
      "value": 987,
      "hasOrderCode": false,
      "barcode": DigitalBarcode,
      "messageTemplate": "abc123",
      "headlineTemplate": "xyz789",
      "orgName": "abc123",
      "logoUrl": "xyz789",
      "logoBackgroundColor": "abc123",
      "logoPrimaryColor": "abc123",
      "recipientName": "xyz789",
      "recipientEmail": "xyz789",
      "recipientOrgName": "xyz789",
      "creatorName": "abc123",
      "creatorEmail": "xyz789",
      "allowsCharity": false,
      "brands": [DigitalBrand],
      "brand": DigitalBrand,
      "code": "xyz789",
      "tremendousUrl": "abc123",
      "currency": "USD",
      "cancelledAt": "2007-12-03T10:15:30Z",
      "isExpired": true,
      "expiresAt": "2007-12-03T10:15:30Z"
    }
  }
}

exchangeRates

Response

Returns [ExchangeRate!]!

Example

Query
query ExchangeRates {
  exchangeRates {
    currency
    ratePerUsd
  }
}
Response
{"data": {"exchangeRates": [{"currency": "USD", "ratePerUsd": 987.65}]}}

funds

Response

Returns a Float

Example

Query
query Funds {
  funds
}
Response
{"data": {"funds": 123.45}}

googleAuthCodeUrl

Response

Returns a String!

Example

Query
query GoogleAuthCodeUrl {
  googleAuthCodeUrl
}
Response
{"data": {"googleAuthCodeUrl": "xyz789"}}

hubSpotContacts

Response

Returns [HubSpotContact!]!

Arguments
Name Description
input - HubSpotContactsInput!

Example

Query
query HubSpotContacts($input: HubSpotContactsInput!) {
  hubSpotContacts(input: $input) {
    id
    companyId
    name
    firstname
    lastname
    email
    company {
      id
      name
    }
    address
    city
    state
    zip
    phone
  }
}
Variables
{"input": HubSpotContactsInput}
Response
{
  "data": {
    "hubSpotContacts": [
      {
        "id": "4",
        "companyId": 4,
        "name": "abc123",
        "firstname": "abc123",
        "lastname": "abc123",
        "email": "abc123",
        "company": HubSpotCompany,
        "address": "xyz789",
        "city": "xyz789",
        "state": "xyz789",
        "zip": "abc123",
        "phone": "abc123"
      }
    ]
  }
}

hubSpotReport

Response

Returns a HubSpotReport

Arguments
Name Description
input - HubSpotReportInput!

Example

Query
query HubSpotReport($input: HubSpotReportInput!) {
  hubSpotReport(input: $input) {
    id
    startDate
    endDate
    currency
    hubSpotAccountId
    opportunities {
      id
      accountId
      amount
      isWon
      isClosed
      timestamp
      orders {
        ...HubSpotReportOrderFragment
      }
    }
    orders {
      id
      campaignId
      hubSpotContactId
      amount
      timestamp
      campaignName
      creatorName
      creatorEmail
      recipientName
      recipientEmail
      recipientOrg
      description
      totalCost
      type
    }
  }
}
Variables
{"input": HubSpotReportInput}
Response
{
  "data": {
    "hubSpotReport": {
      "id": "4",
      "startDate": "2007-12-03T10:15:30Z",
      "endDate": "2007-12-03T10:15:30Z",
      "currency": "xyz789",
      "hubSpotAccountId": 123,
      "opportunities": [HubSpotReportOpportunity],
      "orders": [HubSpotReportOrder]
    }
  }
}

hubSpotToken

Response

Returns a HubSpotToken

Example

Query
query HubSpotToken {
  hubSpotToken {
    user
    hubDomain
    hubId
    appId
    hubSpotUserId
  }
}
Response
{
  "data": {
    "hubSpotToken": {
      "user": "xyz789",
      "hubDomain": "abc123",
      "hubId": 4,
      "appId": 4,
      "hubSpotUserId": 4
    }
  }
}

integrationWebhookSample

Response

Returns a WebhookSampleResponse

Example

Query
query IntegrationWebhookSample {
  integrationWebhookSample {
    order {
      id
      value
      message
      emailSubject
      deliveryMethod
      status
    }
    recipient {
      name
      email
      orgName
    }
    sender {
      id
      email
      name
      teamId
      teamName
    }
  }
}
Response
{
  "data": {
    "integrationWebhookSample": {
      "order": OrderSampleOrder,
      "recipient": OrderSampleRecipient,
      "sender": OrderSampleSender
    }
  }
}

me

Response

Returns a User

Example

Query
query Me {
  me {
    id
    name
    email
    role
    budget {
      id
      amount
      isPaymentFallbackEnabled
      refillAmount
      isRollover
      alertEnabled
      alertThresholdAmount
      alertRecipientEmail
      alertLastSentAt
      alertActive
    }
    salesForceUserId
    hubSpotUserId
    teams {
      userId
      teamId
      name
      isAdmin
    }
    org {
      id
      name
      formattedName
      users {
        ...UsersFragment
      }
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
      defaultBrandTemplateId
      defaultBrandTemplate {
        ...OrgBrandTemplateFragment
      }
      brandTemplates {
        ...OrgBrandTemplateFragment
      }
      isInternational
      subscriptionPlan {
        ...SubscriptionPlanFragment
      }
      hubSpotUserInfo {
        ...HubSpotUserInfoFragment
      }
      hubSpotUsers {
        ...HubSpotUserFragment
      }
      salesForceUserInfo {
        ...SalesForceUserInfoFragment
      }
      salesForceUsers {
        ...SalesForceUserFragment
      }
      onBoardingDetails {
        ...OnBoardingDetailsFragment
      }
      teams {
        ...TeamsFragment
      }
      budgetAlertDefaultThreshold
    }
    status
    googleEmail
    microsoftEmail
    hideOnboardingModal
    userOnboardingRole
    hubSpotToken {
      user
      hubDomain
      hubId
      appId
      hubSpotUserId
    }
    apiKeys {
      id
      publicId
      name
      scopes
      trailingChars
      lastUsedAt
      expiresAt
      revokedAt
      createdAt
      updatedAt
    }
    budgetReminderEnabled
    shippingUpdatesEnabled
    inviteCode
  }
}
Response
{
  "data": {
    "me": {
      "id": "4",
      "name": "xyz789",
      "email": "xyz789",
      "role": "ADMIN",
      "budget": Budget,
      "salesForceUserId": "xyz789",
      "hubSpotUserId": "abc123",
      "teams": [UserTeams],
      "org": Org,
      "status": "ACTIVE",
      "googleEmail": "abc123",
      "microsoftEmail": "xyz789",
      "hideOnboardingModal": true,
      "userOnboardingRole": "abc123",
      "hubSpotToken": HubSpotToken,
      "apiKeys": [ApiKey],
      "budgetReminderEnabled": false,
      "shippingUpdatesEnabled": true,
      "inviteCode": "xyz789"
    }
  }
}

microsoftAuthCodeUrl

Response

Returns a String!

Example

Query
query MicrosoftAuthCodeUrl {
  microsoftAuthCodeUrl
}
Response
{"data": {"microsoftAuthCodeUrl": "xyz789"}}

oAuthGetToken

Response

Returns a String!

Arguments
Name Description
query - GetTokenQuery!

Example

Query
query OAuthGetToken($query: GetTokenQuery!) {
  oAuthGetToken(query: $query)
}
Variables
{"query": GetTokenQuery}
Response
{"data": {"oAuthGetToken": "abc123"}}

occasions

Response

Returns [Occasion!]!

Example

Query
query Occasions {
  occasions {
    id
    name
    icon
  }
}
Response
{
  "data": {
    "occasions": [
      {
        "id": 4,
        "name": "abc123",
        "icon": "xyz789"
      }
    ]
  }
}

oktaGetConfig

Response

Returns an OktaConfig!

Arguments
Name Description
tenant - String!

Example

Query
query OktaGetConfig($tenant: String!) {
  oktaGetConfig(tenant: $tenant) {
    clientId
    issuer
  }
}
Variables
{"tenant": "abc123"}
Response
{
  "data": {
    "oktaGetConfig": {
      "clientId": "abc123",
      "issuer": "xyz789"
    }
  }
}

orders

Response

Returns an Orders!

Arguments
Name Description
skip - Int!
take - Int!
sort - OrderSortKey
myOrders - Boolean
getAll - Boolean
query - OrderQuery

Example

Query
query Orders(
  $skip: Int!,
  $take: Int!,
  $sort: OrderSortKey,
  $myOrders: Boolean,
  $getAll: Boolean,
  $query: OrderQuery
) {
  orders(
    skip: $skip,
    take: $take,
    sort: $sort,
    myOrders: $myOrders,
    getAll: $getAll,
    query: $query
  ) {
    totalCount
    nodes {
      id
      ref
      createdAt
      creatorName
      creatorOrg
      recipientName
      recipientOrg
      recipientSubmitsAddress
      addressConfirmedDate
      markPurchased
      events {
        ...DigitalOrderEventFragment
      }
      fulfillmentEvents {
        ...FulfillmentEventFragment
      }
      type
      totalCost
      description
      cancelledAt
    }
  }
}
Variables
{
  "skip": 123,
  "take": 123,
  "sort": "CREATED_AT_ASC",
  "myOrders": true,
  "getAll": true,
  "query": OrderQuery
}
Response
{
  "data": {
    "orders": {"totalCount": 123, "nodes": [Order]}
  }
}

org

Response

Returns an Org

Example

Query
query Org {
  org {
    id
    name
    formattedName
    users {
      totalCount
      nodes {
        ...UserFragment
      }
    }
    logoUrl
    logoBackgroundColor
    logoPrimaryColor
    defaultBrandTemplateId
    defaultBrandTemplate {
      id
      name
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
      handwritingFontStyle
      isDefault
    }
    brandTemplates {
      id
      name
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
      handwritingFontStyle
      isDefault
    }
    isInternational
    subscriptionPlan {
      id
      canUseWarehouse
    }
    hubSpotUserInfo {
      id
      displayName
    }
    hubSpotUsers {
      id
      name
      email
    }
    salesForceUserInfo {
      id
      username
      nickName
      displayName
    }
    salesForceUsers {
      id
      name
      email
    }
    onBoardingDetails {
      price
      trialDays
      seats
      acceptedTerms
      completed
      verified
    }
    teams {
      id
      name
      defaultPaymentMethodId
      users {
        ...UsersWithTeamFragment
      }
    }
    budgetAlertDefaultThreshold
  }
}
Response
{
  "data": {
    "org": {
      "id": "4",
      "name": "abc123",
      "formattedName": "xyz789",
      "users": Users,
      "logoUrl": "xyz789",
      "logoBackgroundColor": "abc123",
      "logoPrimaryColor": "abc123",
      "defaultBrandTemplateId": 4,
      "defaultBrandTemplate": OrgBrandTemplate,
      "brandTemplates": [OrgBrandTemplate],
      "isInternational": false,
      "subscriptionPlan": SubscriptionPlan,
      "hubSpotUserInfo": HubSpotUserInfo,
      "hubSpotUsers": [HubSpotUser],
      "salesForceUserInfo": SalesForceUserInfo,
      "salesForceUsers": [SalesForceUser],
      "onBoardingDetails": OnBoardingDetails,
      "teams": [Teams],
      "budgetAlertDefaultThreshold": 123
    }
  }
}

orgBrandTemplates

Response

Returns [OrgBrandTemplate!]!

Example

Query
query OrgBrandTemplates {
  orgBrandTemplates {
    id
    name
    logoUrl
    logoBackgroundColor
    logoPrimaryColor
    handwritingFontStyle
    isDefault
  }
}
Response
{
  "data": {
    "orgBrandTemplates": [
      {
        "id": "4",
        "name": "xyz789",
        "logoUrl": "abc123",
        "logoBackgroundColor": "xyz789",
        "logoPrimaryColor": "xyz789",
        "handwritingFontStyle": "CLEAN",
        "isDefault": false
      }
    ]
  }
}

physicalCampaign

Response

Returns a PhysicalCampaign

Arguments
Name Description
id - ID!

Example

Query
query PhysicalCampaign($id: ID!) {
  physicalCampaign(id: $id) {
    id
    ref
    createdAt
    name
    gifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    variants
    messageTemplate
    physicalNoteTemplate
    team {
      id
      name
      defaultPaymentMethodId
      users {
        ...UserFragment
      }
      isAdmin
    }
    private
    isRevSendCurated
    brandTemplateId
  }
}
Variables
{"id": 4}
Response
{
  "data": {
    "physicalCampaign": {
      "id": "4",
      "ref": "abc123",
      "createdAt": "2007-12-03T10:15:30Z",
      "name": "xyz789",
      "gifts": [PhysicalGift],
      "variants": ["4"],
      "messageTemplate": "xyz789",
      "physicalNoteTemplate": "abc123",
      "team": Team,
      "private": false,
      "isRevSendCurated": true,
      "brandTemplateId": 4
    }
  }
}

physicalCampaigns

Response

Returns a PhysicalCampaigns!

Arguments
Name Description
skip - Int!
take - Int!
sort - PhysicalCampaignSortKey
query - PhysicalCampaignQuery

Example

Query
query PhysicalCampaigns(
  $skip: Int!,
  $take: Int!,
  $sort: PhysicalCampaignSortKey,
  $query: PhysicalCampaignQuery
) {
  physicalCampaigns(
    skip: $skip,
    take: $take,
    sort: $sort,
    query: $query
  ) {
    totalCount
    nodes {
      id
      ref
      createdAt
      name
      gifts {
        ...PhysicalGiftFragment
      }
      variants
      messageTemplate
      physicalNoteTemplate
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
  }
}
Variables
{
  "skip": 987,
  "take": 123,
  "sort": "CREATED_AT_ASC",
  "query": PhysicalCampaignQuery
}
Response
{
  "data": {
    "physicalCampaigns": {
      "totalCount": 123,
      "nodes": [PhysicalCampaign]
    }
  }
}

physicalGift

Response

Returns a PhysicalGift

Arguments
Name Description
id - ID!

Example

Query
query PhysicalGift($id: ID!) {
  physicalGift(id: $id) {
    id
    title
    messageMaxLength
    messageMaxLines
    descriptionHtml
    featuredImageSrc
    initialShippingCost
    products {
      id
      org {
        ...OrgFragment
      }
      title
      isAddon
      images {
        ...ImageFragment
      }
      variants {
        ...ProductVariantFragment
      }
      totalInventory
    }
    productVariants {
      id
      price
      images {
        ...ImageFragment
      }
      title
    }
    isDisabled
    categories
    occasions
    isThirdParty
    shipsThroughWarehouse
    isDropshipped
    isAddOn
    hideInPreview
    purchaseUrl
    vendor {
      id
      name
      messageMaxLength
      messageMaxLines
    }
    orgId
    requiresPhone
    isFavorite
    selectedVariant {
      id
      price
      images {
        ...ImageFragment
      }
      title
    }
    optionId
    meta
  }
}
Variables
{"id": 4}
Response
{
  "data": {
    "physicalGift": {
      "id": "4",
      "title": "abc123",
      "messageMaxLength": 123,
      "messageMaxLines": 123,
      "descriptionHtml": "xyz789",
      "featuredImageSrc": "xyz789",
      "initialShippingCost": 987,
      "products": [Product],
      "productVariants": [ProductVariant],
      "isDisabled": true,
      "categories": ["abc123"],
      "occasions": ["abc123"],
      "isThirdParty": false,
      "shipsThroughWarehouse": false,
      "isDropshipped": false,
      "isAddOn": false,
      "hideInPreview": true,
      "purchaseUrl": "abc123",
      "vendor": PhysicalVendor,
      "orgId": "abc123",
      "requiresPhone": false,
      "isFavorite": false,
      "selectedVariant": ProductVariant,
      "optionId": "4",
      "meta": {}
    }
  }
}

physicalGifts

Response

Returns a PhysicalGifts!

Arguments
Name Description
skip - Int!
take - Int!
query - PhysicalGiftQuery

Example

Query
query PhysicalGifts(
  $skip: Int!,
  $take: Int!,
  $query: PhysicalGiftQuery
) {
  physicalGifts(
    skip: $skip,
    take: $take,
    query: $query
  ) {
    totalCount
    nodes {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
  }
}
Variables
{"skip": 123, "take": 123, "query": PhysicalGiftQuery}
Response
{
  "data": {
    "physicalGifts": {
      "totalCount": 987,
      "nodes": [PhysicalGift]
    }
  }
}

physicalOrder

Response

Returns a PhysicalOrder

Arguments
Name Description
id - ID!

Example

Query
query PhysicalOrder($id: ID!) {
  physicalOrder(id: $id) {
    id
    ref
    createdAt
    recipient {
      id
      org {
        ...OrgFragment
      }
      email
      name
      salesForceContactId
      salesForceAccountId
      hubSpotContactId
      hubSpotCompanyId
      orgName
    }
    isAddressConfirmed
    addressConfirmedDate
    markPurchased
    markPrinted
    recipientSubmitsAddress
    creatorName
    creatorEmail
    orgName
    orgBranding {
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
    }
    vendorName
    message
    physicalNote
    invoiceItems {
      id
      createdAt
      amount
      description
    }
    batchId
    mailingAddress {
      address1
      address2
      city
      company
      country
      countryCodeV2
      firstName
      lastName
      id
      phone
      province
      provinceCode
      zip
    }
    purchaseUrl
    description
    shopifyOrderId
    shopifyOrderName
    gifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    sendAll
    campaign {
      id
      ref
      createdAt
      name
      gifts {
        ...PhysicalGiftFragment
      }
      variants
      messageTemplate
      physicalNoteTemplate
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    vendorOrderId
    costToRevSend
    fulfillmentEvents {
      happenedAt
      id
      message
      status
    }
    images {
      altText
      height
      id
      url
      width
    }
    giftChoices {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    selectedGifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    hideContents
    isThirdParty
    shipsThroughWarehouse
    cancelledAt
    needsToSelectGift
    includeHandwritten
    fontStyle
    expiresAt
    isExpired
  }
}
Variables
{"id": "4"}
Response
{
  "data": {
    "physicalOrder": {
      "id": 4,
      "ref": "xyz789",
      "createdAt": "2007-12-03T10:15:30Z",
      "recipient": Recipient,
      "isAddressConfirmed": true,
      "addressConfirmedDate": "2007-12-03T10:15:30Z",
      "markPurchased": "2007-12-03T10:15:30Z",
      "markPrinted": "2007-12-03T10:15:30Z",
      "recipientSubmitsAddress": false,
      "creatorName": "xyz789",
      "creatorEmail": "xyz789",
      "orgName": "abc123",
      "orgBranding": OrgBranding,
      "vendorName": "xyz789",
      "message": "abc123",
      "physicalNote": "abc123",
      "invoiceItems": [InvoiceItem],
      "batchId": "xyz789",
      "mailingAddress": MailingAddress,
      "purchaseUrl": "abc123",
      "description": "abc123",
      "shopifyOrderId": "xyz789",
      "shopifyOrderName": "xyz789",
      "gifts": [PhysicalGift],
      "sendAll": false,
      "campaign": PhysicalCampaign,
      "vendorOrderId": "xyz789",
      "costToRevSend": 987,
      "fulfillmentEvents": [FulfillmentEvent],
      "images": [Image],
      "giftChoices": [PhysicalGift],
      "selectedGifts": [PhysicalGift],
      "hideContents": false,
      "isThirdParty": true,
      "shipsThroughWarehouse": false,
      "cancelledAt": "2007-12-03T10:15:30Z",
      "needsToSelectGift": false,
      "includeHandwritten": false,
      "fontStyle": "CLEAN",
      "expiresAt": "2007-12-03T10:15:30Z",
      "isExpired": true
    }
  }
}

physicalOrderBulkStatus

Response

Returns a PhysicalOrderBatch!

Arguments
Name Description
id - ID!

Example

Query
query PhysicalOrderBulkStatus($id: ID!) {
  physicalOrderBulkStatus(id: $id) {
    id
    ref
    creator {
      id
      name
      email
      role
      budget {
        ...BudgetFragment
      }
      salesForceUserId
      hubSpotUserId
      teams {
        ...UserTeamsFragment
      }
      org {
        ...OrgFragment
      }
      status
      googleEmail
      microsoftEmail
      hideOnboardingModal
      userOnboardingRole
      hubSpotToken {
        ...HubSpotTokenFragment
      }
      apiKeys {
        ...ApiKeyFragment
      }
      budgetReminderEnabled
      shippingUpdatesEnabled
      inviteCode
    }
    createdAt
    totalOrders
    totalDelivered
    totalPaid
    physicalOrders {
      totalCount
      nodes {
        ...PhysicalOrderFragment
      }
    }
  }
}
Variables
{"id": "4"}
Response
{
  "data": {
    "physicalOrderBulkStatus": {
      "id": "4",
      "ref": "abc123",
      "creator": User,
      "createdAt": "2007-12-03T10:15:30Z",
      "totalOrders": 987,
      "totalDelivered": 123,
      "totalPaid": 123,
      "physicalOrders": PhysicalOrders
    }
  }
}

physicalOrderByRef

Response

Returns a PhysicalOrder

Arguments
Name Description
ref - ID!

Example

Query
query PhysicalOrderByRef($ref: ID!) {
  physicalOrderByRef(ref: $ref) {
    id
    ref
    createdAt
    recipient {
      id
      org {
        ...OrgFragment
      }
      email
      name
      salesForceContactId
      salesForceAccountId
      hubSpotContactId
      hubSpotCompanyId
      orgName
    }
    isAddressConfirmed
    addressConfirmedDate
    markPurchased
    markPrinted
    recipientSubmitsAddress
    creatorName
    creatorEmail
    orgName
    orgBranding {
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
    }
    vendorName
    message
    physicalNote
    invoiceItems {
      id
      createdAt
      amount
      description
    }
    batchId
    mailingAddress {
      address1
      address2
      city
      company
      country
      countryCodeV2
      firstName
      lastName
      id
      phone
      province
      provinceCode
      zip
    }
    purchaseUrl
    description
    shopifyOrderId
    shopifyOrderName
    gifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    sendAll
    campaign {
      id
      ref
      createdAt
      name
      gifts {
        ...PhysicalGiftFragment
      }
      variants
      messageTemplate
      physicalNoteTemplate
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    vendorOrderId
    costToRevSend
    fulfillmentEvents {
      happenedAt
      id
      message
      status
    }
    images {
      altText
      height
      id
      url
      width
    }
    giftChoices {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    selectedGifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    hideContents
    isThirdParty
    shipsThroughWarehouse
    cancelledAt
    needsToSelectGift
    includeHandwritten
    fontStyle
    expiresAt
    isExpired
  }
}
Variables
{"ref": 4}
Response
{
  "data": {
    "physicalOrderByRef": {
      "id": 4,
      "ref": "xyz789",
      "createdAt": "2007-12-03T10:15:30Z",
      "recipient": Recipient,
      "isAddressConfirmed": true,
      "addressConfirmedDate": "2007-12-03T10:15:30Z",
      "markPurchased": "2007-12-03T10:15:30Z",
      "markPrinted": "2007-12-03T10:15:30Z",
      "recipientSubmitsAddress": false,
      "creatorName": "abc123",
      "creatorEmail": "xyz789",
      "orgName": "abc123",
      "orgBranding": OrgBranding,
      "vendorName": "xyz789",
      "message": "abc123",
      "physicalNote": "xyz789",
      "invoiceItems": [InvoiceItem],
      "batchId": "xyz789",
      "mailingAddress": MailingAddress,
      "purchaseUrl": "abc123",
      "description": "abc123",
      "shopifyOrderId": "abc123",
      "shopifyOrderName": "xyz789",
      "gifts": [PhysicalGift],
      "sendAll": false,
      "campaign": PhysicalCampaign,
      "vendorOrderId": "abc123",
      "costToRevSend": 123,
      "fulfillmentEvents": [FulfillmentEvent],
      "images": [Image],
      "giftChoices": [PhysicalGift],
      "selectedGifts": [PhysicalGift],
      "hideContents": false,
      "isThirdParty": false,
      "shipsThroughWarehouse": true,
      "cancelledAt": "2007-12-03T10:15:30Z",
      "needsToSelectGift": false,
      "includeHandwritten": false,
      "fontStyle": "CLEAN",
      "expiresAt": "2007-12-03T10:15:30Z",
      "isExpired": false
    }
  }
}

physicalOrders

Response

Returns a PhysicalOrders!

Arguments
Name Description
skip - Int!
take - Int!
sort - PhysicalOrderSortKey
query - PhysicalOrderQuery

Example

Query
query PhysicalOrders(
  $skip: Int!,
  $take: Int!,
  $sort: PhysicalOrderSortKey,
  $query: PhysicalOrderQuery
) {
  physicalOrders(
    skip: $skip,
    take: $take,
    sort: $sort,
    query: $query
  ) {
    totalCount
    nodes {
      id
      ref
      createdAt
      recipient {
        ...RecipientFragment
      }
      isAddressConfirmed
      addressConfirmedDate
      markPurchased
      markPrinted
      recipientSubmitsAddress
      creatorName
      creatorEmail
      orgName
      orgBranding {
        ...OrgBrandingFragment
      }
      vendorName
      message
      physicalNote
      invoiceItems {
        ...InvoiceItemFragment
      }
      batchId
      mailingAddress {
        ...MailingAddressFragment
      }
      purchaseUrl
      description
      shopifyOrderId
      shopifyOrderName
      gifts {
        ...PhysicalGiftFragment
      }
      sendAll
      campaign {
        ...PhysicalCampaignFragment
      }
      vendorOrderId
      costToRevSend
      fulfillmentEvents {
        ...FulfillmentEventFragment
      }
      images {
        ...ImageFragment
      }
      giftChoices {
        ...PhysicalGiftFragment
      }
      selectedGifts {
        ...PhysicalGiftFragment
      }
      hideContents
      isThirdParty
      shipsThroughWarehouse
      cancelledAt
      needsToSelectGift
      includeHandwritten
      fontStyle
      expiresAt
      isExpired
    }
  }
}
Variables
{
  "skip": 987,
  "take": 123,
  "sort": "CREATED_AT_ASC",
  "query": PhysicalOrderQuery
}
Response
{
  "data": {
    "physicalOrders": {
      "totalCount": 123,
      "nodes": [PhysicalOrder]
    }
  }
}

physicalOrdersAdmin

Response

Returns a PhysicalOrders!

Arguments
Name Description
search - String
skip - Int!
take - Int!
type - PhysicalOrderAdminType

Example

Query
query PhysicalOrdersAdmin(
  $search: String,
  $skip: Int!,
  $take: Int!,
  $type: PhysicalOrderAdminType
) {
  physicalOrdersAdmin(
    search: $search,
    skip: $skip,
    take: $take,
    type: $type
  ) {
    totalCount
    nodes {
      id
      ref
      createdAt
      recipient {
        ...RecipientFragment
      }
      isAddressConfirmed
      addressConfirmedDate
      markPurchased
      markPrinted
      recipientSubmitsAddress
      creatorName
      creatorEmail
      orgName
      orgBranding {
        ...OrgBrandingFragment
      }
      vendorName
      message
      physicalNote
      invoiceItems {
        ...InvoiceItemFragment
      }
      batchId
      mailingAddress {
        ...MailingAddressFragment
      }
      purchaseUrl
      description
      shopifyOrderId
      shopifyOrderName
      gifts {
        ...PhysicalGiftFragment
      }
      sendAll
      campaign {
        ...PhysicalCampaignFragment
      }
      vendorOrderId
      costToRevSend
      fulfillmentEvents {
        ...FulfillmentEventFragment
      }
      images {
        ...ImageFragment
      }
      giftChoices {
        ...PhysicalGiftFragment
      }
      selectedGifts {
        ...PhysicalGiftFragment
      }
      hideContents
      isThirdParty
      shipsThroughWarehouse
      cancelledAt
      needsToSelectGift
      includeHandwritten
      fontStyle
      expiresAt
      isExpired
    }
  }
}
Variables
{
  "search": "abc123",
  "skip": 987,
  "take": 123,
  "type": "PENDING_ORDER_PLACEMENT"
}
Response
{
  "data": {
    "physicalOrdersAdmin": {
      "totalCount": 987,
      "nodes": [PhysicalOrder]
    }
  }
}

physicalOrdersAdminCounts

Response

Returns a PhysicalOrdersAdminCounts!

Example

Query
query PhysicalOrdersAdminCounts {
  physicalOrdersAdminCounts {
    PENDING_ORDER_PLACEMENT
    PENDING_RECIPIENT_SHIPMENT
    PENDING_RECIPIENT_DELIVERY
  }
}
Response
{
  "data": {
    "physicalOrdersAdminCounts": {
      "PENDING_ORDER_PLACEMENT": 123,
      "PENDING_RECIPIENT_SHIPMENT": 123,
      "PENDING_RECIPIENT_DELIVERY": 123
    }
  }
}

physicalOrdersFulfillment

Response

Returns a PhysicalOrders!

Arguments
Name Description
skip - Int!
take - Int!
query - PhysicalOrderFulfillmentQuery!

Example

Query
query PhysicalOrdersFulfillment(
  $skip: Int!,
  $take: Int!,
  $query: PhysicalOrderFulfillmentQuery!
) {
  physicalOrdersFulfillment(
    skip: $skip,
    take: $take,
    query: $query
  ) {
    totalCount
    nodes {
      id
      ref
      createdAt
      recipient {
        ...RecipientFragment
      }
      isAddressConfirmed
      addressConfirmedDate
      markPurchased
      markPrinted
      recipientSubmitsAddress
      creatorName
      creatorEmail
      orgName
      orgBranding {
        ...OrgBrandingFragment
      }
      vendorName
      message
      physicalNote
      invoiceItems {
        ...InvoiceItemFragment
      }
      batchId
      mailingAddress {
        ...MailingAddressFragment
      }
      purchaseUrl
      description
      shopifyOrderId
      shopifyOrderName
      gifts {
        ...PhysicalGiftFragment
      }
      sendAll
      campaign {
        ...PhysicalCampaignFragment
      }
      vendorOrderId
      costToRevSend
      fulfillmentEvents {
        ...FulfillmentEventFragment
      }
      images {
        ...ImageFragment
      }
      giftChoices {
        ...PhysicalGiftFragment
      }
      selectedGifts {
        ...PhysicalGiftFragment
      }
      hideContents
      isThirdParty
      shipsThroughWarehouse
      cancelledAt
      needsToSelectGift
      includeHandwritten
      fontStyle
      expiresAt
      isExpired
    }
  }
}
Variables
{
  "skip": 987,
  "take": 123,
  "query": PhysicalOrderFulfillmentQuery
}
Response
{
  "data": {
    "physicalOrdersFulfillment": {
      "totalCount": 987,
      "nodes": [PhysicalOrder]
    }
  }
}

price

Response

Returns a Price!

Example

Query
query Price {
  price {
    value
    recurring
    id
  }
}
Response
{
  "data": {
    "price": {
      "value": 123,
      "recurring": "xyz789",
      "id": "abc123"
    }
  }
}

prices

Response

Returns [StripePrice!]!

Example

Query
query Prices {
  prices {
    id
    name
    value
  }
}
Response
{
  "data": {
    "prices": [
      {
        "id": 4,
        "name": "xyz789",
        "value": 123
      }
    ]
  }
}

saasCharges

Response

Returns [Charge!]!

Example

Query
query SaasCharges {
  saasCharges {
    id
    amount
    created
    description
    receiptUrl
  }
}
Response
{
  "data": {
    "saasCharges": [
      {
        "id": 4,
        "amount": 123,
        "created": "2007-12-03T10:15:30Z",
        "description": "xyz789",
        "receiptUrl": "xyz789"
      }
    ]
  }
}

salesForceContact

Response

Returns a SalesForceContact

Arguments
Name Description
input - SalesForceContactInput!

Example

Query
query SalesForceContact($input: SalesForceContactInput!) {
  salesForceContact(input: $input) {
    id
    phone
    email
    name
    account {
      id
      name
    }
    mailingAddress {
      city
      country
      postalCode
      state
      street
    }
  }
}
Variables
{"input": SalesForceContactInput}
Response
{
  "data": {
    "salesForceContact": {
      "id": "4",
      "phone": "xyz789",
      "email": "xyz789",
      "name": "xyz789",
      "account": SalesForceAccount,
      "mailingAddress": SalesForceMailingAddress
    }
  }
}

salesForceContacts

Response

Returns [SalesForceContact!]!

Arguments
Name Description
input - SalesForceContactsInput!

Example

Query
query SalesForceContacts($input: SalesForceContactsInput!) {
  salesForceContacts(input: $input) {
    id
    phone
    email
    name
    account {
      id
      name
    }
    mailingAddress {
      city
      country
      postalCode
      state
      street
    }
  }
}
Variables
{"input": SalesForceContactsInput}
Response
{
  "data": {
    "salesForceContacts": [
      {
        "id": 4,
        "phone": "xyz789",
        "email": "abc123",
        "name": "abc123",
        "account": SalesForceAccount,
        "mailingAddress": SalesForceMailingAddress
      }
    ]
  }
}

salesForceReport

Response

Returns a SalesForceReport

Arguments
Name Description
input - SalesForceReportInput!

Example

Query
query SalesForceReport($input: SalesForceReportInput!) {
  salesForceReport(input: $input) {
    id
    startDate
    endDate
    currency
    salesForceOrgId
    opportunities {
      id
      accountId
      amount
      isWon
      isClosed
      timestamp
      orders {
        ...SalesForceReportOrderFragment
      }
    }
    orders {
      id
      campaignId
      salesForceAccountId
      amount
      timestamp
      campaignName
      creatorName
      creatorEmail
      recipientName
      recipientEmail
      recipientOrg
      description
      totalCost
      type
    }
  }
}
Variables
{"input": SalesForceReportInput}
Response
{
  "data": {
    "salesForceReport": {
      "id": 4,
      "startDate": "2007-12-03T10:15:30Z",
      "endDate": "2007-12-03T10:15:30Z",
      "currency": "xyz789",
      "salesForceOrgId": "xyz789",
      "opportunities": [SalesForceReportOpportunity],
      "orders": [SalesForceReportOrder]
    }
  }
}

salesForceToken

Response

Returns a SalesForceToken

Example

Query
query SalesForceToken {
  salesForceToken {
    id
    instanceUrl
  }
}
Response
{
  "data": {
    "salesForceToken": {
      "id": 4,
      "instanceUrl": "abc123"
    }
  }
}

salesForceUser

Response

Returns a SalesForceUser

Example

Query
query SalesForceUser {
  salesForceUser {
    id
    name
    email
  }
}
Response
{
  "data": {
    "salesForceUser": {
      "id": 4,
      "name": "abc123",
      "email": "xyz789"
    }
  }
}

slackIntegrationStatus

Response

Returns a SlackIntegrationStatus!

Example

Query
query SlackIntegrationStatus {
  slackIntegrationStatus {
    connected
    teamId
    teamName
    installedByUserId
    installedAt
    installUrl
  }
}
Response
{
  "data": {
    "slackIntegrationStatus": {
      "connected": true,
      "teamId": "abc123",
      "teamName": "xyz789",
      "installedByUserId": "xyz789",
      "installedAt": "2007-12-03T10:15:30Z",
      "installUrl": "abc123"
    }
  }
}

subscription

Response

Returns a SubscriptionResponse

Example

Query
query Subscription {
  subscription {
    currentSeats
    costPerSeat
    usedSeats
    planName
    paymentMethod {
      type
      last4
      brand
      bankName
    }
  }
}
Response
{
  "data": {
    "subscription": {
      "currentSeats": 123,
      "costPerSeat": 123,
      "usedSeats": 987,
      "planName": "abc123",
      "paymentMethod": SubscriptionPaymentMethod
    }
  }
}

teamPaymentMethods

Response

Returns a TeamPaymentMethods!

Arguments
Name Description
teamId - ID!

Example

Query
query TeamPaymentMethods($teamId: ID!) {
  teamPaymentMethods(teamId: $teamId) {
    teamId
    defaultPaymentMethodId
    methods {
      id
      type
      last4
      brand
      bankName
      isDefaultForOrg
      isDefaultForTeam
    }
  }
}
Variables
{"teamId": "4"}
Response
{
  "data": {
    "teamPaymentMethods": {
      "teamId": "4",
      "defaultPaymentMethodId": "xyz789",
      "methods": [PaymentMethodSummary]
    }
  }
}

userByInviteCode

Response

Returns a User

Arguments
Name Description
input - UserByInviteCodeInput!

Example

Query
query UserByInviteCode($input: UserByInviteCodeInput!) {
  userByInviteCode(input: $input) {
    id
    name
    email
    role
    budget {
      id
      amount
      isPaymentFallbackEnabled
      refillAmount
      isRollover
      alertEnabled
      alertThresholdAmount
      alertRecipientEmail
      alertLastSentAt
      alertActive
    }
    salesForceUserId
    hubSpotUserId
    teams {
      userId
      teamId
      name
      isAdmin
    }
    org {
      id
      name
      formattedName
      users {
        ...UsersFragment
      }
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
      defaultBrandTemplateId
      defaultBrandTemplate {
        ...OrgBrandTemplateFragment
      }
      brandTemplates {
        ...OrgBrandTemplateFragment
      }
      isInternational
      subscriptionPlan {
        ...SubscriptionPlanFragment
      }
      hubSpotUserInfo {
        ...HubSpotUserInfoFragment
      }
      hubSpotUsers {
        ...HubSpotUserFragment
      }
      salesForceUserInfo {
        ...SalesForceUserInfoFragment
      }
      salesForceUsers {
        ...SalesForceUserFragment
      }
      onBoardingDetails {
        ...OnBoardingDetailsFragment
      }
      teams {
        ...TeamsFragment
      }
      budgetAlertDefaultThreshold
    }
    status
    googleEmail
    microsoftEmail
    hideOnboardingModal
    userOnboardingRole
    hubSpotToken {
      user
      hubDomain
      hubId
      appId
      hubSpotUserId
    }
    apiKeys {
      id
      publicId
      name
      scopes
      trailingChars
      lastUsedAt
      expiresAt
      revokedAt
      createdAt
      updatedAt
    }
    budgetReminderEnabled
    shippingUpdatesEnabled
    inviteCode
  }
}
Variables
{"input": UserByInviteCodeInput}
Response
{
  "data": {
    "userByInviteCode": {
      "id": "4",
      "name": "abc123",
      "email": "abc123",
      "role": "ADMIN",
      "budget": Budget,
      "salesForceUserId": "xyz789",
      "hubSpotUserId": "abc123",
      "teams": [UserTeams],
      "org": Org,
      "status": "ACTIVE",
      "googleEmail": "xyz789",
      "microsoftEmail": "abc123",
      "hideOnboardingModal": false,
      "userOnboardingRole": "xyz789",
      "hubSpotToken": HubSpotToken,
      "apiKeys": [ApiKey],
      "budgetReminderEnabled": false,
      "shippingUpdatesEnabled": false,
      "inviteCode": "xyz789"
    }
  }
}

validatePhysicalOrderCsv

Response

Returns an CSVValidationResult!

Arguments
Name Description
csvContent - String!

Example

Query
query ValidatePhysicalOrderCsv($csvContent: String!) {
  validatePhysicalOrderCsv(csvContent: $csvContent) {
    isValid
    totalRows
    validRows
    errors {
      rowNumber
      field
      message
      value
    }
    summary {
      missingFields
      invalidAddresses
      validAddresses
    }
  }
}
Variables
{"csvContent": "xyz789"}
Response
{
  "data": {
    "validatePhysicalOrderCsv": {
      "isValid": false,
      "totalRows": 123,
      "validRows": 987,
      "errors": [CSVValidationError],
      "summary": CSVValidationSummary
    }
  }
}

vendors

Response

Returns [PhysicalVendor!]!

Example

Query
query Vendors {
  vendors {
    id
    name
    messageMaxLength
    messageMaxLines
  }
}
Response
{
  "data": {
    "vendors": [
      {
        "id": 4,
        "name": "xyz789",
        "messageMaxLength": 123,
        "messageMaxLines": 987
      }
    ]
  }
}

Mutations

HubspotToBatchScript

Response

Returns a Boolean

Arguments
Name Description
input - ScriptInput!

Example

Query
mutation HubspotToBatchScript($input: ScriptInput!) {
  HubspotToBatchScript(input: $input)
}
Variables
{"input": ScriptInput}
Response
{"data": {"HubspotToBatchScript": false}}

_empty

Response

Returns a Boolean

Example

Query
mutation _empty {
  _empty
}
Response
{"data": {"_empty": true}}

apiKeyCreate

Response

Returns an ApiKeySecret!

Arguments
Name Description
input - ApiKeyCreateInput!

Example

Query
mutation ApiKeyCreate($input: ApiKeyCreateInput!) {
  apiKeyCreate(input: $input) {
    key
    apiKey {
      id
      publicId
      name
      scopes
      trailingChars
      lastUsedAt
      expiresAt
      revokedAt
      createdAt
      updatedAt
    }
  }
}
Variables
{"input": ApiKeyCreateInput}
Response
{
  "data": {
    "apiKeyCreate": {
      "key": "abc123",
      "apiKey": ApiKey
    }
  }
}

apiKeyDelete

Response

Returns a Boolean

Arguments
Name Description
id - ID!

Example

Query
mutation ApiKeyDelete($id: ID!) {
  apiKeyDelete(id: $id)
}
Variables
{"id": 4}
Response
{"data": {"apiKeyDelete": true}}

apiKeyRevoke

Response

Returns an ApiKey!

Arguments
Name Description
id - ID!

Example

Query
mutation ApiKeyRevoke($id: ID!) {
  apiKeyRevoke(id: $id) {
    id
    publicId
    name
    scopes
    trailingChars
    lastUsedAt
    expiresAt
    revokedAt
    createdAt
    updatedAt
  }
}
Variables
{"id": "4"}
Response
{
  "data": {
    "apiKeyRevoke": {
      "id": 4,
      "publicId": "abc123",
      "name": "xyz789",
      "scopes": ["abc123"],
      "trailingChars": "abc123",
      "lastUsedAt": "2007-12-03T10:15:30Z",
      "expiresAt": "2007-12-03T10:15:30Z",
      "revokedAt": "2007-12-03T10:15:30Z",
      "createdAt": "2007-12-03T10:15:30Z",
      "updatedAt": "2007-12-03T10:15:30Z"
    }
  }
}

apiKeyRotate

Response

Returns an ApiKeySecret!

Arguments
Name Description
id - ID!

Example

Query
mutation ApiKeyRotate($id: ID!) {
  apiKeyRotate(id: $id) {
    key
    apiKey {
      id
      publicId
      name
      scopes
      trailingChars
      lastUsedAt
      expiresAt
      revokedAt
      createdAt
      updatedAt
    }
  }
}
Variables
{"id": 4}
Response
{
  "data": {
    "apiKeyRotate": {
      "key": "abc123",
      "apiKey": ApiKey
    }
  }
}

assetUploadUrlCreate

Response

Returns an AssetUploadUrl

Arguments
Name Description
input - AssetUploadUrlInput!

Example

Query
mutation AssetUploadUrlCreate($input: AssetUploadUrlInput!) {
  assetUploadUrlCreate(input: $input) {
    url
    key
  }
}
Variables
{"input": AssetUploadUrlInput}
Response
{
  "data": {
    "assetUploadUrlCreate": {
      "url": "abc123",
      "key": "xyz789"
    }
  }
}

attachBankAccount

Response

Returns a Boolean

Arguments
Name Description
balanceId - String
saasId - String
saasOnly - Boolean
teamId - ID

Example

Query
mutation AttachBankAccount(
  $balanceId: String,
  $saasId: String,
  $saasOnly: Boolean,
  $teamId: ID
) {
  attachBankAccount(
    balanceId: $balanceId,
    saasId: $saasId,
    saasOnly: $saasOnly,
    teamId: $teamId
  )
}
Variables
{
  "balanceId": "abc123",
  "saasId": "abc123",
  "saasOnly": false,
  "teamId": 4
}
Response
{"data": {"attachBankAccount": true}}

authenticateWithGoogle

Response

Returns an AuthenticationRedirectResponse!

Arguments
Name Description
credential - String!
promoCode - String

Example

Query
mutation AuthenticateWithGoogle(
  $credential: String!,
  $promoCode: String
) {
  authenticateWithGoogle(
    credential: $credential,
    promoCode: $promoCode
  ) {
    redirectUrl
    requiresRedirect
    token
  }
}
Variables
{
  "credential": "abc123",
  "promoCode": "xyz789"
}
Response
{
  "data": {
    "authenticateWithGoogle": {
      "redirectUrl": "xyz789",
      "requiresRedirect": false,
      "token": "abc123"
    }
  }
}

authenticateWithMicrosoft

Response

Returns an AuthenticationRedirectResponse!

Arguments
Name Description
credential - String!
promoCode - String

Example

Query
mutation AuthenticateWithMicrosoft(
  $credential: String!,
  $promoCode: String
) {
  authenticateWithMicrosoft(
    credential: $credential,
    promoCode: $promoCode
  ) {
    redirectUrl
    requiresRedirect
    token
  }
}
Variables
{
  "credential": "abc123",
  "promoCode": "abc123"
}
Response
{
  "data": {
    "authenticateWithMicrosoft": {
      "redirectUrl": "abc123",
      "requiresRedirect": true,
      "token": "abc123"
    }
  }
}

budgetUpdate

Response

Returns a Budget!

Arguments
Name Description
id - ID!
input - BudgetInput!

Example

Query
mutation BudgetUpdate(
  $id: ID!,
  $input: BudgetInput!
) {
  budgetUpdate(
    id: $id,
    input: $input
  ) {
    id
    amount
    isPaymentFallbackEnabled
    refillAmount
    isRollover
    alertEnabled
    alertThresholdAmount
    alertRecipientEmail
    alertLastSentAt
    alertActive
  }
}
Variables
{
  "id": "4",
  "input": BudgetInput
}
Response
{
  "data": {
    "budgetUpdate": {
      "id": 4,
      "amount": 987.65,
      "isPaymentFallbackEnabled": true,
      "refillAmount": 123,
      "isRollover": true,
      "alertEnabled": false,
      "alertThresholdAmount": 123,
      "alertRecipientEmail": "abc123",
      "alertLastSentAt": "2007-12-03T10:15:30Z",
      "alertActive": true
    }
  }
}

cardUpdate

Response

Returns a Customer!

Arguments
Name Description
paymentMethodId - ID!
saasPaymentMethodId - ID

Example

Query
mutation CardUpdate(
  $paymentMethodId: ID!,
  $saasPaymentMethodId: ID
) {
  cardUpdate(
    paymentMethodId: $paymentMethodId,
    saasPaymentMethodId: $saasPaymentMethodId
  ) {
    id
    name
    email
    bank {
      id
      last4
      name
    }
    card {
      id
      last4
      brand
    }
    balance
    spendableBalance
    defaultPaymentMethodId
  }
}
Variables
{
  "paymentMethodId": "4",
  "saasPaymentMethodId": 4
}
Response
{
  "data": {
    "cardUpdate": {
      "id": 4,
      "name": "abc123",
      "email": "xyz789",
      "bank": Bank,
      "card": Card,
      "balance": 987,
      "spendableBalance": 123,
      "defaultPaymentMethodId": "abc123"
    }
  }
}

cloneCuratedCampaign

Response

Returns a CloneCuratedCampaignResult!

Arguments
Name Description
id - ID!
type - CampaignType!

Example

Query
mutation CloneCuratedCampaign(
  $id: ID!,
  $type: CampaignType!
) {
  cloneCuratedCampaign(
    id: $id,
    type: $type
  ) {
    ... on DigitalCampaign {
      id
      createdAt
      ref
      name
      rewardValue
      brands
      brandDetails {
        ...DigitalBrandFragment
      }
      messageTemplate
      headlineTemplate
      allowCharity
      brandsSummary
      isArchived
      requireEmail
      currency
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    ... on PhysicalCampaign {
      id
      ref
      createdAt
      name
      gifts {
        ...PhysicalGiftFragment
      }
      variants
      messageTemplate
      physicalNoteTemplate
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
  }
}
Variables
{"id": "4", "type": "DIGITAL"}
Response
{"data": {"cloneCuratedCampaign": DigitalCampaign}}

createBillingPortalSession

Response

Returns a String!

Example

Query
mutation CreateBillingPortalSession {
  createBillingPortalSession
}
Response
{
  "data": {
    "createBillingPortalSession": "abc123"
  }
}

createLinkToken

Response

Returns a LinkToken!

Arguments
Name Description
saasOnly - Boolean
teamId - ID

Example

Query
mutation CreateLinkToken(
  $saasOnly: Boolean,
  $teamId: ID
) {
  createLinkToken(
    saasOnly: $saasOnly,
    teamId: $teamId
  ) {
    fc
    balance
    saas
  }
}
Variables
{"saasOnly": false, "teamId": 4}
Response
{
  "data": {
    "createLinkToken": {
      "fc": "abc123",
      "balance": "xyz789",
      "saas": "xyz789"
    }
  }
}

detachPaymentMethod

Response

Returns a Boolean!

Arguments
Name Description
paymentMethodId - ID!

Example

Query
mutation DetachPaymentMethod($paymentMethodId: ID!) {
  detachPaymentMethod(paymentMethodId: $paymentMethodId)
}
Variables
{"paymentMethodId": "4"}
Response
{"data": {"detachPaymentMethod": true}}

digitalBarcodeCreate

Response

Returns a DigitalBarcode!

Arguments
Name Description
digitalOrderCode - ID!

Example

Query
mutation DigitalBarcodeCreate($digitalOrderCode: ID!) {
  digitalBarcodeCreate(digitalOrderCode: $digitalOrderCode) {
    id
    number
    csc
    barcodeKind
    barcodeValue
    viewCardUrl
  }
}
Variables
{"digitalOrderCode": "4"}
Response
{
  "data": {
    "digitalBarcodeCreate": {
      "id": "4",
      "number": "xyz789",
      "csc": "xyz789",
      "barcodeKind": "abc123",
      "barcodeValue": "abc123",
      "viewCardUrl": "abc123"
    }
  }
}

digitalBrandRemoveFavorite

Response

Returns a Boolean!

Arguments
Name Description
id - ID!

Example

Query
mutation DigitalBrandRemoveFavorite($id: ID!) {
  digitalBrandRemoveFavorite(id: $id)
}
Variables
{"id": "4"}
Response
{"data": {"digitalBrandRemoveFavorite": true}}

digitalBrandSetFavorite

Response

Returns a Boolean!

Arguments
Name Description
id - ID!

Example

Query
mutation DigitalBrandSetFavorite($id: ID!) {
  digitalBrandSetFavorite(id: $id)
}
Variables
{"id": 4}
Response
{"data": {"digitalBrandSetFavorite": true}}

digitalCampaignCreate

Response

Returns a DigitalCampaign!

Arguments
Name Description
input - DigitalCampaignInput!

Example

Query
mutation DigitalCampaignCreate($input: DigitalCampaignInput!) {
  digitalCampaignCreate(input: $input) {
    id
    createdAt
    ref
    name
    rewardValue
    brands
    brandDetails {
      id
      name
      iconUrl
      faceplateUrl
      legalTerms
      description
      availableCountries
      supportedCharities
      redemptionDisclaimer
      redemptionMethods
      denominations
      increment
      maxValue
      minValue
      vendorId
      currency
      isFavorite
    }
    messageTemplate
    headlineTemplate
    allowCharity
    brandsSummary
    isArchived
    requireEmail
    currency
    team {
      id
      name
      defaultPaymentMethodId
      users {
        ...UserFragment
      }
      isAdmin
    }
    private
    isRevSendCurated
    brandTemplateId
  }
}
Variables
{"input": DigitalCampaignInput}
Response
{
  "data": {
    "digitalCampaignCreate": {
      "id": "4",
      "createdAt": "2007-12-03T10:15:30Z",
      "ref": "abc123",
      "name": "xyz789",
      "rewardValue": 987,
      "brands": ["4"],
      "brandDetails": [DigitalBrand],
      "messageTemplate": "xyz789",
      "headlineTemplate": "abc123",
      "allowCharity": true,
      "brandsSummary": "abc123",
      "isArchived": true,
      "requireEmail": true,
      "currency": "USD",
      "team": Team,
      "private": false,
      "isRevSendCurated": false,
      "brandTemplateId": "4"
    }
  }
}

digitalCampaignUpdate

Response

Returns a DigitalCampaign!

Arguments
Name Description
id - ID!
input - DigitalCampaignInput!

Example

Query
mutation DigitalCampaignUpdate(
  $id: ID!,
  $input: DigitalCampaignInput!
) {
  digitalCampaignUpdate(
    id: $id,
    input: $input
  ) {
    id
    createdAt
    ref
    name
    rewardValue
    brands
    brandDetails {
      id
      name
      iconUrl
      faceplateUrl
      legalTerms
      description
      availableCountries
      supportedCharities
      redemptionDisclaimer
      redemptionMethods
      denominations
      increment
      maxValue
      minValue
      vendorId
      currency
      isFavorite
    }
    messageTemplate
    headlineTemplate
    allowCharity
    brandsSummary
    isArchived
    requireEmail
    currency
    team {
      id
      name
      defaultPaymentMethodId
      users {
        ...UserFragment
      }
      isAdmin
    }
    private
    isRevSendCurated
    brandTemplateId
  }
}
Variables
{"id": 4, "input": DigitalCampaignInput}
Response
{
  "data": {
    "digitalCampaignUpdate": {
      "id": "4",
      "createdAt": "2007-12-03T10:15:30Z",
      "ref": "xyz789",
      "name": "abc123",
      "rewardValue": 123,
      "brands": [4],
      "brandDetails": [DigitalBrand],
      "messageTemplate": "xyz789",
      "headlineTemplate": "xyz789",
      "allowCharity": false,
      "brandsSummary": "xyz789",
      "isArchived": false,
      "requireEmail": false,
      "currency": "USD",
      "team": Team,
      "private": true,
      "isRevSendCurated": true,
      "brandTemplateId": 4
    }
  }
}

digitalOrderBatchCsvCreate

Response

Returns a String!

Arguments
Name Description
id - ID!

Example

Query
mutation DigitalOrderBatchCsvCreate($id: ID!) {
  digitalOrderBatchCsvCreate(id: $id)
}
Variables
{"id": 4}
Response
{
  "data": {
    "digitalOrderBatchCsvCreate": "xyz789"
  }
}

digitalOrderBatchMarkDelivered

Response

Returns a Boolean

Arguments
Name Description
batchRef - ID!

Example

Query
mutation DigitalOrderBatchMarkDelivered($batchRef: ID!) {
  digitalOrderBatchMarkDelivered(batchRef: $batchRef)
}
Variables
{"batchRef": "4"}
Response
{"data": {"digitalOrderBatchMarkDelivered": false}}

digitalOrderBulkCreate

Response

Returns a DigitalOrderBatch!

Arguments
Name Description
input - DigitalOrderBulkInput!

Example

Query
mutation DigitalOrderBulkCreate($input: DigitalOrderBulkInput!) {
  digitalOrderBulkCreate(input: $input) {
    id
    ref
    creator {
      id
      name
      email
      role
      budget {
        ...BudgetFragment
      }
      salesForceUserId
      hubSpotUserId
      teams {
        ...UserTeamsFragment
      }
      org {
        ...OrgFragment
      }
      status
      googleEmail
      microsoftEmail
      hideOnboardingModal
      userOnboardingRole
      hubSpotToken {
        ...HubSpotTokenFragment
      }
      apiKeys {
        ...ApiKeyFragment
      }
      budgetReminderEnabled
      shippingUpdatesEnabled
      inviteCode
    }
    createdAt
    totalOrders
    totalDelivered
    totalPaid
    digitalOrders {
      totalCount
      nodes {
        ...DigitalOrderFragment
      }
    }
  }
}
Variables
{"input": DigitalOrderBulkInput}
Response
{
  "data": {
    "digitalOrderBulkCreate": {
      "id": 4,
      "ref": "xyz789",
      "creator": User,
      "createdAt": "2007-12-03T10:15:30Z",
      "totalOrders": 987,
      "totalDelivered": 987,
      "totalPaid": 987,
      "digitalOrders": DigitalOrders
    }
  }
}

digitalOrderCancel

Response

Returns a DigitalOrder!

Arguments
Name Description
id - ID!

Example

Query
mutation DigitalOrderCancel($id: ID!) {
  digitalOrderCancel(id: $id) {
    id
    ref
    createdAt
    rewardValue
    status
    rewardLink
    recipient {
      id
      org {
        ...OrgFragment
      }
      email
      name
      salesForceContactId
      salesForceAccountId
      hubSpotContactId
      hubSpotCompanyId
      orgName
    }
    creator {
      id
      name
      email
      role
      budget {
        ...BudgetFragment
      }
      salesForceUserId
      hubSpotUserId
      teams {
        ...UserTeamsFragment
      }
      org {
        ...OrgFragment
      }
      status
      googleEmail
      microsoftEmail
      hideOnboardingModal
      userOnboardingRole
      hubSpotToken {
        ...HubSpotTokenFragment
      }
      apiKeys {
        ...ApiKeyFragment
      }
      budgetReminderEnabled
      shippingUpdatesEnabled
      inviteCode
    }
    campaign {
      id
      createdAt
      ref
      name
      rewardValue
      brands
      brandDetails {
        ...DigitalBrandFragment
      }
      messageTemplate
      headlineTemplate
      allowCharity
      brandsSummary
      isArchived
      requireEmail
      currency
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    description
    deliveryMethod
    events {
      id
      createdAt
      code
    }
    cancelledAt
    expiresAt
    teamId
  }
}
Variables
{"id": 4}
Response
{
  "data": {
    "digitalOrderCancel": {
      "id": "4",
      "ref": "abc123",
      "createdAt": "2007-12-03T10:15:30Z",
      "rewardValue": 987,
      "status": "PAYMENT_PENDING",
      "rewardLink": "abc123",
      "recipient": Recipient,
      "creator": User,
      "campaign": DigitalCampaign,
      "description": "xyz789",
      "deliveryMethod": "LINK",
      "events": [DigitalOrderEvent],
      "cancelledAt": "2007-12-03T10:15:30Z",
      "expiresAt": "2007-12-03T10:15:30Z",
      "teamId": "abc123"
    }
  }
}

digitalOrderCodeCreate

Response

Returns a Boolean

Arguments
Name Description
input - DigitalOrderCodeInput!

Example

Query
mutation DigitalOrderCodeCreate($input: DigitalOrderCodeInput!) {
  digitalOrderCodeCreate(input: $input)
}
Variables
{"input": DigitalOrderCodeInput}
Response
{"data": {"digitalOrderCodeCreate": false}}

digitalOrderCodeEmailCreate

Response

Returns a Boolean

Arguments
Name Description
orderRef - ID!

Example

Query
mutation DigitalOrderCodeEmailCreate($orderRef: ID!) {
  digitalOrderCodeEmailCreate(orderRef: $orderRef)
}
Variables
{"orderRef": 4}
Response
{"data": {"digitalOrderCodeEmailCreate": true}}

digitalOrderConfirmTremendous

Response

Returns a DigitalBarcode!

Arguments
Name Description
digitalOrderCode - ID!

Example

Query
mutation DigitalOrderConfirmTremendous($digitalOrderCode: ID!) {
  digitalOrderConfirmTremendous(digitalOrderCode: $digitalOrderCode) {
    id
    number
    csc
    barcodeKind
    barcodeValue
    viewCardUrl
  }
}
Variables
{"digitalOrderCode": 4}
Response
{
  "data": {
    "digitalOrderConfirmTremendous": {
      "id": 4,
      "number": "abc123",
      "csc": "xyz789",
      "barcodeKind": "abc123",
      "barcodeValue": "abc123",
      "viewCardUrl": "xyz789"
    }
  }
}

digitalOrderCreate

Response

Returns a DigitalOrder!

Arguments
Name Description
input - DigitalOrderInput!

Example

Query
mutation DigitalOrderCreate($input: DigitalOrderInput!) {
  digitalOrderCreate(input: $input) {
    id
    ref
    createdAt
    rewardValue
    status
    rewardLink
    recipient {
      id
      org {
        ...OrgFragment
      }
      email
      name
      salesForceContactId
      salesForceAccountId
      hubSpotContactId
      hubSpotCompanyId
      orgName
    }
    creator {
      id
      name
      email
      role
      budget {
        ...BudgetFragment
      }
      salesForceUserId
      hubSpotUserId
      teams {
        ...UserTeamsFragment
      }
      org {
        ...OrgFragment
      }
      status
      googleEmail
      microsoftEmail
      hideOnboardingModal
      userOnboardingRole
      hubSpotToken {
        ...HubSpotTokenFragment
      }
      apiKeys {
        ...ApiKeyFragment
      }
      budgetReminderEnabled
      shippingUpdatesEnabled
      inviteCode
    }
    campaign {
      id
      createdAt
      ref
      name
      rewardValue
      brands
      brandDetails {
        ...DigitalBrandFragment
      }
      messageTemplate
      headlineTemplate
      allowCharity
      brandsSummary
      isArchived
      requireEmail
      currency
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    description
    deliveryMethod
    events {
      id
      createdAt
      code
    }
    cancelledAt
    expiresAt
    teamId
  }
}
Variables
{"input": DigitalOrderInput}
Response
{
  "data": {
    "digitalOrderCreate": {
      "id": "4",
      "ref": "xyz789",
      "createdAt": "2007-12-03T10:15:30Z",
      "rewardValue": 123,
      "status": "PAYMENT_PENDING",
      "rewardLink": "xyz789",
      "recipient": Recipient,
      "creator": User,
      "campaign": DigitalCampaign,
      "description": "xyz789",
      "deliveryMethod": "LINK",
      "events": [DigitalOrderEvent],
      "cancelledAt": "2007-12-03T10:15:30Z",
      "expiresAt": "2007-12-03T10:15:30Z",
      "teamId": "abc123"
    }
  }
}

digitalOrderEmailCreate

Response

Returns a Boolean

Arguments
Name Description
orderRef - ID!

Example

Query
mutation DigitalOrderEmailCreate($orderRef: ID!) {
  digitalOrderEmailCreate(orderRef: $orderRef)
}
Variables
{"orderRef": 4}
Response
{"data": {"digitalOrderEmailCreate": true}}

digitalOrderMarkDelivered

Response

Returns a Boolean

Arguments
Name Description
orderRef - ID!

Example

Query
mutation DigitalOrderMarkDelivered($orderRef: ID!) {
  digitalOrderMarkDelivered(orderRef: $orderRef)
}
Variables
{"orderRef": "4"}
Response
{"data": {"digitalOrderMarkDelivered": true}}

digitalOrdersCsvCreate

Response

Returns a String!

Arguments
Name Description
query - DigitalOrderQuery

Example

Query
mutation DigitalOrdersCsvCreate($query: DigitalOrderQuery) {
  digitalOrdersCsvCreate(query: $query)
}
Variables
{"query": DigitalOrderQuery}
Response
{
  "data": {
    "digitalOrdersCsvCreate": "xyz789"
  }
}

fundsAdd

Response

Returns a Boolean

Arguments
Name Description
input - FundsInput!

Example

Query
mutation FundsAdd($input: FundsInput!) {
  fundsAdd(input: $input)
}
Variables
{"input": FundsInput}
Response
{"data": {"fundsAdd": true}}

fundsAddBulk

Response

Returns a Boolean

Arguments
Name Description
input - [FundsInput!]!

Example

Query
mutation FundsAddBulk($input: [FundsInput!]!) {
  fundsAddBulk(input: $input)
}
Variables
{"input": [FundsInput]}
Response
{"data": {"fundsAddBulk": true}}

fundsMove

Response

Returns a Boolean

Arguments
Name Description
input - FundsMoveInput!

Example

Query
mutation FundsMove($input: FundsMoveInput!) {
  fundsMove(input: $input)
}
Variables
{"input": FundsMoveInput}
Response
{"data": {"fundsMove": true}}

googleEmailPermissionVerify

Response

Returns an EmailPermissionVerification!

Example

Query
mutation GoogleEmailPermissionVerify {
  googleEmailPermissionVerify {
    hasPermission
    message
  }
}
Response
{
  "data": {
    "googleEmailPermissionVerify": {
      "hasPermission": true,
      "message": "xyz789"
    }
  }
}

googleTokenCreate

Response

Returns a Boolean

Arguments
Name Description
code - String!

Example

Query
mutation GoogleTokenCreate($code: String!) {
  googleTokenCreate(code: $code)
}
Variables
{"code": "abc123"}
Response
{"data": {"googleTokenCreate": true}}

googleTokenDelete

Response

Returns a Boolean

Example

Query
mutation GoogleTokenDelete {
  googleTokenDelete
}
Response
{"data": {"googleTokenDelete": true}}

hideUserOnboardingModal

Response

Returns a Boolean

Example

Query
mutation HideUserOnboardingModal {
  hideUserOnboardingModal
}
Response
{"data": {"hideUserOnboardingModal": true}}

hubSpotTokenCreate

Response

Returns a HubSpotToken!

Arguments
Name Description
input - HubSpotTokenInput!

Example

Query
mutation HubSpotTokenCreate($input: HubSpotTokenInput!) {
  hubSpotTokenCreate(input: $input) {
    user
    hubDomain
    hubId
    appId
    hubSpotUserId
  }
}
Variables
{"input": HubSpotTokenInput}
Response
{
  "data": {
    "hubSpotTokenCreate": {
      "user": "abc123",
      "hubDomain": "xyz789",
      "hubId": "4",
      "appId": 4,
      "hubSpotUserId": "4"
    }
  }
}

hubSpotTokenDelete

Response

Returns a Boolean

Example

Query
mutation HubSpotTokenDelete {
  hubSpotTokenDelete
}
Response
{"data": {"hubSpotTokenDelete": true}}

integrationWebhookCreate

Response

Returns a WebhookCreateResponse!

Arguments
Name Description
input - WebhookCreateInput!

Example

Query
mutation IntegrationWebhookCreate($input: WebhookCreateInput!) {
  integrationWebhookCreate(input: $input) {
    id
  }
}
Variables
{"input": WebhookCreateInput}
Response
{
  "data": {
    "integrationWebhookCreate": {
      "id": "xyz789"
    }
  }
}

integrationWebhookDelete

Response

Returns a String!

Arguments
Name Description
input - WebhookDeleteInput!

Example

Query
mutation IntegrationWebhookDelete($input: WebhookDeleteInput!) {
  integrationWebhookDelete(input: $input)
}
Variables
{"input": WebhookDeleteInput}
Response
{
  "data": {
    "integrationWebhookDelete": "xyz789"
  }
}

inviteAccept

Response

Returns a Boolean

Arguments
Name Description
input - AcceptInviteInput!

Example

Query
mutation InviteAccept($input: AcceptInviteInput!) {
  inviteAccept(input: $input)
}
Variables
{"input": AcceptInviteInput}
Response
{"data": {"inviteAccept": true}}

inviteResend

Response

Returns a Boolean

Arguments
Name Description
input - ResendInviteInput!

Example

Query
mutation InviteResend($input: ResendInviteInput!) {
  inviteResend(input: $input)
}
Variables
{"input": ResendInviteInput}
Response
{"data": {"inviteResend": false}}

inviteRevoke

Response

Returns a Boolean

Arguments
Name Description
input - RevokeInviteInput!

Example

Query
mutation InviteRevoke($input: RevokeInviteInput!) {
  inviteRevoke(input: $input)
}
Variables
{"input": RevokeInviteInput}
Response
{"data": {"inviteRevoke": true}}

invoiceItemCreate

Response

Returns an InvoiceItem!

Arguments
Name Description
input - InvoiceItemInput!

Example

Query
mutation InvoiceItemCreate($input: InvoiceItemInput!) {
  invoiceItemCreate(input: $input) {
    id
    createdAt
    amount
    description
  }
}
Variables
{"input": InvoiceItemInput}
Response
{
  "data": {
    "invoiceItemCreate": {
      "id": "4",
      "createdAt": "2007-12-03T10:15:30Z",
      "amount": 123,
      "description": "abc123"
    }
  }
}

loginWithGoogle

Response

Returns an AuthenticationRedirectResponse!

Arguments
Name Description
credential - String!

Example

Query
mutation LoginWithGoogle($credential: String!) {
  loginWithGoogle(credential: $credential) {
    redirectUrl
    requiresRedirect
    token
  }
}
Variables
{"credential": "abc123"}
Response
{
  "data": {
    "loginWithGoogle": {
      "redirectUrl": "abc123",
      "requiresRedirect": false,
      "token": "xyz789"
    }
  }
}

loginWithMicrosoft

Response

Returns an AuthenticationRedirectResponse!

Arguments
Name Description
credential - String!

Example

Query
mutation LoginWithMicrosoft($credential: String!) {
  loginWithMicrosoft(credential: $credential) {
    redirectUrl
    requiresRedirect
    token
  }
}
Variables
{"credential": "xyz789"}
Response
{
  "data": {
    "loginWithMicrosoft": {
      "redirectUrl": "abc123",
      "requiresRedirect": true,
      "token": "xyz789"
    }
  }
}

loginWithOkta

Response

Returns a String!

Arguments
Name Description
token - String!

Example

Query
mutation LoginWithOkta($token: String!) {
  loginWithOkta(token: $token)
}
Variables
{"token": "xyz789"}
Response
{"data": {"loginWithOkta": "abc123"}}

microsoftEmailPermissionVerify

Response

Returns an EmailPermissionVerification!

Example

Query
mutation MicrosoftEmailPermissionVerify {
  microsoftEmailPermissionVerify {
    hasPermission
    message
  }
}
Response
{
  "data": {
    "microsoftEmailPermissionVerify": {
      "hasPermission": true,
      "message": "abc123"
    }
  }
}

microsoftTokenCreate

Response

Returns a Boolean

Arguments
Name Description
code - String!

Example

Query
mutation MicrosoftTokenCreate($code: String!) {
  microsoftTokenCreate(code: $code)
}
Variables
{"code": "abc123"}
Response
{"data": {"microsoftTokenCreate": true}}

microsoftTokenDelete

Response

Returns a Boolean

Example

Query
mutation MicrosoftTokenDelete {
  microsoftTokenDelete
}
Response
{"data": {"microsoftTokenDelete": true}}

modifyUserRole

Response

Returns a Boolean

Arguments
Name Description
input - ModifyUserRoleInput!

Example

Query
mutation ModifyUserRole($input: ModifyUserRoleInput!) {
  modifyUserRole(input: $input)
}
Variables
{"input": ModifyUserRoleInput}
Response
{"data": {"modifyUserRole": true}}

oAuthGenerateCode

Response

Returns a String!

Example

Query
mutation OAuthGenerateCode {
  oAuthGenerateCode
}
Response
{"data": {"oAuthGenerateCode": "xyz789"}}

orderSendThankYou

Response

Returns a ThankYouResult!

Arguments
Name Description
input - ThankYouInput!

Example

Query
mutation OrderSendThankYou($input: ThankYouInput!) {
  orderSendThankYou(input: $input) {
    success
    message
  }
}
Variables
{"input": ThankYouInput}
Response
{
  "data": {
    "orderSendThankYou": {
      "success": false,
      "message": "abc123"
    }
  }
}

ordersCsvCreate

Response

Returns a String!

Arguments
Name Description
query - OrderQuery
myOrders - Boolean
sort - OrderSortKey

Example

Query
mutation OrdersCsvCreate(
  $query: OrderQuery,
  $myOrders: Boolean,
  $sort: OrderSortKey
) {
  ordersCsvCreate(
    query: $query,
    myOrders: $myOrders,
    sort: $sort
  )
}
Variables
{
  "query": OrderQuery,
  "myOrders": true,
  "sort": "CREATED_AT_ASC"
}
Response
{"data": {"ordersCsvCreate": "xyz789"}}

orgAcceptTerms

Response

Returns a Boolean!

Arguments
Name Description
price - String
seats - Int

Example

Query
mutation OrgAcceptTerms(
  $price: String,
  $seats: Int
) {
  orgAcceptTerms(
    price: $price,
    seats: $seats
  )
}
Variables
{"price": "abc123", "seats": 987}
Response
{"data": {"orgAcceptTerms": false}}

orgBrandTemplateCreate

Response

Returns an OrgBrandTemplate!

Arguments
Name Description
input - OrgBrandTemplateInput!

Example

Query
mutation OrgBrandTemplateCreate($input: OrgBrandTemplateInput!) {
  orgBrandTemplateCreate(input: $input) {
    id
    name
    logoUrl
    logoBackgroundColor
    logoPrimaryColor
    handwritingFontStyle
    isDefault
  }
}
Variables
{"input": OrgBrandTemplateInput}
Response
{
  "data": {
    "orgBrandTemplateCreate": {
      "id": 4,
      "name": "xyz789",
      "logoUrl": "xyz789",
      "logoBackgroundColor": "abc123",
      "logoPrimaryColor": "xyz789",
      "handwritingFontStyle": "CLEAN",
      "isDefault": false
    }
  }
}

orgBrandTemplateDelete

Response

Returns a Boolean!

Arguments
Name Description
id - ID!

Example

Query
mutation OrgBrandTemplateDelete($id: ID!) {
  orgBrandTemplateDelete(id: $id)
}
Variables
{"id": "4"}
Response
{"data": {"orgBrandTemplateDelete": false}}

orgBrandTemplateUpdate

Response

Returns an OrgBrandTemplate!

Arguments
Name Description
id - ID!
input - OrgBrandTemplateInput!

Example

Query
mutation OrgBrandTemplateUpdate(
  $id: ID!,
  $input: OrgBrandTemplateInput!
) {
  orgBrandTemplateUpdate(
    id: $id,
    input: $input
  ) {
    id
    name
    logoUrl
    logoBackgroundColor
    logoPrimaryColor
    handwritingFontStyle
    isDefault
  }
}
Variables
{
  "id": "4",
  "input": OrgBrandTemplateInput
}
Response
{
  "data": {
    "orgBrandTemplateUpdate": {
      "id": "4",
      "name": "xyz789",
      "logoUrl": "abc123",
      "logoBackgroundColor": "xyz789",
      "logoPrimaryColor": "abc123",
      "handwritingFontStyle": "CLEAN",
      "isDefault": false
    }
  }
}

orgCancelSubscription

Response

Returns a Boolean!

Example

Query
mutation OrgCancelSubscription {
  orgCancelSubscription
}
Response
{"data": {"orgCancelSubscription": false}}

orgSetDefaultBrandTemplate

Response

Returns an Org!

Arguments
Name Description
id - ID!

Example

Query
mutation OrgSetDefaultBrandTemplate($id: ID!) {
  orgSetDefaultBrandTemplate(id: $id) {
    id
    name
    formattedName
    users {
      totalCount
      nodes {
        ...UserFragment
      }
    }
    logoUrl
    logoBackgroundColor
    logoPrimaryColor
    defaultBrandTemplateId
    defaultBrandTemplate {
      id
      name
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
      handwritingFontStyle
      isDefault
    }
    brandTemplates {
      id
      name
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
      handwritingFontStyle
      isDefault
    }
    isInternational
    subscriptionPlan {
      id
      canUseWarehouse
    }
    hubSpotUserInfo {
      id
      displayName
    }
    hubSpotUsers {
      id
      name
      email
    }
    salesForceUserInfo {
      id
      username
      nickName
      displayName
    }
    salesForceUsers {
      id
      name
      email
    }
    onBoardingDetails {
      price
      trialDays
      seats
      acceptedTerms
      completed
      verified
    }
    teams {
      id
      name
      defaultPaymentMethodId
      users {
        ...UsersWithTeamFragment
      }
    }
    budgetAlertDefaultThreshold
  }
}
Variables
{"id": 4}
Response
{
  "data": {
    "orgSetDefaultBrandTemplate": {
      "id": "4",
      "name": "abc123",
      "formattedName": "abc123",
      "users": Users,
      "logoUrl": "abc123",
      "logoBackgroundColor": "abc123",
      "logoPrimaryColor": "abc123",
      "defaultBrandTemplateId": 4,
      "defaultBrandTemplate": OrgBrandTemplate,
      "brandTemplates": [OrgBrandTemplate],
      "isInternational": false,
      "subscriptionPlan": SubscriptionPlan,
      "hubSpotUserInfo": HubSpotUserInfo,
      "hubSpotUsers": [HubSpotUser],
      "salesForceUserInfo": SalesForceUserInfo,
      "salesForceUsers": [SalesForceUser],
      "onBoardingDetails": OnBoardingDetails,
      "teams": [Teams],
      "budgetAlertDefaultThreshold": 123
    }
  }
}

orgUpdate

Response

Returns an Org!

Arguments
Name Description
id - ID!
input - OrgInput!

Example

Query
mutation OrgUpdate(
  $id: ID!,
  $input: OrgInput!
) {
  orgUpdate(
    id: $id,
    input: $input
  ) {
    id
    name
    formattedName
    users {
      totalCount
      nodes {
        ...UserFragment
      }
    }
    logoUrl
    logoBackgroundColor
    logoPrimaryColor
    defaultBrandTemplateId
    defaultBrandTemplate {
      id
      name
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
      handwritingFontStyle
      isDefault
    }
    brandTemplates {
      id
      name
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
      handwritingFontStyle
      isDefault
    }
    isInternational
    subscriptionPlan {
      id
      canUseWarehouse
    }
    hubSpotUserInfo {
      id
      displayName
    }
    hubSpotUsers {
      id
      name
      email
    }
    salesForceUserInfo {
      id
      username
      nickName
      displayName
    }
    salesForceUsers {
      id
      name
      email
    }
    onBoardingDetails {
      price
      trialDays
      seats
      acceptedTerms
      completed
      verified
    }
    teams {
      id
      name
      defaultPaymentMethodId
      users {
        ...UsersWithTeamFragment
      }
    }
    budgetAlertDefaultThreshold
  }
}
Variables
{"id": 4, "input": OrgInput}
Response
{
  "data": {
    "orgUpdate": {
      "id": 4,
      "name": "abc123",
      "formattedName": "xyz789",
      "users": Users,
      "logoUrl": "xyz789",
      "logoBackgroundColor": "abc123",
      "logoPrimaryColor": "xyz789",
      "defaultBrandTemplateId": "4",
      "defaultBrandTemplate": OrgBrandTemplate,
      "brandTemplates": [OrgBrandTemplate],
      "isInternational": false,
      "subscriptionPlan": SubscriptionPlan,
      "hubSpotUserInfo": HubSpotUserInfo,
      "hubSpotUsers": [HubSpotUser],
      "salesForceUserInfo": SalesForceUserInfo,
      "salesForceUsers": [SalesForceUser],
      "onBoardingDetails": OnBoardingDetails,
      "teams": [Teams],
      "budgetAlertDefaultThreshold": 987
    }
  }
}

orgUpdateSubscription

Response

Returns a Boolean!

Arguments
Name Description
priceId - String!

Example

Query
mutation OrgUpdateSubscription($priceId: String!) {
  orgUpdateSubscription(priceId: $priceId)
}
Variables
{"priceId": "xyz789"}
Response
{"data": {"orgUpdateSubscription": false}}

partyLinkCancelAndRefund

Response

Returns a PartyLinkCancelAndRefundResult!

Arguments
Name Description
id - ID!

Example

Query
mutation PartyLinkCancelAndRefund($id: ID!) {
  partyLinkCancelAndRefund(id: $id) {
    success
    message
    refundedAmount
    partyLink {
      id
      code
      createdAt
      updatedAt
      type
      digitalCampaign {
        ...DigitalCampaignFragment
      }
      physicalCampaign {
        ...PhysicalCampaignFragment
      }
      approvalCriteriaType
      approvedEmails
      maxClaimCount
      claimCount
      isActive
      cancelledAt
      sendAll
      totalAmountCharged
      availableOptions {
        ...PartyLinkOptionFragment
      }
      creator {
        ...UserFragment
      }
      team {
        ...TeamFragment
      }
      org {
        ...OrgFragment
      }
      claims {
        ...PartyLinkClaimsFragment
      }
    }
  }
}
Variables
{"id": "4"}
Response
{
  "data": {
    "partyLinkCancelAndRefund": {
      "success": false,
      "message": "xyz789",
      "refundedAmount": 987,
      "partyLink": PartyLink
    }
  }
}

partyLinkClaim

Response

Returns a PartyLinkClaimResult!

Arguments
Name Description
input - PartyLinkClaimInput!

Example

Query
mutation PartyLinkClaim($input: PartyLinkClaimInput!) {
  partyLinkClaim(input: $input) {
    success
    message
    digitalOrder {
      id
      ref
      createdAt
      rewardValue
      status
      rewardLink
      recipient {
        ...RecipientFragment
      }
      creator {
        ...UserFragment
      }
      campaign {
        ...DigitalCampaignFragment
      }
      description
      deliveryMethod
      events {
        ...DigitalOrderEventFragment
      }
      cancelledAt
      expiresAt
      teamId
    }
    physicalOrder {
      id
      ref
      createdAt
      recipient {
        ...RecipientFragment
      }
      isAddressConfirmed
      addressConfirmedDate
      markPurchased
      markPrinted
      recipientSubmitsAddress
      creatorName
      creatorEmail
      orgName
      orgBranding {
        ...OrgBrandingFragment
      }
      vendorName
      message
      physicalNote
      invoiceItems {
        ...InvoiceItemFragment
      }
      batchId
      mailingAddress {
        ...MailingAddressFragment
      }
      purchaseUrl
      description
      shopifyOrderId
      shopifyOrderName
      gifts {
        ...PhysicalGiftFragment
      }
      sendAll
      campaign {
        ...PhysicalCampaignFragment
      }
      vendorOrderId
      costToRevSend
      fulfillmentEvents {
        ...FulfillmentEventFragment
      }
      images {
        ...ImageFragment
      }
      giftChoices {
        ...PhysicalGiftFragment
      }
      selectedGifts {
        ...PhysicalGiftFragment
      }
      hideContents
      isThirdParty
      shipsThroughWarehouse
      cancelledAt
      needsToSelectGift
      includeHandwritten
      fontStyle
      expiresAt
      isExpired
    }
    partyLink {
      id
      code
      createdAt
      updatedAt
      type
      digitalCampaign {
        ...DigitalCampaignFragment
      }
      physicalCampaign {
        ...PhysicalCampaignFragment
      }
      approvalCriteriaType
      approvedEmails
      maxClaimCount
      claimCount
      isActive
      cancelledAt
      sendAll
      totalAmountCharged
      availableOptions {
        ...PartyLinkOptionFragment
      }
      creator {
        ...UserFragment
      }
      team {
        ...TeamFragment
      }
      org {
        ...OrgFragment
      }
      claims {
        ...PartyLinkClaimsFragment
      }
    }
  }
}
Variables
{"input": PartyLinkClaimInput}
Response
{
  "data": {
    "partyLinkClaim": {
      "success": true,
      "message": "xyz789",
      "digitalOrder": DigitalOrder,
      "physicalOrder": PhysicalOrder,
      "partyLink": PartyLink
    }
  }
}

partyLinkClaimEligibility

Arguments
Name Description
input - PartyLinkClaimEligibilityInput!

Example

Query
mutation PartyLinkClaimEligibility($input: PartyLinkClaimEligibilityInput!) {
  partyLinkClaimEligibility(input: $input) {
    success
    message
  }
}
Variables
{"input": PartyLinkClaimEligibilityInput}
Response
{
  "data": {
    "partyLinkClaimEligibility": {
      "success": false,
      "message": "xyz789"
    }
  }
}

partyLinkCreate

Response

Returns a PartyLink!

Arguments
Name Description
input - PartyLinkInput!

Example

Query
mutation PartyLinkCreate($input: PartyLinkInput!) {
  partyLinkCreate(input: $input) {
    id
    code
    createdAt
    updatedAt
    type
    digitalCampaign {
      id
      createdAt
      ref
      name
      rewardValue
      brands
      brandDetails {
        ...DigitalBrandFragment
      }
      messageTemplate
      headlineTemplate
      allowCharity
      brandsSummary
      isArchived
      requireEmail
      currency
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    physicalCampaign {
      id
      ref
      createdAt
      name
      gifts {
        ...PhysicalGiftFragment
      }
      variants
      messageTemplate
      physicalNoteTemplate
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    approvalCriteriaType
    approvedEmails
    maxClaimCount
    claimCount
    isActive
    cancelledAt
    sendAll
    totalAmountCharged
    availableOptions {
      id
      type
      title
      subtitle
      imageUrl
      digitalCampaignId
      physicalCampaignId
      physicalGiftId
      variantId
    }
    creator {
      id
      name
      email
      role
      budget {
        ...BudgetFragment
      }
      salesForceUserId
      hubSpotUserId
      teams {
        ...UserTeamsFragment
      }
      org {
        ...OrgFragment
      }
      status
      googleEmail
      microsoftEmail
      hideOnboardingModal
      userOnboardingRole
      hubSpotToken {
        ...HubSpotTokenFragment
      }
      apiKeys {
        ...ApiKeyFragment
      }
      budgetReminderEnabled
      shippingUpdatesEnabled
      inviteCode
    }
    team {
      id
      name
      defaultPaymentMethodId
      users {
        ...UserFragment
      }
      isAdmin
    }
    org {
      id
      name
      formattedName
      users {
        ...UsersFragment
      }
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
      defaultBrandTemplateId
      defaultBrandTemplate {
        ...OrgBrandTemplateFragment
      }
      brandTemplates {
        ...OrgBrandTemplateFragment
      }
      isInternational
      subscriptionPlan {
        ...SubscriptionPlanFragment
      }
      hubSpotUserInfo {
        ...HubSpotUserInfoFragment
      }
      hubSpotUsers {
        ...HubSpotUserFragment
      }
      salesForceUserInfo {
        ...SalesForceUserInfoFragment
      }
      salesForceUsers {
        ...SalesForceUserFragment
      }
      onBoardingDetails {
        ...OnBoardingDetailsFragment
      }
      teams {
        ...TeamsFragment
      }
      budgetAlertDefaultThreshold
    }
    claims {
      totalCount
      nodes {
        ...PartyLinkClaimFragment
      }
    }
  }
}
Variables
{"input": PartyLinkInput}
Response
{
  "data": {
    "partyLinkCreate": {
      "id": 4,
      "code": "abc123",
      "createdAt": "2007-12-03T10:15:30Z",
      "updatedAt": "2007-12-03T10:15:30Z",
      "type": "DIGITAL",
      "digitalCampaign": DigitalCampaign,
      "physicalCampaign": PhysicalCampaign,
      "approvalCriteriaType": "EMAIL_LIST",
      "approvedEmails": ["xyz789"],
      "maxClaimCount": 123,
      "claimCount": 987,
      "isActive": true,
      "cancelledAt": "2007-12-03T10:15:30Z",
      "sendAll": false,
      "totalAmountCharged": 987,
      "availableOptions": [PartyLinkOption],
      "creator": User,
      "team": Team,
      "org": Org,
      "claims": PartyLinkClaims
    }
  }
}

partyLinkUpdate

Response

Returns a PartyLink!

Arguments
Name Description
id - ID!
isActive - Boolean!

Example

Query
mutation PartyLinkUpdate(
  $id: ID!,
  $isActive: Boolean!
) {
  partyLinkUpdate(
    id: $id,
    isActive: $isActive
  ) {
    id
    code
    createdAt
    updatedAt
    type
    digitalCampaign {
      id
      createdAt
      ref
      name
      rewardValue
      brands
      brandDetails {
        ...DigitalBrandFragment
      }
      messageTemplate
      headlineTemplate
      allowCharity
      brandsSummary
      isArchived
      requireEmail
      currency
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    physicalCampaign {
      id
      ref
      createdAt
      name
      gifts {
        ...PhysicalGiftFragment
      }
      variants
      messageTemplate
      physicalNoteTemplate
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    approvalCriteriaType
    approvedEmails
    maxClaimCount
    claimCount
    isActive
    cancelledAt
    sendAll
    totalAmountCharged
    availableOptions {
      id
      type
      title
      subtitle
      imageUrl
      digitalCampaignId
      physicalCampaignId
      physicalGiftId
      variantId
    }
    creator {
      id
      name
      email
      role
      budget {
        ...BudgetFragment
      }
      salesForceUserId
      hubSpotUserId
      teams {
        ...UserTeamsFragment
      }
      org {
        ...OrgFragment
      }
      status
      googleEmail
      microsoftEmail
      hideOnboardingModal
      userOnboardingRole
      hubSpotToken {
        ...HubSpotTokenFragment
      }
      apiKeys {
        ...ApiKeyFragment
      }
      budgetReminderEnabled
      shippingUpdatesEnabled
      inviteCode
    }
    team {
      id
      name
      defaultPaymentMethodId
      users {
        ...UserFragment
      }
      isAdmin
    }
    org {
      id
      name
      formattedName
      users {
        ...UsersFragment
      }
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
      defaultBrandTemplateId
      defaultBrandTemplate {
        ...OrgBrandTemplateFragment
      }
      brandTemplates {
        ...OrgBrandTemplateFragment
      }
      isInternational
      subscriptionPlan {
        ...SubscriptionPlanFragment
      }
      hubSpotUserInfo {
        ...HubSpotUserInfoFragment
      }
      hubSpotUsers {
        ...HubSpotUserFragment
      }
      salesForceUserInfo {
        ...SalesForceUserInfoFragment
      }
      salesForceUsers {
        ...SalesForceUserFragment
      }
      onBoardingDetails {
        ...OnBoardingDetailsFragment
      }
      teams {
        ...TeamsFragment
      }
      budgetAlertDefaultThreshold
    }
    claims {
      totalCount
      nodes {
        ...PartyLinkClaimFragment
      }
    }
  }
}
Variables
{"id": 4, "isActive": false}
Response
{
  "data": {
    "partyLinkUpdate": {
      "id": "4",
      "code": "xyz789",
      "createdAt": "2007-12-03T10:15:30Z",
      "updatedAt": "2007-12-03T10:15:30Z",
      "type": "DIGITAL",
      "digitalCampaign": DigitalCampaign,
      "physicalCampaign": PhysicalCampaign,
      "approvalCriteriaType": "EMAIL_LIST",
      "approvedEmails": ["abc123"],
      "maxClaimCount": 123,
      "claimCount": 123,
      "isActive": true,
      "cancelledAt": "2007-12-03T10:15:30Z",
      "sendAll": false,
      "totalAmountCharged": 123,
      "availableOptions": [PartyLinkOption],
      "creator": User,
      "team": Team,
      "org": Org,
      "claims": PartyLinkClaims
    }
  }
}

physicalCampaignCreate

Response

Returns a PhysicalCampaign!

Arguments
Name Description
input - PhysicalCampaignInput!

Example

Query
mutation PhysicalCampaignCreate($input: PhysicalCampaignInput!) {
  physicalCampaignCreate(input: $input) {
    id
    ref
    createdAt
    name
    gifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    variants
    messageTemplate
    physicalNoteTemplate
    team {
      id
      name
      defaultPaymentMethodId
      users {
        ...UserFragment
      }
      isAdmin
    }
    private
    isRevSendCurated
    brandTemplateId
  }
}
Variables
{"input": PhysicalCampaignInput}
Response
{
  "data": {
    "physicalCampaignCreate": {
      "id": "4",
      "ref": "abc123",
      "createdAt": "2007-12-03T10:15:30Z",
      "name": "xyz789",
      "gifts": [PhysicalGift],
      "variants": [4],
      "messageTemplate": "xyz789",
      "physicalNoteTemplate": "abc123",
      "team": Team,
      "private": true,
      "isRevSendCurated": false,
      "brandTemplateId": "4"
    }
  }
}

physicalCampaignUpdate

Response

Returns a PhysicalCampaign!

Arguments
Name Description
id - ID!
input - PhysicalCampaignInput!

Example

Query
mutation PhysicalCampaignUpdate(
  $id: ID!,
  $input: PhysicalCampaignInput!
) {
  physicalCampaignUpdate(
    id: $id,
    input: $input
  ) {
    id
    ref
    createdAt
    name
    gifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    variants
    messageTemplate
    physicalNoteTemplate
    team {
      id
      name
      defaultPaymentMethodId
      users {
        ...UserFragment
      }
      isAdmin
    }
    private
    isRevSendCurated
    brandTemplateId
  }
}
Variables
{"id": 4, "input": PhysicalCampaignInput}
Response
{
  "data": {
    "physicalCampaignUpdate": {
      "id": 4,
      "ref": "xyz789",
      "createdAt": "2007-12-03T10:15:30Z",
      "name": "xyz789",
      "gifts": [PhysicalGift],
      "variants": [4],
      "messageTemplate": "abc123",
      "physicalNoteTemplate": "abc123",
      "team": Team,
      "private": true,
      "isRevSendCurated": true,
      "brandTemplateId": "4"
    }
  }
}

physicalGiftCreate

Response

Returns a PhysicalGift!

Arguments
Name Description
input - PhysicalGiftInput!

Example

Query
mutation PhysicalGiftCreate($input: PhysicalGiftInput!) {
  physicalGiftCreate(input: $input) {
    id
    title
    messageMaxLength
    messageMaxLines
    descriptionHtml
    featuredImageSrc
    initialShippingCost
    products {
      id
      org {
        ...OrgFragment
      }
      title
      isAddon
      images {
        ...ImageFragment
      }
      variants {
        ...ProductVariantFragment
      }
      totalInventory
    }
    productVariants {
      id
      price
      images {
        ...ImageFragment
      }
      title
    }
    isDisabled
    categories
    occasions
    isThirdParty
    shipsThroughWarehouse
    isDropshipped
    isAddOn
    hideInPreview
    purchaseUrl
    vendor {
      id
      name
      messageMaxLength
      messageMaxLines
    }
    orgId
    requiresPhone
    isFavorite
    selectedVariant {
      id
      price
      images {
        ...ImageFragment
      }
      title
    }
    optionId
    meta
  }
}
Variables
{"input": PhysicalGiftInput}
Response
{
  "data": {
    "physicalGiftCreate": {
      "id": 4,
      "title": "xyz789",
      "messageMaxLength": 123,
      "messageMaxLines": 123,
      "descriptionHtml": "abc123",
      "featuredImageSrc": "abc123",
      "initialShippingCost": 987,
      "products": [Product],
      "productVariants": [ProductVariant],
      "isDisabled": true,
      "categories": ["xyz789"],
      "occasions": ["abc123"],
      "isThirdParty": false,
      "shipsThroughWarehouse": true,
      "isDropshipped": true,
      "isAddOn": true,
      "hideInPreview": true,
      "purchaseUrl": "xyz789",
      "vendor": PhysicalVendor,
      "orgId": "abc123",
      "requiresPhone": false,
      "isFavorite": false,
      "selectedVariant": ProductVariant,
      "optionId": 4,
      "meta": {}
    }
  }
}

physicalGiftRemoveFavorite

Response

Returns a Boolean!

Arguments
Name Description
id - ID!

Example

Query
mutation PhysicalGiftRemoveFavorite($id: ID!) {
  physicalGiftRemoveFavorite(id: $id)
}
Variables
{"id": "4"}
Response
{"data": {"physicalGiftRemoveFavorite": false}}

physicalGiftSetFavorite

Response

Returns a Boolean!

Arguments
Name Description
id - ID!

Example

Query
mutation PhysicalGiftSetFavorite($id: ID!) {
  physicalGiftSetFavorite(id: $id)
}
Variables
{"id": "4"}
Response
{"data": {"physicalGiftSetFavorite": false}}

physicalGiftUpdate

Response

Returns a PhysicalGift!

Arguments
Name Description
id - ID!
input - PhysicalGiftInput!

Example

Query
mutation PhysicalGiftUpdate(
  $id: ID!,
  $input: PhysicalGiftInput!
) {
  physicalGiftUpdate(
    id: $id,
    input: $input
  ) {
    id
    title
    messageMaxLength
    messageMaxLines
    descriptionHtml
    featuredImageSrc
    initialShippingCost
    products {
      id
      org {
        ...OrgFragment
      }
      title
      isAddon
      images {
        ...ImageFragment
      }
      variants {
        ...ProductVariantFragment
      }
      totalInventory
    }
    productVariants {
      id
      price
      images {
        ...ImageFragment
      }
      title
    }
    isDisabled
    categories
    occasions
    isThirdParty
    shipsThroughWarehouse
    isDropshipped
    isAddOn
    hideInPreview
    purchaseUrl
    vendor {
      id
      name
      messageMaxLength
      messageMaxLines
    }
    orgId
    requiresPhone
    isFavorite
    selectedVariant {
      id
      price
      images {
        ...ImageFragment
      }
      title
    }
    optionId
    meta
  }
}
Variables
{"id": 4, "input": PhysicalGiftInput}
Response
{
  "data": {
    "physicalGiftUpdate": {
      "id": 4,
      "title": "abc123",
      "messageMaxLength": 987,
      "messageMaxLines": 987,
      "descriptionHtml": "xyz789",
      "featuredImageSrc": "abc123",
      "initialShippingCost": 123,
      "products": [Product],
      "productVariants": [ProductVariant],
      "isDisabled": true,
      "categories": ["abc123"],
      "occasions": ["abc123"],
      "isThirdParty": true,
      "shipsThroughWarehouse": true,
      "isDropshipped": false,
      "isAddOn": true,
      "hideInPreview": false,
      "purchaseUrl": "xyz789",
      "vendor": PhysicalVendor,
      "orgId": "abc123",
      "requiresPhone": false,
      "isFavorite": false,
      "selectedVariant": ProductVariant,
      "optionId": 4,
      "meta": {}
    }
  }
}

physicalOrderBulkCreate

Response

Returns a PhysicalOrderBatch!

Arguments
Name Description
input - PhysicalOrderBulkCreateInput!

Example

Query
mutation PhysicalOrderBulkCreate($input: PhysicalOrderBulkCreateInput!) {
  physicalOrderBulkCreate(input: $input) {
    id
    ref
    creator {
      id
      name
      email
      role
      budget {
        ...BudgetFragment
      }
      salesForceUserId
      hubSpotUserId
      teams {
        ...UserTeamsFragment
      }
      org {
        ...OrgFragment
      }
      status
      googleEmail
      microsoftEmail
      hideOnboardingModal
      userOnboardingRole
      hubSpotToken {
        ...HubSpotTokenFragment
      }
      apiKeys {
        ...ApiKeyFragment
      }
      budgetReminderEnabled
      shippingUpdatesEnabled
      inviteCode
    }
    createdAt
    totalOrders
    totalDelivered
    totalPaid
    physicalOrders {
      totalCount
      nodes {
        ...PhysicalOrderFragment
      }
    }
  }
}
Variables
{"input": PhysicalOrderBulkCreateInput}
Response
{
  "data": {
    "physicalOrderBulkCreate": {
      "id": "4",
      "ref": "abc123",
      "creator": User,
      "createdAt": "2007-12-03T10:15:30Z",
      "totalOrders": 987,
      "totalDelivered": 987,
      "totalPaid": 123,
      "physicalOrders": PhysicalOrders
    }
  }
}

physicalOrderCancel

Response

Returns a PhysicalOrder!

Arguments
Name Description
id - ID!

Example

Query
mutation PhysicalOrderCancel($id: ID!) {
  physicalOrderCancel(id: $id) {
    id
    ref
    createdAt
    recipient {
      id
      org {
        ...OrgFragment
      }
      email
      name
      salesForceContactId
      salesForceAccountId
      hubSpotContactId
      hubSpotCompanyId
      orgName
    }
    isAddressConfirmed
    addressConfirmedDate
    markPurchased
    markPrinted
    recipientSubmitsAddress
    creatorName
    creatorEmail
    orgName
    orgBranding {
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
    }
    vendorName
    message
    physicalNote
    invoiceItems {
      id
      createdAt
      amount
      description
    }
    batchId
    mailingAddress {
      address1
      address2
      city
      company
      country
      countryCodeV2
      firstName
      lastName
      id
      phone
      province
      provinceCode
      zip
    }
    purchaseUrl
    description
    shopifyOrderId
    shopifyOrderName
    gifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    sendAll
    campaign {
      id
      ref
      createdAt
      name
      gifts {
        ...PhysicalGiftFragment
      }
      variants
      messageTemplate
      physicalNoteTemplate
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    vendorOrderId
    costToRevSend
    fulfillmentEvents {
      happenedAt
      id
      message
      status
    }
    images {
      altText
      height
      id
      url
      width
    }
    giftChoices {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    selectedGifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    hideContents
    isThirdParty
    shipsThroughWarehouse
    cancelledAt
    needsToSelectGift
    includeHandwritten
    fontStyle
    expiresAt
    isExpired
  }
}
Variables
{"id": 4}
Response
{
  "data": {
    "physicalOrderCancel": {
      "id": "4",
      "ref": "abc123",
      "createdAt": "2007-12-03T10:15:30Z",
      "recipient": Recipient,
      "isAddressConfirmed": false,
      "addressConfirmedDate": "2007-12-03T10:15:30Z",
      "markPurchased": "2007-12-03T10:15:30Z",
      "markPrinted": "2007-12-03T10:15:30Z",
      "recipientSubmitsAddress": false,
      "creatorName": "abc123",
      "creatorEmail": "abc123",
      "orgName": "abc123",
      "orgBranding": OrgBranding,
      "vendorName": "abc123",
      "message": "xyz789",
      "physicalNote": "abc123",
      "invoiceItems": [InvoiceItem],
      "batchId": "xyz789",
      "mailingAddress": MailingAddress,
      "purchaseUrl": "xyz789",
      "description": "abc123",
      "shopifyOrderId": "abc123",
      "shopifyOrderName": "abc123",
      "gifts": [PhysicalGift],
      "sendAll": true,
      "campaign": PhysicalCampaign,
      "vendorOrderId": "abc123",
      "costToRevSend": 123,
      "fulfillmentEvents": [FulfillmentEvent],
      "images": [Image],
      "giftChoices": [PhysicalGift],
      "selectedGifts": [PhysicalGift],
      "hideContents": true,
      "isThirdParty": true,
      "shipsThroughWarehouse": false,
      "cancelledAt": "2007-12-03T10:15:30Z",
      "needsToSelectGift": false,
      "includeHandwritten": false,
      "fontStyle": "CLEAN",
      "expiresAt": "2007-12-03T10:15:30Z",
      "isExpired": true
    }
  }
}

physicalOrderComplete

Response

Returns a PhysicalOrder!

Arguments
Name Description
id - ID!
deliveredAt - DateTime

Example

Query
mutation PhysicalOrderComplete(
  $id: ID!,
  $deliveredAt: DateTime
) {
  physicalOrderComplete(
    id: $id,
    deliveredAt: $deliveredAt
  ) {
    id
    ref
    createdAt
    recipient {
      id
      org {
        ...OrgFragment
      }
      email
      name
      salesForceContactId
      salesForceAccountId
      hubSpotContactId
      hubSpotCompanyId
      orgName
    }
    isAddressConfirmed
    addressConfirmedDate
    markPurchased
    markPrinted
    recipientSubmitsAddress
    creatorName
    creatorEmail
    orgName
    orgBranding {
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
    }
    vendorName
    message
    physicalNote
    invoiceItems {
      id
      createdAt
      amount
      description
    }
    batchId
    mailingAddress {
      address1
      address2
      city
      company
      country
      countryCodeV2
      firstName
      lastName
      id
      phone
      province
      provinceCode
      zip
    }
    purchaseUrl
    description
    shopifyOrderId
    shopifyOrderName
    gifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    sendAll
    campaign {
      id
      ref
      createdAt
      name
      gifts {
        ...PhysicalGiftFragment
      }
      variants
      messageTemplate
      physicalNoteTemplate
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    vendorOrderId
    costToRevSend
    fulfillmentEvents {
      happenedAt
      id
      message
      status
    }
    images {
      altText
      height
      id
      url
      width
    }
    giftChoices {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    selectedGifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    hideContents
    isThirdParty
    shipsThroughWarehouse
    cancelledAt
    needsToSelectGift
    includeHandwritten
    fontStyle
    expiresAt
    isExpired
  }
}
Variables
{
  "id": "4",
  "deliveredAt": "2007-12-03T10:15:30Z"
}
Response
{
  "data": {
    "physicalOrderComplete": {
      "id": 4,
      "ref": "abc123",
      "createdAt": "2007-12-03T10:15:30Z",
      "recipient": Recipient,
      "isAddressConfirmed": false,
      "addressConfirmedDate": "2007-12-03T10:15:30Z",
      "markPurchased": "2007-12-03T10:15:30Z",
      "markPrinted": "2007-12-03T10:15:30Z",
      "recipientSubmitsAddress": true,
      "creatorName": "xyz789",
      "creatorEmail": "xyz789",
      "orgName": "abc123",
      "orgBranding": OrgBranding,
      "vendorName": "abc123",
      "message": "xyz789",
      "physicalNote": "abc123",
      "invoiceItems": [InvoiceItem],
      "batchId": "abc123",
      "mailingAddress": MailingAddress,
      "purchaseUrl": "xyz789",
      "description": "abc123",
      "shopifyOrderId": "xyz789",
      "shopifyOrderName": "abc123",
      "gifts": [PhysicalGift],
      "sendAll": false,
      "campaign": PhysicalCampaign,
      "vendorOrderId": "xyz789",
      "costToRevSend": 987,
      "fulfillmentEvents": [FulfillmentEvent],
      "images": [Image],
      "giftChoices": [PhysicalGift],
      "selectedGifts": [PhysicalGift],
      "hideContents": false,
      "isThirdParty": true,
      "shipsThroughWarehouse": false,
      "cancelledAt": "2007-12-03T10:15:30Z",
      "needsToSelectGift": true,
      "includeHandwritten": false,
      "fontStyle": "CLEAN",
      "expiresAt": "2007-12-03T10:15:30Z",
      "isExpired": false
    }
  }
}

physicalOrderConfirm

Response

Returns a PhysicalOrder!

Arguments
Name Description
input - PhysicalOrderInput!
id - ID!

Example

Query
mutation PhysicalOrderConfirm(
  $input: PhysicalOrderInput!,
  $id: ID!
) {
  physicalOrderConfirm(
    input: $input,
    id: $id
  ) {
    id
    ref
    createdAt
    recipient {
      id
      org {
        ...OrgFragment
      }
      email
      name
      salesForceContactId
      salesForceAccountId
      hubSpotContactId
      hubSpotCompanyId
      orgName
    }
    isAddressConfirmed
    addressConfirmedDate
    markPurchased
    markPrinted
    recipientSubmitsAddress
    creatorName
    creatorEmail
    orgName
    orgBranding {
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
    }
    vendorName
    message
    physicalNote
    invoiceItems {
      id
      createdAt
      amount
      description
    }
    batchId
    mailingAddress {
      address1
      address2
      city
      company
      country
      countryCodeV2
      firstName
      lastName
      id
      phone
      province
      provinceCode
      zip
    }
    purchaseUrl
    description
    shopifyOrderId
    shopifyOrderName
    gifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    sendAll
    campaign {
      id
      ref
      createdAt
      name
      gifts {
        ...PhysicalGiftFragment
      }
      variants
      messageTemplate
      physicalNoteTemplate
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    vendorOrderId
    costToRevSend
    fulfillmentEvents {
      happenedAt
      id
      message
      status
    }
    images {
      altText
      height
      id
      url
      width
    }
    giftChoices {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    selectedGifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    hideContents
    isThirdParty
    shipsThroughWarehouse
    cancelledAt
    needsToSelectGift
    includeHandwritten
    fontStyle
    expiresAt
    isExpired
  }
}
Variables
{"input": PhysicalOrderInput, "id": 4}
Response
{
  "data": {
    "physicalOrderConfirm": {
      "id": 4,
      "ref": "abc123",
      "createdAt": "2007-12-03T10:15:30Z",
      "recipient": Recipient,
      "isAddressConfirmed": true,
      "addressConfirmedDate": "2007-12-03T10:15:30Z",
      "markPurchased": "2007-12-03T10:15:30Z",
      "markPrinted": "2007-12-03T10:15:30Z",
      "recipientSubmitsAddress": false,
      "creatorName": "abc123",
      "creatorEmail": "abc123",
      "orgName": "abc123",
      "orgBranding": OrgBranding,
      "vendorName": "xyz789",
      "message": "xyz789",
      "physicalNote": "abc123",
      "invoiceItems": [InvoiceItem],
      "batchId": "abc123",
      "mailingAddress": MailingAddress,
      "purchaseUrl": "abc123",
      "description": "abc123",
      "shopifyOrderId": "abc123",
      "shopifyOrderName": "xyz789",
      "gifts": [PhysicalGift],
      "sendAll": true,
      "campaign": PhysicalCampaign,
      "vendorOrderId": "xyz789",
      "costToRevSend": 987,
      "fulfillmentEvents": [FulfillmentEvent],
      "images": [Image],
      "giftChoices": [PhysicalGift],
      "selectedGifts": [PhysicalGift],
      "hideContents": true,
      "isThirdParty": false,
      "shipsThroughWarehouse": false,
      "cancelledAt": "2007-12-03T10:15:30Z",
      "needsToSelectGift": false,
      "includeHandwritten": false,
      "fontStyle": "CLEAN",
      "expiresAt": "2007-12-03T10:15:30Z",
      "isExpired": true
    }
  }
}

physicalOrderCreate

Response

Returns a PhysicalOrder!

Arguments
Name Description
input - PhysicalOrderInput!

Example

Query
mutation PhysicalOrderCreate($input: PhysicalOrderInput!) {
  physicalOrderCreate(input: $input) {
    id
    ref
    createdAt
    recipient {
      id
      org {
        ...OrgFragment
      }
      email
      name
      salesForceContactId
      salesForceAccountId
      hubSpotContactId
      hubSpotCompanyId
      orgName
    }
    isAddressConfirmed
    addressConfirmedDate
    markPurchased
    markPrinted
    recipientSubmitsAddress
    creatorName
    creatorEmail
    orgName
    orgBranding {
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
    }
    vendorName
    message
    physicalNote
    invoiceItems {
      id
      createdAt
      amount
      description
    }
    batchId
    mailingAddress {
      address1
      address2
      city
      company
      country
      countryCodeV2
      firstName
      lastName
      id
      phone
      province
      provinceCode
      zip
    }
    purchaseUrl
    description
    shopifyOrderId
    shopifyOrderName
    gifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    sendAll
    campaign {
      id
      ref
      createdAt
      name
      gifts {
        ...PhysicalGiftFragment
      }
      variants
      messageTemplate
      physicalNoteTemplate
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    vendorOrderId
    costToRevSend
    fulfillmentEvents {
      happenedAt
      id
      message
      status
    }
    images {
      altText
      height
      id
      url
      width
    }
    giftChoices {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    selectedGifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    hideContents
    isThirdParty
    shipsThroughWarehouse
    cancelledAt
    needsToSelectGift
    includeHandwritten
    fontStyle
    expiresAt
    isExpired
  }
}
Variables
{"input": PhysicalOrderInput}
Response
{
  "data": {
    "physicalOrderCreate": {
      "id": "4",
      "ref": "xyz789",
      "createdAt": "2007-12-03T10:15:30Z",
      "recipient": Recipient,
      "isAddressConfirmed": true,
      "addressConfirmedDate": "2007-12-03T10:15:30Z",
      "markPurchased": "2007-12-03T10:15:30Z",
      "markPrinted": "2007-12-03T10:15:30Z",
      "recipientSubmitsAddress": false,
      "creatorName": "xyz789",
      "creatorEmail": "abc123",
      "orgName": "xyz789",
      "orgBranding": OrgBranding,
      "vendorName": "xyz789",
      "message": "abc123",
      "physicalNote": "abc123",
      "invoiceItems": [InvoiceItem],
      "batchId": "abc123",
      "mailingAddress": MailingAddress,
      "purchaseUrl": "abc123",
      "description": "xyz789",
      "shopifyOrderId": "abc123",
      "shopifyOrderName": "abc123",
      "gifts": [PhysicalGift],
      "sendAll": true,
      "campaign": PhysicalCampaign,
      "vendorOrderId": "abc123",
      "costToRevSend": 987,
      "fulfillmentEvents": [FulfillmentEvent],
      "images": [Image],
      "giftChoices": [PhysicalGift],
      "selectedGifts": [PhysicalGift],
      "hideContents": true,
      "isThirdParty": false,
      "shipsThroughWarehouse": false,
      "cancelledAt": "2007-12-03T10:15:30Z",
      "needsToSelectGift": true,
      "includeHandwritten": true,
      "fontStyle": "CLEAN",
      "expiresAt": "2007-12-03T10:15:30Z",
      "isExpired": true
    }
  }
}

physicalOrderCreateWithImport

Description

Import a product from an external source and immediately create a physical order to send it. This combines productImport and physicalOrderCreate into a single call.

Response

Returns a PhysicalOrder!

Arguments
Name Description
input - PhysicalOrderWithImportInput!

Example

Query
mutation PhysicalOrderCreateWithImport($input: PhysicalOrderWithImportInput!) {
  physicalOrderCreateWithImport(input: $input) {
    id
    ref
    createdAt
    recipient {
      id
      org {
        ...OrgFragment
      }
      email
      name
      salesForceContactId
      salesForceAccountId
      hubSpotContactId
      hubSpotCompanyId
      orgName
    }
    isAddressConfirmed
    addressConfirmedDate
    markPurchased
    markPrinted
    recipientSubmitsAddress
    creatorName
    creatorEmail
    orgName
    orgBranding {
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
    }
    vendorName
    message
    physicalNote
    invoiceItems {
      id
      createdAt
      amount
      description
    }
    batchId
    mailingAddress {
      address1
      address2
      city
      company
      country
      countryCodeV2
      firstName
      lastName
      id
      phone
      province
      provinceCode
      zip
    }
    purchaseUrl
    description
    shopifyOrderId
    shopifyOrderName
    gifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    sendAll
    campaign {
      id
      ref
      createdAt
      name
      gifts {
        ...PhysicalGiftFragment
      }
      variants
      messageTemplate
      physicalNoteTemplate
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    vendorOrderId
    costToRevSend
    fulfillmentEvents {
      happenedAt
      id
      message
      status
    }
    images {
      altText
      height
      id
      url
      width
    }
    giftChoices {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    selectedGifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    hideContents
    isThirdParty
    shipsThroughWarehouse
    cancelledAt
    needsToSelectGift
    includeHandwritten
    fontStyle
    expiresAt
    isExpired
  }
}
Variables
{"input": PhysicalOrderWithImportInput}
Response
{
  "data": {
    "physicalOrderCreateWithImport": {
      "id": 4,
      "ref": "abc123",
      "createdAt": "2007-12-03T10:15:30Z",
      "recipient": Recipient,
      "isAddressConfirmed": false,
      "addressConfirmedDate": "2007-12-03T10:15:30Z",
      "markPurchased": "2007-12-03T10:15:30Z",
      "markPrinted": "2007-12-03T10:15:30Z",
      "recipientSubmitsAddress": false,
      "creatorName": "abc123",
      "creatorEmail": "xyz789",
      "orgName": "abc123",
      "orgBranding": OrgBranding,
      "vendorName": "abc123",
      "message": "abc123",
      "physicalNote": "xyz789",
      "invoiceItems": [InvoiceItem],
      "batchId": "xyz789",
      "mailingAddress": MailingAddress,
      "purchaseUrl": "xyz789",
      "description": "abc123",
      "shopifyOrderId": "abc123",
      "shopifyOrderName": "abc123",
      "gifts": [PhysicalGift],
      "sendAll": true,
      "campaign": PhysicalCampaign,
      "vendorOrderId": "abc123",
      "costToRevSend": 123,
      "fulfillmentEvents": [FulfillmentEvent],
      "images": [Image],
      "giftChoices": [PhysicalGift],
      "selectedGifts": [PhysicalGift],
      "hideContents": true,
      "isThirdParty": true,
      "shipsThroughWarehouse": false,
      "cancelledAt": "2007-12-03T10:15:30Z",
      "needsToSelectGift": false,
      "includeHandwritten": true,
      "fontStyle": "CLEAN",
      "expiresAt": "2007-12-03T10:15:30Z",
      "isExpired": true
    }
  }
}

physicalOrderHandWritingSample

Response

Returns a HandWritingSampleOutput

Arguments
Name Description
text - String!

Example

Query
mutation PhysicalOrderHandWritingSample($text: String!) {
  physicalOrderHandWritingSample(text: $text) {
    outputText
  }
}
Variables
{"text": "xyz789"}
Response
{
  "data": {
    "physicalOrderHandWritingSample": {
      "outputText": "abc123"
    }
  }
}

physicalOrderMarkPrinted

Response

Returns a Boolean!

Arguments
Name Description
ids - [ID!]!

Example

Query
mutation PhysicalOrderMarkPrinted($ids: [ID!]!) {
  physicalOrderMarkPrinted(ids: $ids)
}
Variables
{"ids": ["4"]}
Response
{"data": {"physicalOrderMarkPrinted": true}}

physicalOrderMarkPurchased

Response

Returns a PhysicalOrder!

Arguments
Name Description
id - ID!
vendorOrderId - String!
actualCost - Int!

Example

Query
mutation PhysicalOrderMarkPurchased(
  $id: ID!,
  $vendorOrderId: String!,
  $actualCost: Int!
) {
  physicalOrderMarkPurchased(
    id: $id,
    vendorOrderId: $vendorOrderId,
    actualCost: $actualCost
  ) {
    id
    ref
    createdAt
    recipient {
      id
      org {
        ...OrgFragment
      }
      email
      name
      salesForceContactId
      salesForceAccountId
      hubSpotContactId
      hubSpotCompanyId
      orgName
    }
    isAddressConfirmed
    addressConfirmedDate
    markPurchased
    markPrinted
    recipientSubmitsAddress
    creatorName
    creatorEmail
    orgName
    orgBranding {
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
    }
    vendorName
    message
    physicalNote
    invoiceItems {
      id
      createdAt
      amount
      description
    }
    batchId
    mailingAddress {
      address1
      address2
      city
      company
      country
      countryCodeV2
      firstName
      lastName
      id
      phone
      province
      provinceCode
      zip
    }
    purchaseUrl
    description
    shopifyOrderId
    shopifyOrderName
    gifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    sendAll
    campaign {
      id
      ref
      createdAt
      name
      gifts {
        ...PhysicalGiftFragment
      }
      variants
      messageTemplate
      physicalNoteTemplate
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    vendorOrderId
    costToRevSend
    fulfillmentEvents {
      happenedAt
      id
      message
      status
    }
    images {
      altText
      height
      id
      url
      width
    }
    giftChoices {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    selectedGifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    hideContents
    isThirdParty
    shipsThroughWarehouse
    cancelledAt
    needsToSelectGift
    includeHandwritten
    fontStyle
    expiresAt
    isExpired
  }
}
Variables
{
  "id": "4",
  "vendorOrderId": "xyz789",
  "actualCost": 123
}
Response
{
  "data": {
    "physicalOrderMarkPurchased": {
      "id": "4",
      "ref": "xyz789",
      "createdAt": "2007-12-03T10:15:30Z",
      "recipient": Recipient,
      "isAddressConfirmed": false,
      "addressConfirmedDate": "2007-12-03T10:15:30Z",
      "markPurchased": "2007-12-03T10:15:30Z",
      "markPrinted": "2007-12-03T10:15:30Z",
      "recipientSubmitsAddress": true,
      "creatorName": "abc123",
      "creatorEmail": "abc123",
      "orgName": "xyz789",
      "orgBranding": OrgBranding,
      "vendorName": "abc123",
      "message": "xyz789",
      "physicalNote": "abc123",
      "invoiceItems": [InvoiceItem],
      "batchId": "abc123",
      "mailingAddress": MailingAddress,
      "purchaseUrl": "xyz789",
      "description": "abc123",
      "shopifyOrderId": "abc123",
      "shopifyOrderName": "abc123",
      "gifts": [PhysicalGift],
      "sendAll": false,
      "campaign": PhysicalCampaign,
      "vendorOrderId": "xyz789",
      "costToRevSend": 987,
      "fulfillmentEvents": [FulfillmentEvent],
      "images": [Image],
      "giftChoices": [PhysicalGift],
      "selectedGifts": [PhysicalGift],
      "hideContents": true,
      "isThirdParty": false,
      "shipsThroughWarehouse": false,
      "cancelledAt": "2007-12-03T10:15:30Z",
      "needsToSelectGift": false,
      "includeHandwritten": true,
      "fontStyle": "CLEAN",
      "expiresAt": "2007-12-03T10:15:30Z",
      "isExpired": true
    }
  }
}

physicalOrderSendEnvelopeToPrinter

Response

Returns a Boolean!

Arguments
Name Description
ids - [ID!]!

Example

Query
mutation PhysicalOrderSendEnvelopeToPrinter($ids: [ID!]!) {
  physicalOrderSendEnvelopeToPrinter(ids: $ids)
}
Variables
{"ids": [4]}
Response
{"data": {"physicalOrderSendEnvelopeToPrinter": true}}

physicalOrderSendToPrinter

Response

Returns a Boolean!

Arguments
Name Description
ids - [ID!]!

Example

Query
mutation PhysicalOrderSendToPrinter($ids: [ID!]!) {
  physicalOrderSendToPrinter(ids: $ids)
}
Variables
{"ids": [4]}
Response
{"data": {"physicalOrderSendToPrinter": true}}

physicalOrderUpdate

Response

Returns a PhysicalOrder!

Arguments
Name Description
input - PhysicalOrderInput!
id - ID!

Example

Query
mutation PhysicalOrderUpdate(
  $input: PhysicalOrderInput!,
  $id: ID!
) {
  physicalOrderUpdate(
    input: $input,
    id: $id
  ) {
    id
    ref
    createdAt
    recipient {
      id
      org {
        ...OrgFragment
      }
      email
      name
      salesForceContactId
      salesForceAccountId
      hubSpotContactId
      hubSpotCompanyId
      orgName
    }
    isAddressConfirmed
    addressConfirmedDate
    markPurchased
    markPrinted
    recipientSubmitsAddress
    creatorName
    creatorEmail
    orgName
    orgBranding {
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
    }
    vendorName
    message
    physicalNote
    invoiceItems {
      id
      createdAt
      amount
      description
    }
    batchId
    mailingAddress {
      address1
      address2
      city
      company
      country
      countryCodeV2
      firstName
      lastName
      id
      phone
      province
      provinceCode
      zip
    }
    purchaseUrl
    description
    shopifyOrderId
    shopifyOrderName
    gifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    sendAll
    campaign {
      id
      ref
      createdAt
      name
      gifts {
        ...PhysicalGiftFragment
      }
      variants
      messageTemplate
      physicalNoteTemplate
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    vendorOrderId
    costToRevSend
    fulfillmentEvents {
      happenedAt
      id
      message
      status
    }
    images {
      altText
      height
      id
      url
      width
    }
    giftChoices {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    selectedGifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    hideContents
    isThirdParty
    shipsThroughWarehouse
    cancelledAt
    needsToSelectGift
    includeHandwritten
    fontStyle
    expiresAt
    isExpired
  }
}
Variables
{"input": PhysicalOrderInput, "id": 4}
Response
{
  "data": {
    "physicalOrderUpdate": {
      "id": 4,
      "ref": "xyz789",
      "createdAt": "2007-12-03T10:15:30Z",
      "recipient": Recipient,
      "isAddressConfirmed": false,
      "addressConfirmedDate": "2007-12-03T10:15:30Z",
      "markPurchased": "2007-12-03T10:15:30Z",
      "markPrinted": "2007-12-03T10:15:30Z",
      "recipientSubmitsAddress": true,
      "creatorName": "xyz789",
      "creatorEmail": "abc123",
      "orgName": "xyz789",
      "orgBranding": OrgBranding,
      "vendorName": "xyz789",
      "message": "xyz789",
      "physicalNote": "abc123",
      "invoiceItems": [InvoiceItem],
      "batchId": "xyz789",
      "mailingAddress": MailingAddress,
      "purchaseUrl": "xyz789",
      "description": "abc123",
      "shopifyOrderId": "xyz789",
      "shopifyOrderName": "abc123",
      "gifts": [PhysicalGift],
      "sendAll": false,
      "campaign": PhysicalCampaign,
      "vendorOrderId": "abc123",
      "costToRevSend": 987,
      "fulfillmentEvents": [FulfillmentEvent],
      "images": [Image],
      "giftChoices": [PhysicalGift],
      "selectedGifts": [PhysicalGift],
      "hideContents": true,
      "isThirdParty": true,
      "shipsThroughWarehouse": false,
      "cancelledAt": "2007-12-03T10:15:30Z",
      "needsToSelectGift": true,
      "includeHandwritten": false,
      "fontStyle": "CLEAN",
      "expiresAt": "2007-12-03T10:15:30Z",
      "isExpired": false
    }
  }
}

physicalOrderUpdateCostToRevSend

Response

Returns a PhysicalOrder!

Arguments
Name Description
id - ID!
costToRevSend - Int!

Example

Query
mutation PhysicalOrderUpdateCostToRevSend(
  $id: ID!,
  $costToRevSend: Int!
) {
  physicalOrderUpdateCostToRevSend(
    id: $id,
    costToRevSend: $costToRevSend
  ) {
    id
    ref
    createdAt
    recipient {
      id
      org {
        ...OrgFragment
      }
      email
      name
      salesForceContactId
      salesForceAccountId
      hubSpotContactId
      hubSpotCompanyId
      orgName
    }
    isAddressConfirmed
    addressConfirmedDate
    markPurchased
    markPrinted
    recipientSubmitsAddress
    creatorName
    creatorEmail
    orgName
    orgBranding {
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
    }
    vendorName
    message
    physicalNote
    invoiceItems {
      id
      createdAt
      amount
      description
    }
    batchId
    mailingAddress {
      address1
      address2
      city
      company
      country
      countryCodeV2
      firstName
      lastName
      id
      phone
      province
      provinceCode
      zip
    }
    purchaseUrl
    description
    shopifyOrderId
    shopifyOrderName
    gifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    sendAll
    campaign {
      id
      ref
      createdAt
      name
      gifts {
        ...PhysicalGiftFragment
      }
      variants
      messageTemplate
      physicalNoteTemplate
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    vendorOrderId
    costToRevSend
    fulfillmentEvents {
      happenedAt
      id
      message
      status
    }
    images {
      altText
      height
      id
      url
      width
    }
    giftChoices {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    selectedGifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    hideContents
    isThirdParty
    shipsThroughWarehouse
    cancelledAt
    needsToSelectGift
    includeHandwritten
    fontStyle
    expiresAt
    isExpired
  }
}
Variables
{"id": "4", "costToRevSend": 987}
Response
{
  "data": {
    "physicalOrderUpdateCostToRevSend": {
      "id": "4",
      "ref": "xyz789",
      "createdAt": "2007-12-03T10:15:30Z",
      "recipient": Recipient,
      "isAddressConfirmed": true,
      "addressConfirmedDate": "2007-12-03T10:15:30Z",
      "markPurchased": "2007-12-03T10:15:30Z",
      "markPrinted": "2007-12-03T10:15:30Z",
      "recipientSubmitsAddress": false,
      "creatorName": "abc123",
      "creatorEmail": "abc123",
      "orgName": "abc123",
      "orgBranding": OrgBranding,
      "vendorName": "abc123",
      "message": "abc123",
      "physicalNote": "abc123",
      "invoiceItems": [InvoiceItem],
      "batchId": "xyz789",
      "mailingAddress": MailingAddress,
      "purchaseUrl": "xyz789",
      "description": "xyz789",
      "shopifyOrderId": "xyz789",
      "shopifyOrderName": "xyz789",
      "gifts": [PhysicalGift],
      "sendAll": true,
      "campaign": PhysicalCampaign,
      "vendorOrderId": "abc123",
      "costToRevSend": 987,
      "fulfillmentEvents": [FulfillmentEvent],
      "images": [Image],
      "giftChoices": [PhysicalGift],
      "selectedGifts": [PhysicalGift],
      "hideContents": false,
      "isThirdParty": true,
      "shipsThroughWarehouse": true,
      "cancelledAt": "2007-12-03T10:15:30Z",
      "needsToSelectGift": true,
      "includeHandwritten": true,
      "fontStyle": "CLEAN",
      "expiresAt": "2007-12-03T10:15:30Z",
      "isExpired": false
    }
  }
}

physicalOrderUpdateMailingAddress

Response

Returns a PhysicalOrder!

Arguments
Name Description
input - MailingAddressInput!
id - ID!

Example

Query
mutation PhysicalOrderUpdateMailingAddress(
  $input: MailingAddressInput!,
  $id: ID!
) {
  physicalOrderUpdateMailingAddress(
    input: $input,
    id: $id
  ) {
    id
    ref
    createdAt
    recipient {
      id
      org {
        ...OrgFragment
      }
      email
      name
      salesForceContactId
      salesForceAccountId
      hubSpotContactId
      hubSpotCompanyId
      orgName
    }
    isAddressConfirmed
    addressConfirmedDate
    markPurchased
    markPrinted
    recipientSubmitsAddress
    creatorName
    creatorEmail
    orgName
    orgBranding {
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
    }
    vendorName
    message
    physicalNote
    invoiceItems {
      id
      createdAt
      amount
      description
    }
    batchId
    mailingAddress {
      address1
      address2
      city
      company
      country
      countryCodeV2
      firstName
      lastName
      id
      phone
      province
      provinceCode
      zip
    }
    purchaseUrl
    description
    shopifyOrderId
    shopifyOrderName
    gifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    sendAll
    campaign {
      id
      ref
      createdAt
      name
      gifts {
        ...PhysicalGiftFragment
      }
      variants
      messageTemplate
      physicalNoteTemplate
      team {
        ...TeamFragment
      }
      private
      isRevSendCurated
      brandTemplateId
    }
    vendorOrderId
    costToRevSend
    fulfillmentEvents {
      happenedAt
      id
      message
      status
    }
    images {
      altText
      height
      id
      url
      width
    }
    giftChoices {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    selectedGifts {
      id
      title
      messageMaxLength
      messageMaxLines
      descriptionHtml
      featuredImageSrc
      initialShippingCost
      products {
        ...ProductFragment
      }
      productVariants {
        ...ProductVariantFragment
      }
      isDisabled
      categories
      occasions
      isThirdParty
      shipsThroughWarehouse
      isDropshipped
      isAddOn
      hideInPreview
      purchaseUrl
      vendor {
        ...PhysicalVendorFragment
      }
      orgId
      requiresPhone
      isFavorite
      selectedVariant {
        ...ProductVariantFragment
      }
      optionId
      meta
    }
    hideContents
    isThirdParty
    shipsThroughWarehouse
    cancelledAt
    needsToSelectGift
    includeHandwritten
    fontStyle
    expiresAt
    isExpired
  }
}
Variables
{"input": MailingAddressInput, "id": 4}
Response
{
  "data": {
    "physicalOrderUpdateMailingAddress": {
      "id": "4",
      "ref": "xyz789",
      "createdAt": "2007-12-03T10:15:30Z",
      "recipient": Recipient,
      "isAddressConfirmed": true,
      "addressConfirmedDate": "2007-12-03T10:15:30Z",
      "markPurchased": "2007-12-03T10:15:30Z",
      "markPrinted": "2007-12-03T10:15:30Z",
      "recipientSubmitsAddress": true,
      "creatorName": "abc123",
      "creatorEmail": "abc123",
      "orgName": "xyz789",
      "orgBranding": OrgBranding,
      "vendorName": "abc123",
      "message": "abc123",
      "physicalNote": "xyz789",
      "invoiceItems": [InvoiceItem],
      "batchId": "abc123",
      "mailingAddress": MailingAddress,
      "purchaseUrl": "abc123",
      "description": "abc123",
      "shopifyOrderId": "xyz789",
      "shopifyOrderName": "abc123",
      "gifts": [PhysicalGift],
      "sendAll": false,
      "campaign": PhysicalCampaign,
      "vendorOrderId": "xyz789",
      "costToRevSend": 987,
      "fulfillmentEvents": [FulfillmentEvent],
      "images": [Image],
      "giftChoices": [PhysicalGift],
      "selectedGifts": [PhysicalGift],
      "hideContents": true,
      "isThirdParty": false,
      "shipsThroughWarehouse": false,
      "cancelledAt": "2007-12-03T10:15:30Z",
      "needsToSelectGift": false,
      "includeHandwritten": true,
      "fontStyle": "CLEAN",
      "expiresAt": "2007-12-03T10:15:30Z",
      "isExpired": true
    }
  }
}

productCreate

Description

Creates a product.

If you need to create a product with many variants that are active at several locations, especially with a lot of collections and tags, then you should first create the product with just the variants.

After the product is created, you can activate the variants at locations and add the other related objects to the product. This reduces the size of each mutation and increases the likelihood that it will complete before the operation times out.

The following example shows how you might break up product creation and object association into multiple steps:

  1. Create the product with variants. Don't specify any tags or collections on the product, and don't specify inventory quantities for each variant.

  2. After the product is created, add tags to the product using the tagsAdd mutation, and add collections using the collectionsAddProducts mutation.

  3. Use the inventoryBulkToggleActivation mutation on each inventory item to activate it at the appropriate locations.

  4. After activating the variants at the locations, adjust inventory quantities at each location using the inventoryBulkAdjustQuantityAtLocation mutation.

Response

Returns a ProductCreatePayload

Arguments
Name Description
input - ProductInput! The properties of the new product.
media - [CreateMediaInput!] List of new media to be added to the product.

Example

Query
mutation ProductCreate(
  $input: ProductInput!,
  $media: [CreateMediaInput!]
) {
  productCreate(
    input: $input,
    media: $media
  ) {
    product {
      id
      org {
        ...OrgFragment
      }
      title
      isAddon
      images {
        ...ImageFragment
      }
      variants {
        ...ProductVariantFragment
      }
      totalInventory
    }
    userErrors {
      field
      message
    }
  }
}
Variables
{
  "input": ProductInput,
  "media": [CreateMediaInput]
}
Response
{
  "data": {
    "productCreate": {
      "product": Product,
      "userErrors": [UserError]
    }
  }
}

productImport

Description

Import a product from an external source (Amazon, Target, etc.) and create a PhysicalGift. This is a unified endpoint that handles both product creation and gift setup in one call.

The Chrome extension can call this directly to import products without needing the user to navigate to the frontend.

Response

Returns a ProductImportResult!

Arguments
Name Description
input - ProductImportInput!

Example

Query
mutation ProductImport($input: ProductImportInput!) {
  productImport(input: $input) {
    giftId
    productId
    variantId
    title
    priceCents
    imageUrl
  }
}
Variables
{"input": ProductImportInput}
Response
{
  "data": {
    "productImport": {
      "giftId": 4,
      "productId": "4",
      "variantId": 4,
      "title": "xyz789",
      "priceCents": 123,
      "imageUrl": "xyz789"
    }
  }
}

resendInviteEmail

Response

Returns a Boolean

Arguments
Name Description
email - String!

Example

Query
mutation ResendInviteEmail($email: String!) {
  resendInviteEmail(email: $email)
}
Variables
{"email": "abc123"}
Response
{"data": {"resendInviteEmail": false}}

salesForceTokenCreate

Response

Returns a SalesForceToken

Arguments
Name Description
input - SalesForceTokenInput!

Example

Query
mutation SalesForceTokenCreate($input: SalesForceTokenInput!) {
  salesForceTokenCreate(input: $input) {
    id
    instanceUrl
  }
}
Variables
{"input": SalesForceTokenInput}
Response
{
  "data": {
    "salesForceTokenCreate": {
      "id": "4",
      "instanceUrl": "abc123"
    }
  }
}

salesForceTokenDelete

Response

Returns a Boolean

Example

Query
mutation SalesForceTokenDelete {
  salesForceTokenDelete
}
Response
{"data": {"salesForceTokenDelete": true}}

setDefaultPaymentMethod

Response

Returns a Boolean!

Arguments
Name Description
paymentMethodId - ID!

Example

Query
mutation SetDefaultPaymentMethod($paymentMethodId: ID!) {
  setDefaultPaymentMethod(paymentMethodId: $paymentMethodId)
}
Variables
{"paymentMethodId": "4"}
Response
{"data": {"setDefaultPaymentMethod": false}}

setupIntentCreate

Response

Returns a String!

Arguments
Name Description
teamId - ID

Example

Query
mutation SetupIntentCreate($teamId: ID) {
  setupIntentCreate(teamId: $teamId)
}
Variables
{"teamId": "4"}
Response
{"data": {"setupIntentCreate": "xyz789"}}

signUpWithGoogle

Response

Returns a String!

Arguments
Name Description
credential - String!
promoCode - String

Example

Query
mutation SignUpWithGoogle(
  $credential: String!,
  $promoCode: String
) {
  signUpWithGoogle(
    credential: $credential,
    promoCode: $promoCode
  )
}
Variables
{
  "credential": "abc123",
  "promoCode": "abc123"
}
Response
{"data": {"signUpWithGoogle": "xyz789"}}

signUpWithMicrosoft

Response

Returns a String!

Arguments
Name Description
credential - String!
promoCode - String

Example

Query
mutation SignUpWithMicrosoft(
  $credential: String!,
  $promoCode: String
) {
  signUpWithMicrosoft(
    credential: $credential,
    promoCode: $promoCode
  )
}
Variables
{
  "credential": "abc123",
  "promoCode": "abc123"
}
Response
{"data": {"signUpWithMicrosoft": "abc123"}}

signupAndCreateOrg

Response

Returns a String!

Arguments
Name Description
orgName - String!
email - String!
name - String!
price - String!
trialDays - Int!
seats - Int!
skipOnboarding - Boolean
plan - String

Example

Query
mutation SignupAndCreateOrg(
  $orgName: String!,
  $email: String!,
  $name: String!,
  $price: String!,
  $trialDays: Int!,
  $seats: Int!,
  $skipOnboarding: Boolean,
  $plan: String
) {
  signupAndCreateOrg(
    orgName: $orgName,
    email: $email,
    name: $name,
    price: $price,
    trialDays: $trialDays,
    seats: $seats,
    skipOnboarding: $skipOnboarding,
    plan: $plan
  )
}
Variables
{
  "orgName": "abc123",
  "email": "xyz789",
  "name": "abc123",
  "price": "xyz789",
  "trialDays": 987,
  "seats": 987,
  "skipOnboarding": true,
  "plan": "xyz789"
}
Response
{"data": {"signupAndCreateOrg": "abc123"}}

slackIntegrationDisconnect

Response

Returns a Boolean!

Example

Query
mutation SlackIntegrationDisconnect {
  slackIntegrationDisconnect
}
Response
{"data": {"slackIntegrationDisconnect": false}}

teamAttachCardPaymentMethod

Response

Returns a Boolean!

Arguments
Name Description
teamId - ID!
paymentMethodId - ID!

Example

Query
mutation TeamAttachCardPaymentMethod(
  $teamId: ID!,
  $paymentMethodId: ID!
) {
  teamAttachCardPaymentMethod(
    teamId: $teamId,
    paymentMethodId: $paymentMethodId
  )
}
Variables
{"teamId": "4", "paymentMethodId": 4}
Response
{"data": {"teamAttachCardPaymentMethod": true}}

teamClearDefaultPaymentMethod

Response

Returns a Boolean!

Arguments
Name Description
teamId - ID!

Example

Query
mutation TeamClearDefaultPaymentMethod($teamId: ID!) {
  teamClearDefaultPaymentMethod(teamId: $teamId)
}
Variables
{"teamId": "4"}
Response
{"data": {"teamClearDefaultPaymentMethod": true}}

teamCreate

Response

Returns a Team!

Arguments
Name Description
input - TeamCreateInput!

Example

Query
mutation TeamCreate($input: TeamCreateInput!) {
  teamCreate(input: $input) {
    id
    name
    defaultPaymentMethodId
    users {
      id
      name
      email
      role
      budget {
        ...BudgetFragment
      }
      salesForceUserId
      hubSpotUserId
      teams {
        ...UserTeamsFragment
      }
      org {
        ...OrgFragment
      }
      status
      googleEmail
      microsoftEmail
      hideOnboardingModal
      userOnboardingRole
      hubSpotToken {
        ...HubSpotTokenFragment
      }
      apiKeys {
        ...ApiKeyFragment
      }
      budgetReminderEnabled
      shippingUpdatesEnabled
      inviteCode
    }
    isAdmin
  }
}
Variables
{"input": TeamCreateInput}
Response
{
  "data": {
    "teamCreate": {
      "id": "4",
      "name": "abc123",
      "defaultPaymentMethodId": "abc123",
      "users": [User],
      "isAdmin": true
    }
  }
}

teamDetachPaymentMethod

Response

Returns a Boolean!

Arguments
Name Description
teamId - ID!
paymentMethodId - ID!

Example

Query
mutation TeamDetachPaymentMethod(
  $teamId: ID!,
  $paymentMethodId: ID!
) {
  teamDetachPaymentMethod(
    teamId: $teamId,
    paymentMethodId: $paymentMethodId
  )
}
Variables
{"teamId": 4, "paymentMethodId": "4"}
Response
{"data": {"teamDetachPaymentMethod": true}}

teamSetDefaultPaymentMethod

Response

Returns a Boolean!

Arguments
Name Description
teamId - ID!
paymentMethodId - ID!

Example

Query
mutation TeamSetDefaultPaymentMethod(
  $teamId: ID!,
  $paymentMethodId: ID!
) {
  teamSetDefaultPaymentMethod(
    teamId: $teamId,
    paymentMethodId: $paymentMethodId
  )
}
Variables
{
  "teamId": "4",
  "paymentMethodId": "4"
}
Response
{"data": {"teamSetDefaultPaymentMethod": false}}

updateUserOnboardingRole

Response

Returns a Boolean

Arguments
Name Description
role - String!

Example

Query
mutation UpdateUserOnboardingRole($role: String!) {
  updateUserOnboardingRole(role: $role)
}
Variables
{"role": "abc123"}
Response
{"data": {"updateUserOnboardingRole": false}}

userAdd

Response

Returns a User!

Arguments
Name Description
input - UserInput!

Example

Query
mutation UserAdd($input: UserInput!) {
  userAdd(input: $input) {
    id
    name
    email
    role
    budget {
      id
      amount
      isPaymentFallbackEnabled
      refillAmount
      isRollover
      alertEnabled
      alertThresholdAmount
      alertRecipientEmail
      alertLastSentAt
      alertActive
    }
    salesForceUserId
    hubSpotUserId
    teams {
      userId
      teamId
      name
      isAdmin
    }
    org {
      id
      name
      formattedName
      users {
        ...UsersFragment
      }
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
      defaultBrandTemplateId
      defaultBrandTemplate {
        ...OrgBrandTemplateFragment
      }
      brandTemplates {
        ...OrgBrandTemplateFragment
      }
      isInternational
      subscriptionPlan {
        ...SubscriptionPlanFragment
      }
      hubSpotUserInfo {
        ...HubSpotUserInfoFragment
      }
      hubSpotUsers {
        ...HubSpotUserFragment
      }
      salesForceUserInfo {
        ...SalesForceUserInfoFragment
      }
      salesForceUsers {
        ...SalesForceUserFragment
      }
      onBoardingDetails {
        ...OnBoardingDetailsFragment
      }
      teams {
        ...TeamsFragment
      }
      budgetAlertDefaultThreshold
    }
    status
    googleEmail
    microsoftEmail
    hideOnboardingModal
    userOnboardingRole
    hubSpotToken {
      user
      hubDomain
      hubId
      appId
      hubSpotUserId
    }
    apiKeys {
      id
      publicId
      name
      scopes
      trailingChars
      lastUsedAt
      expiresAt
      revokedAt
      createdAt
      updatedAt
    }
    budgetReminderEnabled
    shippingUpdatesEnabled
    inviteCode
  }
}
Variables
{"input": UserInput}
Response
{
  "data": {
    "userAdd": {
      "id": 4,
      "name": "xyz789",
      "email": "xyz789",
      "role": "ADMIN",
      "budget": Budget,
      "salesForceUserId": "abc123",
      "hubSpotUserId": "abc123",
      "teams": [UserTeams],
      "org": Org,
      "status": "ACTIVE",
      "googleEmail": "abc123",
      "microsoftEmail": "xyz789",
      "hideOnboardingModal": true,
      "userOnboardingRole": "xyz789",
      "hubSpotToken": HubSpotToken,
      "apiKeys": [ApiKey],
      "budgetReminderEnabled": true,
      "shippingUpdatesEnabled": false,
      "inviteCode": "xyz789"
    }
  }
}

userChangeTeam

Response

Returns a Team!

Arguments
Name Description
input - UserChangeTeamInput!

Example

Query
mutation UserChangeTeam($input: UserChangeTeamInput!) {
  userChangeTeam(input: $input) {
    id
    name
    defaultPaymentMethodId
    users {
      id
      name
      email
      role
      budget {
        ...BudgetFragment
      }
      salesForceUserId
      hubSpotUserId
      teams {
        ...UserTeamsFragment
      }
      org {
        ...OrgFragment
      }
      status
      googleEmail
      microsoftEmail
      hideOnboardingModal
      userOnboardingRole
      hubSpotToken {
        ...HubSpotTokenFragment
      }
      apiKeys {
        ...ApiKeyFragment
      }
      budgetReminderEnabled
      shippingUpdatesEnabled
      inviteCode
    }
    isAdmin
  }
}
Variables
{"input": UserChangeTeamInput}
Response
{
  "data": {
    "userChangeTeam": {
      "id": 4,
      "name": "abc123",
      "defaultPaymentMethodId": "xyz789",
      "users": [User],
      "isAdmin": true
    }
  }
}

userChangeTeamRole

Response

Returns a Team!

Arguments
Name Description
input - UserChangeTeamRoleInput!

Example

Query
mutation UserChangeTeamRole($input: UserChangeTeamRoleInput!) {
  userChangeTeamRole(input: $input) {
    id
    name
    defaultPaymentMethodId
    users {
      id
      name
      email
      role
      budget {
        ...BudgetFragment
      }
      salesForceUserId
      hubSpotUserId
      teams {
        ...UserTeamsFragment
      }
      org {
        ...OrgFragment
      }
      status
      googleEmail
      microsoftEmail
      hideOnboardingModal
      userOnboardingRole
      hubSpotToken {
        ...HubSpotTokenFragment
      }
      apiKeys {
        ...ApiKeyFragment
      }
      budgetReminderEnabled
      shippingUpdatesEnabled
      inviteCode
    }
    isAdmin
  }
}
Variables
{"input": UserChangeTeamRoleInput}
Response
{
  "data": {
    "userChangeTeamRole": {
      "id": "4",
      "name": "abc123",
      "defaultPaymentMethodId": "xyz789",
      "users": [User],
      "isAdmin": true
    }
  }
}

userReactivate

Response

Returns a User!

Arguments
Name Description
id - ID!

Example

Query
mutation UserReactivate($id: ID!) {
  userReactivate(id: $id) {
    id
    name
    email
    role
    budget {
      id
      amount
      isPaymentFallbackEnabled
      refillAmount
      isRollover
      alertEnabled
      alertThresholdAmount
      alertRecipientEmail
      alertLastSentAt
      alertActive
    }
    salesForceUserId
    hubSpotUserId
    teams {
      userId
      teamId
      name
      isAdmin
    }
    org {
      id
      name
      formattedName
      users {
        ...UsersFragment
      }
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
      defaultBrandTemplateId
      defaultBrandTemplate {
        ...OrgBrandTemplateFragment
      }
      brandTemplates {
        ...OrgBrandTemplateFragment
      }
      isInternational
      subscriptionPlan {
        ...SubscriptionPlanFragment
      }
      hubSpotUserInfo {
        ...HubSpotUserInfoFragment
      }
      hubSpotUsers {
        ...HubSpotUserFragment
      }
      salesForceUserInfo {
        ...SalesForceUserInfoFragment
      }
      salesForceUsers {
        ...SalesForceUserFragment
      }
      onBoardingDetails {
        ...OnBoardingDetailsFragment
      }
      teams {
        ...TeamsFragment
      }
      budgetAlertDefaultThreshold
    }
    status
    googleEmail
    microsoftEmail
    hideOnboardingModal
    userOnboardingRole
    hubSpotToken {
      user
      hubDomain
      hubId
      appId
      hubSpotUserId
    }
    apiKeys {
      id
      publicId
      name
      scopes
      trailingChars
      lastUsedAt
      expiresAt
      revokedAt
      createdAt
      updatedAt
    }
    budgetReminderEnabled
    shippingUpdatesEnabled
    inviteCode
  }
}
Variables
{"id": "4"}
Response
{
  "data": {
    "userReactivate": {
      "id": "4",
      "name": "abc123",
      "email": "xyz789",
      "role": "ADMIN",
      "budget": Budget,
      "salesForceUserId": "abc123",
      "hubSpotUserId": "xyz789",
      "teams": [UserTeams],
      "org": Org,
      "status": "ACTIVE",
      "googleEmail": "xyz789",
      "microsoftEmail": "xyz789",
      "hideOnboardingModal": false,
      "userOnboardingRole": "abc123",
      "hubSpotToken": HubSpotToken,
      "apiKeys": [ApiKey],
      "budgetReminderEnabled": true,
      "shippingUpdatesEnabled": true,
      "inviteCode": "abc123"
    }
  }
}

userRemove

Response

Returns a User!

Arguments
Name Description
id - ID!

Example

Query
mutation UserRemove($id: ID!) {
  userRemove(id: $id) {
    id
    name
    email
    role
    budget {
      id
      amount
      isPaymentFallbackEnabled
      refillAmount
      isRollover
      alertEnabled
      alertThresholdAmount
      alertRecipientEmail
      alertLastSentAt
      alertActive
    }
    salesForceUserId
    hubSpotUserId
    teams {
      userId
      teamId
      name
      isAdmin
    }
    org {
      id
      name
      formattedName
      users {
        ...UsersFragment
      }
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
      defaultBrandTemplateId
      defaultBrandTemplate {
        ...OrgBrandTemplateFragment
      }
      brandTemplates {
        ...OrgBrandTemplateFragment
      }
      isInternational
      subscriptionPlan {
        ...SubscriptionPlanFragment
      }
      hubSpotUserInfo {
        ...HubSpotUserInfoFragment
      }
      hubSpotUsers {
        ...HubSpotUserFragment
      }
      salesForceUserInfo {
        ...SalesForceUserInfoFragment
      }
      salesForceUsers {
        ...SalesForceUserFragment
      }
      onBoardingDetails {
        ...OnBoardingDetailsFragment
      }
      teams {
        ...TeamsFragment
      }
      budgetAlertDefaultThreshold
    }
    status
    googleEmail
    microsoftEmail
    hideOnboardingModal
    userOnboardingRole
    hubSpotToken {
      user
      hubDomain
      hubId
      appId
      hubSpotUserId
    }
    apiKeys {
      id
      publicId
      name
      scopes
      trailingChars
      lastUsedAt
      expiresAt
      revokedAt
      createdAt
      updatedAt
    }
    budgetReminderEnabled
    shippingUpdatesEnabled
    inviteCode
  }
}
Variables
{"id": 4}
Response
{
  "data": {
    "userRemove": {
      "id": 4,
      "name": "abc123",
      "email": "xyz789",
      "role": "ADMIN",
      "budget": Budget,
      "salesForceUserId": "xyz789",
      "hubSpotUserId": "xyz789",
      "teams": [UserTeams],
      "org": Org,
      "status": "ACTIVE",
      "googleEmail": "abc123",
      "microsoftEmail": "abc123",
      "hideOnboardingModal": false,
      "userOnboardingRole": "xyz789",
      "hubSpotToken": HubSpotToken,
      "apiKeys": [ApiKey],
      "budgetReminderEnabled": false,
      "shippingUpdatesEnabled": true,
      "inviteCode": "abc123"
    }
  }
}

userUpdate

Response

Returns a User!

Arguments
Name Description
id - ID!
input - UserInput!

Example

Query
mutation UserUpdate(
  $id: ID!,
  $input: UserInput!
) {
  userUpdate(
    id: $id,
    input: $input
  ) {
    id
    name
    email
    role
    budget {
      id
      amount
      isPaymentFallbackEnabled
      refillAmount
      isRollover
      alertEnabled
      alertThresholdAmount
      alertRecipientEmail
      alertLastSentAt
      alertActive
    }
    salesForceUserId
    hubSpotUserId
    teams {
      userId
      teamId
      name
      isAdmin
    }
    org {
      id
      name
      formattedName
      users {
        ...UsersFragment
      }
      logoUrl
      logoBackgroundColor
      logoPrimaryColor
      defaultBrandTemplateId
      defaultBrandTemplate {
        ...OrgBrandTemplateFragment
      }
      brandTemplates {
        ...OrgBrandTemplateFragment
      }
      isInternational
      subscriptionPlan {
        ...SubscriptionPlanFragment
      }
      hubSpotUserInfo {
        ...HubSpotUserInfoFragment
      }
      hubSpotUsers {
        ...HubSpotUserFragment
      }
      salesForceUserInfo {
        ...SalesForceUserInfoFragment
      }
      salesForceUsers {
        ...SalesForceUserFragment
      }
      onBoardingDetails {
        ...OnBoardingDetailsFragment
      }
      teams {
        ...TeamsFragment
      }
      budgetAlertDefaultThreshold
    }
    status
    googleEmail
    microsoftEmail
    hideOnboardingModal
    userOnboardingRole
    hubSpotToken {
      user
      hubDomain
      hubId
      appId
      hubSpotUserId
    }
    apiKeys {
      id
      publicId
      name
      scopes
      trailingChars
      lastUsedAt
      expiresAt
      revokedAt
      createdAt
      updatedAt
    }
    budgetReminderEnabled
    shippingUpdatesEnabled
    inviteCode
  }
}
Variables
{
  "id": "4",
  "input": UserInput
}
Response
{
  "data": {
    "userUpdate": {
      "id": 4,
      "name": "xyz789",
      "email": "xyz789",
      "role": "ADMIN",
      "budget": Budget,
      "salesForceUserId": "xyz789",
      "hubSpotUserId": "xyz789",
      "teams": [UserTeams],
      "org": Org,
      "status": "ACTIVE",
      "googleEmail": "xyz789",
      "microsoftEmail": "xyz789",
      "hideOnboardingModal": true,
      "userOnboardingRole": "abc123",
      "hubSpotToken": HubSpotToken,
      "apiKeys": [ApiKey],
      "budgetReminderEnabled": true,
      "shippingUpdatesEnabled": true,
      "inviteCode": "xyz789"
    }
  }
}

Types

AcceptInviteInput

Fields
Input Field Description
inviteCode - String!
Example
{"inviteCode": "abc123"}

ApiKey

Fields
Field Name Description
id - ID!
publicId - String!
name - String!
scopes - [String!]!
trailingChars - String!
lastUsedAt - DateTime
expiresAt - DateTime
revokedAt - DateTime
createdAt - DateTime
updatedAt - DateTime
Example
{
  "id": 4,
  "publicId": "xyz789",
  "name": "xyz789",
  "scopes": ["abc123"],
  "trailingChars": "abc123",
  "lastUsedAt": "2007-12-03T10:15:30Z",
  "expiresAt": "2007-12-03T10:15:30Z",
  "revokedAt": "2007-12-03T10:15:30Z",
  "createdAt": "2007-12-03T10:15:30Z",
  "updatedAt": "2007-12-03T10:15:30Z"
}

ApiKeyCreateInput

Fields
Input Field Description
name - String!
scopes - [String!]!
expiresAt - DateTime
Example
{
  "name": "abc123",
  "scopes": ["xyz789"],
  "expiresAt": "2007-12-03T10:15:30Z"
}

ApiKeySecret

Fields
Field Name Description
key - String!
apiKey - ApiKey!
Example
{
  "key": "xyz789",
  "apiKey": ApiKey
}

AssetUploadUrl

Fields
Field Name Description
url - String!
key - String!
Example
{
  "url": "xyz789",
  "key": "abc123"
}

AssetUploadUrlInput

Fields
Input Field Description
contentType - String!
Example
{"contentType": "xyz789"}

AuthenticationRedirectResponse

Fields
Field Name Description
redirectUrl - String
requiresRedirect - Boolean
token - String
Example
{
  "redirectUrl": "abc123",
  "requiresRedirect": false,
  "token": "abc123"
}

Bank

Fields
Field Name Description
id - ID!
last4 - String!
name - String!
Example
{
  "id": "4",
  "last4": "xyz789",
  "name": "abc123"
}

Boolean

Description

The Boolean scalar type represents true or false.

Budget

Fields
Field Name Description
id - ID!
amount - Float!
isPaymentFallbackEnabled - Boolean!
refillAmount - Int!
isRollover - Boolean!
alertEnabled - Boolean!
alertThresholdAmount - Int
alertRecipientEmail - String
alertLastSentAt - DateTime
alertActive - Boolean!
Example
{
  "id": 4,
  "amount": 123.45,
  "isPaymentFallbackEnabled": false,
  "refillAmount": 987,
  "isRollover": true,
  "alertEnabled": true,
  "alertThresholdAmount": 987,
  "alertRecipientEmail": "xyz789",
  "alertLastSentAt": "2007-12-03T10:15:30Z",
  "alertActive": true
}

BudgetInput

Fields
Input Field Description
isPaymentFallbackEnabled - Boolean
isRollover - Boolean
refillAmount - Int
alertEnabled - Boolean
alertThresholdAmount - Int
alertRecipientEmail - String
Example
{
  "isPaymentFallbackEnabled": false,
  "isRollover": false,
  "refillAmount": 123,
  "alertEnabled": true,
  "alertThresholdAmount": 987,
  "alertRecipientEmail": "xyz789"
}

CSVValidationError

Description

A validation error found in the CSV

Fields
Field Name Description
rowNumber - Int! The row number where the error was found (1-indexed, including header)
field - String! The field/column where the error was found
message - String! Description of the error
value - String The actual value that caused the error (if applicable)
Example
{
  "rowNumber": 123,
  "field": "xyz789",
  "message": "xyz789",
  "value": "abc123"
}

CSVValidationResult

Description

Result of CSV validation for physical orders

Fields
Field Name Description
isValid - Boolean! Whether the entire CSV is valid (no errors)
totalRows - Int! Total number of rows in the CSV (excluding header)
validRows - Int! Number of rows with valid data and addresses
errors - [CSVValidationError!]! List of validation errors found in the CSV
summary - CSVValidationSummary! Summary of validation results
Example
{
  "isValid": false,
  "totalRows": 123,
  "validRows": 123,
  "errors": [CSVValidationError],
  "summary": CSVValidationSummary
}

CSVValidationSummary

Description

Summary of CSV validation results

Fields
Field Name Description
missingFields - Int! Number of rows with missing required fields
invalidAddresses - Int! Number of rows with invalid addresses
validAddresses - Int! Number of rows with valid addresses
Example
{"missingFields": 987, "invalidAddresses": 123, "validAddresses": 987}

Campaign

Fields
Field Name Description
id - ID!
ref - String!
createdAt - DateTime!
type - CampaignType!
name - String
brands - [DigitalBrand]
gifts - [PhysicalGift]
Example
{
  "id": "4",
  "ref": "abc123",
  "createdAt": "2007-12-03T10:15:30Z",
  "type": "DIGITAL",
  "name": "abc123",
  "brands": [DigitalBrand],
  "gifts": [PhysicalGift]
}

CampaignQuery

Fields
Input Field Description
createdAtMin - DateTime
createdAtMax - DateTime
isArchived - Boolean
teamId - String
type - CampaignType
text - String
isRevSendCurated - Boolean
Example
{
  "createdAtMin": "2007-12-03T10:15:30Z",
  "createdAtMax": "2007-12-03T10:15:30Z",
  "isArchived": false,
  "teamId": "abc123",
  "type": "DIGITAL",
  "text": "xyz789",
  "isRevSendCurated": true
}

CampaignSortKey

Values
Enum Value Description

CREATED_AT_ASC

CREATED_AT_DESC

Example
"CREATED_AT_ASC"

CampaignType

Values
Enum Value Description

DIGITAL

PHYSICAL

Example
"DIGITAL"

Campaigns

Fields
Field Name Description
totalCount - Int!
nodes - [Campaign!]!
Example
{"totalCount": 987, "nodes": [Campaign]}

Card

Fields
Field Name Description
id - ID!
last4 - String!
brand - String!
Example
{
  "id": "4",
  "last4": "xyz789",
  "brand": "xyz789"
}

Category

Fields
Field Name Description
id - ID!
name - String!
icon - String!
Example
{
  "id": 4,
  "name": "abc123",
  "icon": "xyz789"
}

Charge

Fields
Field Name Description
id - ID!
amount - Int!
created - DateTime!
description - String
receiptUrl - String
Example
{
  "id": 4,
  "amount": 123,
  "created": "2007-12-03T10:15:30Z",
  "description": "abc123",
  "receiptUrl": "xyz789"
}

ChargeQuery

Fields
Input Field Description
amountMin - Int
amountMax - Int
createdAtMin - DateTime
createdAtMax - DateTime
Example
{
  "amountMin": 987,
  "amountMax": 123,
  "createdAtMin": "2007-12-03T10:15:30Z",
  "createdAtMax": "2007-12-03T10:15:30Z"
}

Charges

Fields
Field Name Description
totalCount - Int
nextPage - String
nodes - [Charge!]!
Example
{
  "totalCount": 987,
  "nextPage": "abc123",
  "nodes": [Charge]
}

CloneCuratedCampaignResult

Types
Union Types

DigitalCampaign

PhysicalCampaign

Example
DigitalCampaign

CreateMediaInput

Description

Specifies the input fields required to create a media object.

Fields
Input Field Description
originalSource - String! The original source of the media object. This might be an external URL or a staged upload URL.
alt - String The alt text associated with the media.
mediaContentType - MediaContentType! The media content type.
Example
{
  "originalSource": "abc123",
  "alt": "xyz789",
  "mediaContentType": "VIDEO"
}

Currency

Values
Enum Value Description

USD

CAD

Example
"USD"

Customer

Fields
Field Name Description
id - ID!
name - String
email - String
bank - Bank
card - Card
balance - Int
spendableBalance - Int
defaultPaymentMethodId - String
Example
{
  "id": 4,
  "name": "xyz789",
  "email": "abc123",
  "bank": Bank,
  "card": Card,
  "balance": 123,
  "spendableBalance": 987,
  "defaultPaymentMethodId": "abc123"
}

DateTime

Description

A date-time string at UTC, such as 2007-12-03T10:15:30Z, compliant with the date-time format outlined in section 5.6 of the RFC 3339 profile of the ISO 8601 standard for representation of dates and times using the Gregorian calendar.

Example
"2007-12-03T10:15:30Z"

DigitalBarcode

Description

Results of the Raise order

Fields
Field Name Description
id - ID The Raise primary key. UUID.
number - String Primary gift card number
csc - String Secondary, security number
barcodeKind - String Encoding for the raw card barcode. This is needed to render the barcode image.
barcodeValue - String The raw value for the gift card barcode: the input for barcode rendering.
viewCardUrl - String The URL for viewing the barcode
Example
{
  "id": "4",
  "number": "abc123",
  "csc": "xyz789",
  "barcodeKind": "abc123",
  "barcodeValue": "abc123",
  "viewCardUrl": "xyz789"
}

DigitalBrand

Description

Digital reward brand

Fields
Field Name Description
id - ID!
name - String!
iconUrl - String
faceplateUrl - String For displaying the card image
legalTerms - String
description - String
availableCountries - String
supportedCharities - String
redemptionDisclaimer - String
redemptionMethods - [String!]
denominations - [Int!] The possible values, in cents, that the card can be redeemed for. A null value means the possible redemption values are defined by the increment.
increment - Int The valid redemption increment, in cents. A null value means the possible redemption values are defined by the denominations.
maxValue - Int! Max redemption value of the card, in cents
minValue - Int! Min redemption value of the card, in cents
vendorId - ID! Vendor for this brand.
currency - Currency! Denominated currency for this brand
isFavorite - Boolean Is this brand a favorite of the user
Example
{
  "id": 4,
  "name": "abc123",
  "iconUrl": "xyz789",
  "faceplateUrl": "xyz789",
  "legalTerms": "xyz789",
  "description": "abc123",
  "availableCountries": "xyz789",
  "supportedCharities": "abc123",
  "redemptionDisclaimer": "xyz789",
  "redemptionMethods": ["abc123"],
  "denominations": [987],
  "increment": 123,
  "maxValue": 123,
  "minValue": 123,
  "vendorId": "4",
  "currency": "USD",
  "isFavorite": true
}

DigitalBrandQuery

Fields
Input Field Description
search - String
category - ID
occasion - ID
international - Boolean
Example
{
  "search": "abc123",
  "category": "4",
  "occasion": "4",
  "international": true
}

DigitalCampaign

Fields
Field Name Description
id - ID!
createdAt - DateTime!
ref - String!
name - String!
rewardValue - Int!
brands - [ID!]!
brandDetails - [DigitalBrand]
messageTemplate - String
headlineTemplate - String
allowCharity - Boolean!
brandsSummary - String
isArchived - Boolean!
requireEmail - Boolean
currency - Currency
team - Team
private - Boolean!
isRevSendCurated - Boolean
brandTemplateId - ID
Example
{
  "id": "4",
  "createdAt": "2007-12-03T10:15:30Z",
  "ref": "abc123",
  "name": "xyz789",
  "rewardValue": 987,
  "brands": ["4"],
  "brandDetails": [DigitalBrand],
  "messageTemplate": "xyz789",
  "headlineTemplate": "xyz789",
  "allowCharity": false,
  "brandsSummary": "xyz789",
  "isArchived": true,
  "requireEmail": false,
  "currency": "USD",
  "team": Team,
  "private": true,
  "isRevSendCurated": false,
  "brandTemplateId": 4
}

DigitalCampaignInput

Fields
Input Field Description
name - String
messageTemplate - String
headlineTemplate - String
brands - [ID!]
rewardValue - Int
currency - Currency
allowCharity - Boolean
isArchived - Boolean
team - String
private - Boolean
brandTemplateId - ID
Example
{
  "name": "abc123",
  "messageTemplate": "xyz789",
  "headlineTemplate": "xyz789",
  "brands": ["4"],
  "rewardValue": 123,
  "currency": "USD",
  "allowCharity": true,
  "isArchived": false,
  "team": "abc123",
  "private": false,
  "brandTemplateId": "4"
}

DigitalCampaignQuery

Fields
Input Field Description
creatorEmail - String
createdAtMin - DateTime
createdAtMax - DateTime
rewardValueMin - Int
rewardValueMax - Int
isArchived - Boolean
currency - Currency
Example
{
  "creatorEmail": "xyz789",
  "createdAtMin": "2007-12-03T10:15:30Z",
  "createdAtMax": "2007-12-03T10:15:30Z",
  "rewardValueMin": 123,
  "rewardValueMax": 123,
  "isArchived": false,
  "currency": "USD"
}

DigitalCampaignSortKey

Values
Enum Value Description

CREATED_AT_ASC

CREATED_AT_DESC

Example
"CREATED_AT_ASC"

DigitalCampaigns

Fields
Field Name Description
totalCount - Int!
nodes - [DigitalCampaign!]!
Example
{"totalCount": 987, "nodes": [DigitalCampaign]}

DigitalOrder

Fields
Field Name Description
id - ID!
ref - String!
createdAt - DateTime!
rewardValue - Int!
status - DigitalOrderStatus!
rewardLink - String!
recipient - Recipient!
creator - User!
campaign - DigitalCampaign
description - String
deliveryMethod - DigitalOrderDeliveryMethod!
events - [DigitalOrderEvent!]!
cancelledAt - DateTime
expiresAt - DateTime
teamId - String
Example
{
  "id": "4",
  "ref": "xyz789",
  "createdAt": "2007-12-03T10:15:30Z",
  "rewardValue": 987,
  "status": "PAYMENT_PENDING",
  "rewardLink": "abc123",
  "recipient": Recipient,
  "creator": User,
  "campaign": DigitalCampaign,
  "description": "abc123",
  "deliveryMethod": "LINK",
  "events": [DigitalOrderEvent],
  "cancelledAt": "2007-12-03T10:15:30Z",
  "expiresAt": "2007-12-03T10:15:30Z",
  "teamId": "abc123"
}

DigitalOrderBatch

Fields
Field Name Description
id - ID!
ref - String!
creator - User!
createdAt - DateTime!
totalOrders - Int!
totalDelivered - Int!
totalPaid - Int!
digitalOrders - DigitalOrders!
Arguments
skip - Int!
take - Int!
Example
{
  "id": 4,
  "ref": "abc123",
  "creator": User,
  "createdAt": "2007-12-03T10:15:30Z",
  "totalOrders": 123,
  "totalDelivered": 123,
  "totalPaid": 987,
  "digitalOrders": DigitalOrders
}

DigitalOrderBatchQuery

Fields
Input Field Description
createdAtMin - DateTime
createdAtMax - DateTime
teamId - String
Example
{
  "createdAtMin": "2007-12-03T10:15:30Z",
  "createdAtMax": "2007-12-03T10:15:30Z",
  "teamId": "abc123"
}

DigitalOrderBatchSortKey

Values
Enum Value Description

CREATED_AT_ASC

CREATED_AT_DESC

Example
"CREATED_AT_ASC"

DigitalOrderBatches

Fields
Field Name Description
totalCount - Int!
nodes - [DigitalOrderBatch!]!
Example
{"totalCount": 123, "nodes": [DigitalOrderBatch]}

DigitalOrderBulkInput

Fields
Input Field Description
recipients - [RecipientInput!]!
campaignId - ID!
messageTemplate - String!
headlineTemplate - String
deliveryMethod - DigitalOrderDeliveryMethod
updateCrm - Boolean
Example
{
  "recipients": [RecipientInput],
  "campaignId": 4,
  "messageTemplate": "xyz789",
  "headlineTemplate": "abc123",
  "deliveryMethod": "LINK",
  "updateCrm": true
}

DigitalOrderCodeInput

Fields
Input Field Description
orderRef - ID!
brandId - ID!
email - String!
Example
{
  "orderRef": "4",
  "brandId": 4,
  "email": "xyz789"
}

DigitalOrderDeliveryMethod

Values
Enum Value Description

LINK

EMAIL

Example
"LINK"

DigitalOrderEvent

Fields
Field Name Description
id - ID!
createdAt - DateTime!
code - DigitalOrderEventCode!
Example
{
  "id": 4,
  "createdAt": "2007-12-03T10:15:30Z",
  "code": "CREATED"
}

DigitalOrderEventCode

Values
Enum Value Description

CREATED

DELIVERED

PAYMENT_SUCCEEDED

REWARD_EMAIL_FAILED

REWARD_EMAIL_SUCCEEDED

EMAIL_OPENED

REDEEMED

Example
"CREATED"

DigitalOrderInput

Fields
Input Field Description
recipient - RecipientInput!
campaignId - ID
brandId - ID
brandTemplateId - ID
currencyId - ID
rewardValue - Int
messageTemplate - String
headlineTemplate - String
deliveryMethod - DigitalOrderDeliveryMethod!
Example
{
  "recipient": RecipientInput,
  "campaignId": 4,
  "brandId": 4,
  "brandTemplateId": 4,
  "currencyId": "4",
  "rewardValue": 123,
  "messageTemplate": "abc123",
  "headlineTemplate": "abc123",
  "deliveryMethod": "LINK"
}

DigitalOrderQuery

Fields
Input Field Description
createdAtMin - DateTime
createdAtMax - DateTime
teamId - String
Example
{
  "createdAtMin": "2007-12-03T10:15:30Z",
  "createdAtMax": "2007-12-03T10:15:30Z",
  "teamId": "abc123"
}

DigitalOrderSortKey

Values
Enum Value Description

CREATED_AT_ASC

CREATED_AT_DESC

Example
"CREATED_AT_ASC"

DigitalOrderStatus

Values
Enum Value Description

PAYMENT_PENDING

PAYMENT_SUCCEEDED

REVOKED

Example
"PAYMENT_PENDING"

DigitalOrders

Fields
Field Name Description
totalCount - Int!
nodes - [DigitalOrder!]!
Example
{"totalCount": 123, "nodes": [DigitalOrder]}

DigitalReward

Fields
Field Name Description
orderRef - ID!
value - Int!
hasOrderCode - Boolean!
barcode - DigitalBarcode
messageTemplate - String!
headlineTemplate - String
orgName - String!
logoUrl - String
logoBackgroundColor - String
logoPrimaryColor - String
recipientName - String!
recipientEmail - String
recipientOrgName - String
creatorName - String
creatorEmail - String
allowsCharity - Boolean!
brands - [DigitalBrand!]!
brand - DigitalBrand
code - String
tremendousUrl - String
currency - Currency!
cancelledAt - DateTime
isExpired - Boolean
expiresAt - DateTime
Example
{
  "orderRef": "4",
  "value": 987,
  "hasOrderCode": false,
  "barcode": DigitalBarcode,
  "messageTemplate": "xyz789",
  "headlineTemplate": "xyz789",
  "orgName": "abc123",
  "logoUrl": "abc123",
  "logoBackgroundColor": "xyz789",
  "logoPrimaryColor": "xyz789",
  "recipientName": "xyz789",
  "recipientEmail": "xyz789",
  "recipientOrgName": "xyz789",
  "creatorName": "xyz789",
  "creatorEmail": "xyz789",
  "allowsCharity": false,
  "brands": [DigitalBrand],
  "brand": DigitalBrand,
  "code": "xyz789",
  "tremendousUrl": "abc123",
  "currency": "USD",
  "cancelledAt": "2007-12-03T10:15:30Z",
  "isExpired": false,
  "expiresAt": "2007-12-03T10:15:30Z"
}

DisplayableError

Description

Represents an error in the input of a mutation.

Fields
Field Name Description
field - [String!] The path to the input field that caused the error.
message - String! The error message.
Possible Types
DisplayableError Types

UserError

Example
{
  "field": ["xyz789"],
  "message": "xyz789"
}

EmailPermissionVerification

Fields
Field Name Description
hasPermission - Boolean!
message - String
Example
{
  "hasPermission": false,
  "message": "abc123"
}

EmailProviderCheck

Fields
Field Name Description
exists - Boolean!
provider - String
Example
{"exists": false, "provider": "abc123"}

ExchangeRate

Fields
Field Name Description
currency - Currency!
ratePerUsd - Float!
Example
{"currency": "USD", "ratePerUsd": 987.65}

Float

Description

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

Example
987.65

FulfillmentEvent

Description

The fulfillment event that describes the fulfilllment status at a particular time.

Fields
Field Name Description
happenedAt - DateTime! The time at which this fulfillment event happened.
id - ID! A globally-unique identifier.
message - String A message associated with this fulfillment event.
status - FulfillmentEventStatus! The status of this fulfillment event.
Example
{
  "happenedAt": "2007-12-03T10:15:30Z",
  "id": 4,
  "message": "abc123",
  "status": "LABEL_PURCHASED"
}

FulfillmentEventStatus

Description

The status that describes a fulfillment or delivery event.

Values
Enum Value Description

LABEL_PURCHASED

A shipping label has been purchased.

LABEL_PRINTED

A purchased shipping label has been printed.

READY_FOR_PICKUP

The fulfillment is ready to be picked up.

CONFIRMED

The fulfillment is confirmed. This is the default value when no other information is available.

IN_TRANSIT

The fulfillment is in transit.

OUT_FOR_DELIVERY

The fulfillment is out for delivery.

ATTEMPTED_DELIVERY

A delivery was attempted.

DELIVERED

The fulfillment was successfully delivered.

FAILURE

The fulfillment request failed.

DELAYED

The fulfillment was delayed.
Example
"LABEL_PURCHASED"

FundsInput

Fields
Input Field Description
userId - ID!
amount - Int!
Example
{"userId": "4", "amount": 123}

FundsMoveInput

Fields
Input Field Description
fromUserId - ID!
toUserId - ID!
amount - Int!
Example
{
  "fromUserId": "4",
  "toUserId": "4",
  "amount": 987
}

GetTokenQuery

Fields
Input Field Description
code - String!
client_secret - String!
client_id - String!
Example
{
  "code": "abc123",
  "client_secret": "abc123",
  "client_id": "xyz789"
}

GiftQuantities

Fields
Input Field Description
id - ID!
quantity - Int
variantId - ID
Example
{"id": "4", "quantity": 123, "variantId": 4}

GiftQuantityInput

Description

Input for specifying gift quantities

Fields
Input Field Description
giftId - ID! Gift ID
quantity - Int Quantity of this gift
variantId - ID Product variant ID (optional)
Example
{
  "giftId": 4,
  "quantity": 123,
  "variantId": "4"
}

HandWritingSampleOutput

Fields
Field Name Description
outputText - String!
Example
{"outputText": "abc123"}

HandwritingFontStyle

Values
Enum Value Description

CLEAN

MESSY

Example
"CLEAN"

HubSpotCompany

Fields
Field Name Description
id - ID!
name - String
Example
{"id": 4, "name": "xyz789"}

HubSpotContact

Fields
Field Name Description
id - ID!
companyId - ID
name - String!
firstname - String
lastname - String
email - String
company - HubSpotCompany
address - String
city - String
state - String
zip - String
phone - String
Example
{
  "id": "4",
  "companyId": 4,
  "name": "xyz789",
  "firstname": "abc123",
  "lastname": "xyz789",
  "email": "xyz789",
  "company": HubSpotCompany,
  "address": "xyz789",
  "city": "abc123",
  "state": "xyz789",
  "zip": "xyz789",
  "phone": "abc123"
}

HubSpotContactsInput

Fields
Input Field Description
email - String
name - String
Example
{
  "email": "xyz789",
  "name": "xyz789"
}

HubSpotReport

Description

Main report for HubSpot

Fields
Field Name Description
id - ID!
startDate - DateTime!
endDate - DateTime!
currency - String!
hubSpotAccountId - Int!
opportunities - [HubSpotReportOpportunity!]!
orders - [HubSpotReportOrder!]!
Example
{
  "id": 4,
  "startDate": "2007-12-03T10:15:30Z",
  "endDate": "2007-12-03T10:15:30Z",
  "currency": "xyz789",
  "hubSpotAccountId": 987,
  "opportunities": [HubSpotReportOpportunity],
  "orders": [HubSpotReportOrder]
}

HubSpotReportInput

Fields
Input Field Description
startDate - DateTime!
endDate - DateTime!
teamId - String
userId - String
Example
{
  "startDate": "2007-12-03T10:15:30Z",
  "endDate": "2007-12-03T10:15:30Z",
  "teamId": "xyz789",
  "userId": "abc123"
}

HubSpotReportOpportunity

Description

A single Opportunity event for a HubSpot Report. In practice, this will be derived from Opportunities that are related to an order, through the recipient's hubSpotContactId.

Fields
Field Name Description
id - ID!
accountId - ID!
amount - Float!
isWon - Boolean!
isClosed - Boolean!
timestamp - DateTime!
orders - [HubSpotReportOrder!]!
Example
{
  "id": 4,
  "accountId": 4,
  "amount": 987.65,
  "isWon": true,
  "isClosed": true,
  "timestamp": "2007-12-03T10:15:30Z",
  "orders": [HubSpotReportOrder]
}

HubSpotReportOrder

Fields
Field Name Description
id - ID!
campaignId - ID!
hubSpotContactId - ID
amount - Int!
timestamp - DateTime!
campaignName - String!
creatorName - String!
creatorEmail - String!
recipientName - String!
recipientEmail - String!
recipientOrg - String!
description - String!
totalCost - Int!
type - String!
Example
{
  "id": "4",
  "campaignId": "4",
  "hubSpotContactId": "4",
  "amount": 987,
  "timestamp": "2007-12-03T10:15:30Z",
  "campaignName": "xyz789",
  "creatorName": "xyz789",
  "creatorEmail": "abc123",
  "recipientName": "xyz789",
  "recipientEmail": "xyz789",
  "recipientOrg": "xyz789",
  "description": "abc123",
  "totalCost": 123,
  "type": "xyz789"
}

HubSpotToken

Fields
Field Name Description
user - String
hubDomain - String
hubId - ID!
appId - ID!
hubSpotUserId - ID!
Example
{
  "user": "abc123",
  "hubDomain": "abc123",
  "hubId": 4,
  "appId": 4,
  "hubSpotUserId": 4
}

HubSpotTokenInput

Fields
Input Field Description
code - String!
Example
{"code": "xyz789"}

HubSpotUser

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

HubSpotUserInfo

Description

UserInfo specific to the user who connected HubSpot to the org

Fields
Field Name Description
id - ID!
displayName - String!
Example
{"id": 4, "displayName": "xyz789"}

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"

Image

Description

Represents an image resource.

Fields
Field Name Description
altText - String A word or phrase to share the nature or contents of an image.
height - Int The original height of the image in pixels. Returns null if the image is not hosted by Shopify.
id - ID A unique identifier for the image.
url - String!

The location of the image as a URL.

If no transform options are specified, then the original image will be preserved including any pre-applied transforms.

All transformation options are considered "best-effort". Any transformation that the original image type doesn't support will be ignored.

If you need multiple variations of the same image, then you can use GraphQL aliases.

width - Int The original width of the image in pixels. Returns null if the image is not hosted by Shopify.
Example
{
  "altText": "xyz789",
  "height": 987,
  "id": 4,
  "url": "abc123",
  "width": 123
}

ImageInput

Description

Specifies the input fields for an image.

Fields
Input Field Description
id - ID A globally-unique identifier.
altText - String A word or phrase to share the nature or contents of an image.
src - String The URL of the image. May be a staged upload URL.
Example
{
  "id": 4,
  "altText": "xyz789",
  "src": "xyz789"
}

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
123

IntegrationPartners

Values
Enum Value Description

MAKE

ZAPIER

VIA_SOCKET

Example
"MAKE"

InvoiceItem

Fields
Field Name Description
id - ID!
createdAt - DateTime!
amount - Int!
description - String
Example
{
  "id": 4,
  "createdAt": "2007-12-03T10:15:30Z",
  "amount": 123,
  "description": "xyz789"
}

InvoiceItemInput

Fields
Input Field Description
sendId - ID!
amountDollars - Float!
description - String!
Example
{
  "sendId": "4",
  "amountDollars": 987.65,
  "description": "xyz789"
}

JSON

Description

The JSON scalar type represents arbitrary JSON values. It can be an object, array, string, number, boolean, or null.

Example
{}

LinkToken

Fields
Field Name Description
fc - String!
balance - String!
saas - String!
Example
{
  "fc": "xyz789",
  "balance": "xyz789",
  "saas": "xyz789"
}

MailingAddress

Description

Represents a customer mailing address.

For example, a customer's default address and an order's billing address are both mailling addresses.

Fields
Field Name Description
address1 - String The first line of the address. Typically the street address or PO Box number.
address2 - String The second line of the address. Typically the number of the apartment, suite, or unit.
city - String The name of the city, district, village, or town.
company - String The name of the customer's company or organization.
country - String The name of the country.
countryCodeV2 - String

The two-letter code for the country of the address.

For example, US.

firstName - String The first name of the customer.
lastName - String The last name of the customer.
id - ID! A globally-unique identifier.
phone - String

A unique phone number for the customer.

Formatted using E.164 standard. For example, +16135551111.

province - String The region of the address, such as the province, state, or district.
provinceCode - String

The two-letter code for the region.

For example, ON.

zip - String The zip or postal code of the address.
Example
{
  "address1": "xyz789",
  "address2": "xyz789",
  "city": "abc123",
  "company": "xyz789",
  "country": "abc123",
  "countryCodeV2": "xyz789",
  "firstName": "abc123",
  "lastName": "abc123",
  "id": 4,
  "phone": "xyz789",
  "province": "abc123",
  "provinceCode": "abc123",
  "zip": "abc123"
}

MailingAddressInput

Description

The fields used to create or update a mailing address.

Fields
Input Field Description
address1 - String The first line of the address. Typically the street address or PO Box number.
address2 - String The second line of the address. Typically the number of the apartment, suite, or unit.
city - String The name of the city, district, village, or town.
company - String The name of the customer's company or organization.
countryCode - String The two-letter code for the country of the address.
firstName - String The first name of the customer.
lastName - String The last name of the customer.
phone - String

A unique phone number for the customer.

Formatted using E.164 standard. For example, +16135551111.

provinceCode - String The code for the region of the address, such as the province, state, or district. For example QC for Quebec, Canada.
zip - String The zip or postal code of the address.
Example
{
  "address1": "xyz789",
  "address2": "abc123",
  "city": "xyz789",
  "company": "xyz789",
  "countryCode": "abc123",
  "firstName": "abc123",
  "lastName": "xyz789",
  "phone": "xyz789",
  "provinceCode": "xyz789",
  "zip": "xyz789"
}

MediaContentType

Description

The possible content types for a media object.

Values
Enum Value Description

VIDEO

A Shopify-hosted video.

EXTERNAL_VIDEO

An externally hosted video.

MODEL_3D

A 3d model.

IMAGE

A Shopify-hosted image.
Example
"VIDEO"

ModifyUserRoleInput

Fields
Input Field Description
id - ID!
isAdmin - Boolean!
Example
{"id": 4, "isAdmin": true}

Node

Fields
Field Name Description
id - ID!
Example
{"id": 4}

Occasion

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

OktaConfig

Fields
Field Name Description
clientId - String!
issuer - String!
Example
{
  "clientId": "xyz789",
  "issuer": "abc123"
}

OnBoardingDetails

Fields
Field Name Description
price - String!
trialDays - Int!
seats - Int!
acceptedTerms - Boolean!
completed - Boolean!
verified - Boolean!
Example
{
  "price": "xyz789",
  "trialDays": 987,
  "seats": 987,
  "acceptedTerms": true,
  "completed": false,
  "verified": false
}

Order

Fields
Field Name Description
id - ID!
ref - String!
createdAt - DateTime!
creatorName - String
creatorOrg - String
recipientName - String
recipientOrg - String
recipientSubmitsAddress - Boolean
addressConfirmedDate - DateTime
markPurchased - DateTime
events - [DigitalOrderEvent!]
fulfillmentEvents - [FulfillmentEvent!]
type - OrderType!
totalCost - Int!
description - String
cancelledAt - DateTime
Example
{
  "id": 4,
  "ref": "abc123",
  "createdAt": "2007-12-03T10:15:30Z",
  "creatorName": "abc123",
  "creatorOrg": "xyz789",
  "recipientName": "xyz789",
  "recipientOrg": "xyz789",
  "recipientSubmitsAddress": false,
  "addressConfirmedDate": "2007-12-03T10:15:30Z",
  "markPurchased": "2007-12-03T10:15:30Z",
  "events": [DigitalOrderEvent],
  "fulfillmentEvents": [FulfillmentEvent],
  "type": "DIGITAL",
  "totalCost": 987,
  "description": "xyz789",
  "cancelledAt": "2007-12-03T10:15:30Z"
}

OrderQuery

Fields
Input Field Description
createdAtMin - DateTime
createdAtMax - DateTime
type - OrderType
teamId - String
search - String
Example
{
  "createdAtMin": "2007-12-03T10:15:30Z",
  "createdAtMax": "2007-12-03T10:15:30Z",
  "type": "DIGITAL",
  "teamId": "xyz789",
  "search": "abc123"
}

OrderSampleOrder

Fields
Field Name Description
id - String!
value - Int!
message - String!
emailSubject - String!
deliveryMethod - String!
status - String!
Example
{
  "id": "abc123",
  "value": 987,
  "message": "xyz789",
  "emailSubject": "xyz789",
  "deliveryMethod": "xyz789",
  "status": "abc123"
}

OrderSampleRecipient

Fields
Field Name Description
name - String!
email - String
orgName - String!
Example
{
  "name": "abc123",
  "email": "abc123",
  "orgName": "abc123"
}

OrderSampleSender

Fields
Field Name Description
id - String!
email - String!
name - String!
teamId - String!
teamName - String!
Example
{
  "id": "xyz789",
  "email": "abc123",
  "name": "xyz789",
  "teamId": "xyz789",
  "teamName": "abc123"
}

OrderSortKey

Values
Enum Value Description

CREATED_AT_ASC

CREATED_AT_DESC

Example
"CREATED_AT_ASC"

OrderType

Values
Enum Value Description

DIGITAL

PHYSICAL

Example
"DIGITAL"

Orders

Fields
Field Name Description
totalCount - Int!
nodes - [Order!]!
Example
{"totalCount": 123, "nodes": [Order]}

Org

Fields
Field Name Description
id - ID!
name - String!
formattedName - String!
users - Users!
Arguments
skip - Int!
take - Int!
query - UserQuery
logoUrl - String
logoBackgroundColor - String
logoPrimaryColor - String
defaultBrandTemplateId - ID
defaultBrandTemplate - OrgBrandTemplate
brandTemplates - [OrgBrandTemplate!]!
isInternational - Boolean
subscriptionPlan - SubscriptionPlan
hubSpotUserInfo - HubSpotUserInfo
hubSpotUsers - [HubSpotUser!]!
salesForceUserInfo - SalesForceUserInfo
salesForceUsers - [SalesForceUser!]!
onBoardingDetails - OnBoardingDetails
teams - [Teams!]!
budgetAlertDefaultThreshold - Int!
Example
{
  "id": 4,
  "name": "xyz789",
  "formattedName": "abc123",
  "users": Users,
  "logoUrl": "abc123",
  "logoBackgroundColor": "xyz789",
  "logoPrimaryColor": "abc123",
  "defaultBrandTemplateId": 4,
  "defaultBrandTemplate": OrgBrandTemplate,
  "brandTemplates": [OrgBrandTemplate],
  "isInternational": true,
  "subscriptionPlan": SubscriptionPlan,
  "hubSpotUserInfo": HubSpotUserInfo,
  "hubSpotUsers": [HubSpotUser],
  "salesForceUserInfo": SalesForceUserInfo,
  "salesForceUsers": [SalesForceUser],
  "onBoardingDetails": OnBoardingDetails,
  "teams": [Teams],
  "budgetAlertDefaultThreshold": 987
}

OrgBrandTemplate

Fields
Field Name Description
id - ID!
name - String!
logoUrl - String
logoBackgroundColor - String
logoPrimaryColor - String
handwritingFontStyle - HandwritingFontStyle!
isDefault - Boolean!
Example
{
  "id": "4",
  "name": "abc123",
  "logoUrl": "xyz789",
  "logoBackgroundColor": "xyz789",
  "logoPrimaryColor": "abc123",
  "handwritingFontStyle": "CLEAN",
  "isDefault": false
}

OrgBrandTemplateInput

Fields
Input Field Description
name - String!
logoUrl - String
logoBackgroundColor - String
logoPrimaryColor - String
handwritingFontStyle - HandwritingFontStyle
Example
{
  "name": "xyz789",
  "logoUrl": "abc123",
  "logoBackgroundColor": "abc123",
  "logoPrimaryColor": "abc123",
  "handwritingFontStyle": "CLEAN"
}

OrgBranding

Fields
Field Name Description
logoUrl - String
logoBackgroundColor - String
logoPrimaryColor - String
Example
{
  "logoUrl": "abc123",
  "logoBackgroundColor": "abc123",
  "logoPrimaryColor": "xyz789"
}

OrgInput

Fields
Input Field Description
budgetAlertDefaultThreshold - Int
Example
{"budgetAlertDefaultThreshold": 987}

PartyLinkApprovalCriteriaType

Values
Enum Value Description

EMAIL_LIST

COUNT

Example
"EMAIL_LIST"

PartyLinkCancelAndRefundResult

Fields
Field Name Description
success - Boolean!
message - String
refundedAmount - Int!
partyLink - PartyLink
Example
{
  "success": false,
  "message": "abc123",
  "refundedAmount": 123,
  "partyLink": PartyLink
}

PartyLinkClaim

Fields
Field Name Description
id - ID!
createdAt - DateTime!
claimedEmail - String!
claimedName - String
claimedOrg - String
selectedType - PartyLinkSelectedType
selectedOptionId - String
digitalOrder - DigitalOrder
physicalOrder - PhysicalOrder
Example
{
  "id": "4",
  "createdAt": "2007-12-03T10:15:30Z",
  "claimedEmail": "abc123",
  "claimedName": "xyz789",
  "claimedOrg": "xyz789",
  "selectedType": "DIGITAL",
  "selectedOptionId": "abc123",
  "digitalOrder": DigitalOrder,
  "physicalOrder": PhysicalOrder
}

PartyLinkClaimEligibilityInput

Fields
Input Field Description
code - String!
email - String!
name - String
orgName - String
Example
{
  "code": "xyz789",
  "email": "xyz789",
  "name": "xyz789",
  "orgName": "xyz789"
}

PartyLinkClaimEligibilityResult

Fields
Field Name Description
success - Boolean!
message - String
Example
{"success": true, "message": "abc123"}

PartyLinkClaimInput

Fields
Input Field Description
code - String!
email - String!
selectedType - PartyLinkSelectedType
selectedOptionId - String
name - String
orgName - String
Example
{
  "code": "abc123",
  "email": "abc123",
  "selectedType": "DIGITAL",
  "selectedOptionId": "xyz789",
  "name": "xyz789",
  "orgName": "xyz789"
}

PartyLinkClaimResult

Fields
Field Name Description
success - Boolean!
message - String
digitalOrder - DigitalOrder
physicalOrder - PhysicalOrder
partyLink - PartyLink
Example
{
  "success": true,
  "message": "xyz789",
  "digitalOrder": DigitalOrder,
  "physicalOrder": PhysicalOrder,
  "partyLink": PartyLink
}

PartyLinkClaims

Fields
Field Name Description
totalCount - Int!
nodes - [PartyLinkClaim!]!
Example
{"totalCount": 123, "nodes": [PartyLinkClaim]}

PartyLinkFilter

Fields
Input Field Description
type - PartyLinkType
digitalCampaignId - ID
physicalCampaignId - ID
teamId - String
isActive - Boolean
search - String
createdAtMin - DateTime
createdAtMax - DateTime
Example
{
  "type": "DIGITAL",
  "digitalCampaignId": "4",
  "physicalCampaignId": "4",
  "teamId": "xyz789",
  "isActive": true,
  "search": "xyz789",
  "createdAtMin": "2007-12-03T10:15:30Z",
  "createdAtMax": "2007-12-03T10:15:30Z"
}

PartyLinkInput

Fields
Input Field Description
type - PartyLinkType!
digitalCampaignId - ID
physicalCampaignId - ID
approvalCriteriaType - PartyLinkApprovalCriteriaType!
approvedEmails - [String!]
maxClaimCount - Int
sendAll - Boolean
Example
{
  "type": "DIGITAL",
  "digitalCampaignId": "4",
  "physicalCampaignId": "4",
  "approvalCriteriaType": "EMAIL_LIST",
  "approvedEmails": ["abc123"],
  "maxClaimCount": 987,
  "sendAll": false
}

PartyLinkOption

Fields
Field Name Description
id - ID!
type - PartyLinkOptionType!
title - String!
subtitle - String
imageUrl - String
digitalCampaignId - ID
physicalCampaignId - ID
physicalGiftId - ID
variantId - ID
Example
{
  "id": 4,
  "type": "DIGITAL",
  "title": "xyz789",
  "subtitle": "xyz789",
  "imageUrl": "abc123",
  "digitalCampaignId": "4",
  "physicalCampaignId": 4,
  "physicalGiftId": 4,
  "variantId": 4
}

PartyLinkOptionType

Values
Enum Value Description

DIGITAL

PHYSICAL

Example
"DIGITAL"

PartyLinkSelectedType

Values
Enum Value Description

DIGITAL

PHYSICAL

Example
"DIGITAL"

PartyLinkType

Values
Enum Value Description

DIGITAL

PHYSICAL

HYBRID

Example
"DIGITAL"

PaymentMethodSummary

Fields
Field Name Description
id - ID!
type - String!
last4 - String!
brand - String
bankName - String
isDefaultForOrg - Boolean!
isDefaultForTeam - Boolean!
Example
{
  "id": "4",
  "type": "xyz789",
  "last4": "abc123",
  "brand": "abc123",
  "bankName": "xyz789",
  "isDefaultForOrg": false,
  "isDefaultForTeam": false
}

PhysicalCampaign

Fields
Field Name Description
id - ID!
ref - String!
createdAt - DateTime!
name - String!
gifts - [PhysicalGift!]!
variants - [ID!]
messageTemplate - String
physicalNoteTemplate - String
team - Team
private - Boolean!
isRevSendCurated - Boolean
brandTemplateId - ID
Example
{
  "id": 4,
  "ref": "xyz789",
  "createdAt": "2007-12-03T10:15:30Z",
  "name": "xyz789",
  "gifts": [PhysicalGift],
  "variants": ["4"],
  "messageTemplate": "xyz789",
  "physicalNoteTemplate": "xyz789",
  "team": Team,
  "private": true,
  "isRevSendCurated": false,
  "brandTemplateId": 4
}

PhysicalCampaignInput

Fields
Input Field Description
name - String
messageTemplate - String
physicalNoteTemplate - String
giftOptions - [GiftQuantities!]
replaceGifts - Boolean
isArchived - Boolean
isOneOff - Boolean
private - Boolean
team - String
brandTemplateId - ID
Example
{
  "name": "xyz789",
  "messageTemplate": "xyz789",
  "physicalNoteTemplate": "xyz789",
  "giftOptions": [GiftQuantities],
  "replaceGifts": true,
  "isArchived": false,
  "isOneOff": false,
  "private": true,
  "team": "abc123",
  "brandTemplateId": 4
}

PhysicalCampaignQuery

Fields
Input Field Description
createdAtMin - DateTime
createdAtMax - DateTime
isArchived - Boolean
Example
{
  "createdAtMin": "2007-12-03T10:15:30Z",
  "createdAtMax": "2007-12-03T10:15:30Z",
  "isArchived": false
}

PhysicalCampaignSortKey

Values
Enum Value Description

CREATED_AT_ASC

CREATED_AT_DESC

Example
"CREATED_AT_ASC"

PhysicalCampaigns

Fields
Field Name Description
totalCount - Int!
nodes - [PhysicalCampaign!]!
Example
{"totalCount": 123, "nodes": [PhysicalCampaign]}

PhysicalGift

Fields
Field Name Description
id - ID!
title - String!
messageMaxLength - Int
messageMaxLines - Int
descriptionHtml - String
featuredImageSrc - String
initialShippingCost - Int
products - [Product!]!
productVariants - [ProductVariant!]!
isDisabled - Boolean
categories - [String!]!
occasions - [String!]!
isThirdParty - Boolean
shipsThroughWarehouse - Boolean
isDropshipped - Boolean
isAddOn - Boolean
hideInPreview - Boolean
purchaseUrl - String
vendor - PhysicalVendor
orgId - String
requiresPhone - Boolean
isFavorite - Boolean
selectedVariant - ProductVariant
optionId - ID
meta - JSON
Example
{
  "id": "4",
  "title": "abc123",
  "messageMaxLength": 987,
  "messageMaxLines": 123,
  "descriptionHtml": "abc123",
  "featuredImageSrc": "xyz789",
  "initialShippingCost": 987,
  "products": [Product],
  "productVariants": [ProductVariant],
  "isDisabled": true,
  "categories": ["xyz789"],
  "occasions": ["abc123"],
  "isThirdParty": false,
  "shipsThroughWarehouse": true,
  "isDropshipped": false,
  "isAddOn": false,
  "hideInPreview": true,
  "purchaseUrl": "abc123",
  "vendor": PhysicalVendor,
  "orgId": "abc123",
  "requiresPhone": true,
  "isFavorite": false,
  "selectedVariant": ProductVariant,
  "optionId": "4",
  "meta": {}
}

PhysicalGiftInput

Fields
Input Field Description
title - String
vendorId - ID!
productIds - [ID!]!
productVariantIds - [ID!]
categoryIds - [ID!]!
occasionIds - [ID!]!
isThirdParty - Boolean
shipsThroughWarehouse - Boolean
isAddOn - Boolean
hideInPreview - Boolean
initialShippingCost - Int
purchaseUrl - String
isDisabled - Boolean
orgId - String
requiresPhone - Boolean
isDropshipped - Boolean
meta - JSON
Example
{
  "title": "xyz789",
  "vendorId": 4,
  "productIds": [4],
  "productVariantIds": ["4"],
  "categoryIds": ["4"],
  "occasionIds": [4],
  "isThirdParty": false,
  "shipsThroughWarehouse": true,
  "isAddOn": false,
  "hideInPreview": false,
  "initialShippingCost": 123,
  "purchaseUrl": "xyz789",
  "isDisabled": false,
  "orgId": "abc123",
  "requiresPhone": false,
  "isDropshipped": false,
  "meta": {}
}

PhysicalGiftQuery

Fields
Input Field Description
category - String
occasion - String
search - String
addOns - Boolean
ids - [String!]
Example
{
  "category": "xyz789",
  "occasion": "xyz789",
  "search": "xyz789",
  "addOns": false,
  "ids": ["xyz789"]
}

PhysicalGifts

Fields
Field Name Description
totalCount - Int
nodes - [PhysicalGift!]!
Example
{"totalCount": 123, "nodes": [PhysicalGift]}

PhysicalOrder

Fields
Field Name Description
id - ID!
ref - String!
createdAt - DateTime!
recipient - Recipient!
isAddressConfirmed - Boolean
addressConfirmedDate - DateTime
markPurchased - DateTime
markPrinted - DateTime
recipientSubmitsAddress - Boolean
creatorName - String!
creatorEmail - String!
orgName - String!
orgBranding - OrgBranding!
vendorName - String
message - String!
physicalNote - String!
invoiceItems - [InvoiceItem!]!
batchId - String
mailingAddress - MailingAddress
purchaseUrl - String
description - String
shopifyOrderId - String
shopifyOrderName - String
gifts - [PhysicalGift!]
sendAll - Boolean
campaign - PhysicalCampaign
vendorOrderId - String
costToRevSend - Int
fulfillmentEvents - [FulfillmentEvent!]!
images - [Image!]!
giftChoices - [PhysicalGift!]!
selectedGifts - [PhysicalGift!]
hideContents - Boolean
isThirdParty - Boolean
shipsThroughWarehouse - Boolean
cancelledAt - DateTime
needsToSelectGift - Boolean
includeHandwritten - Boolean
fontStyle - HandwritingFontStyle!
expiresAt - DateTime
isExpired - Boolean
Example
{
  "id": 4,
  "ref": "xyz789",
  "createdAt": "2007-12-03T10:15:30Z",
  "recipient": Recipient,
  "isAddressConfirmed": true,
  "addressConfirmedDate": "2007-12-03T10:15:30Z",
  "markPurchased": "2007-12-03T10:15:30Z",
  "markPrinted": "2007-12-03T10:15:30Z",
  "recipientSubmitsAddress": true,
  "creatorName": "abc123",
  "creatorEmail": "abc123",
  "orgName": "xyz789",
  "orgBranding": OrgBranding,
  "vendorName": "xyz789",
  "message": "abc123",
  "physicalNote": "abc123",
  "invoiceItems": [InvoiceItem],
  "batchId": "xyz789",
  "mailingAddress": MailingAddress,
  "purchaseUrl": "abc123",
  "description": "xyz789",
  "shopifyOrderId": "xyz789",
  "shopifyOrderName": "xyz789",
  "gifts": [PhysicalGift],
  "sendAll": false,
  "campaign": PhysicalCampaign,
  "vendorOrderId": "abc123",
  "costToRevSend": 123,
  "fulfillmentEvents": [FulfillmentEvent],
  "images": [Image],
  "giftChoices": [PhysicalGift],
  "selectedGifts": [PhysicalGift],
  "hideContents": false,
  "isThirdParty": true,
  "shipsThroughWarehouse": true,
  "cancelledAt": "2007-12-03T10:15:30Z",
  "needsToSelectGift": false,
  "includeHandwritten": true,
  "fontStyle": "CLEAN",
  "expiresAt": "2007-12-03T10:15:30Z",
  "isExpired": true
}

PhysicalOrderAdminType

Values
Enum Value Description

PENDING_ORDER_PLACEMENT

PENDING_RECIPIENT_SHIPMENT

PENDING_RECIPIENT_DELIVERY

Example
"PENDING_ORDER_PLACEMENT"

PhysicalOrderBatch

Fields
Field Name Description
id - ID!
ref - String!
creator - User!
createdAt - DateTime!
totalOrders - Int!
totalDelivered - Int!
totalPaid - Int!
physicalOrders - PhysicalOrders!
Example
{
  "id": "4",
  "ref": "abc123",
  "creator": User,
  "createdAt": "2007-12-03T10:15:30Z",
  "totalOrders": 987,
  "totalDelivered": 123,
  "totalPaid": 987,
  "physicalOrders": PhysicalOrders
}

PhysicalOrderBulkCreateInput

Description

Input for bulk creating physical orders from CSV data

Fields
Input Field Description
orders - [PhysicalOrderBulkItemInput!]! Array of order data in CSV format
campaignId - ID Campaign ID to use for all orders (mutually exclusive with giftQuantities)
giftQuantities - [GiftQuantityInput!] Array of gift quantities to use for all orders (mutually exclusive with campaignId)
sendAll - Boolean Whether to send all gifts in the campaign to each recipient
hideContents - Boolean Hide gift/package details during redemption and show a surprise screen instead. Only valid when recipient selection is not required.
sendEmail - Boolean Whether to send email notifications to recipients
headlineTemplate - String Subject line template for emails
validateAddress - Boolean Whether to validate addresses before creating orders
includeHandWritten - Boolean Whether to include handwritten notes
brandTemplateId - ID
Example
{
  "orders": [PhysicalOrderBulkItemInput],
  "campaignId": "4",
  "giftQuantities": [GiftQuantityInput],
  "sendAll": false,
  "hideContents": true,
  "sendEmail": false,
  "headlineTemplate": "abc123",
  "validateAddress": false,
  "includeHandWritten": true,
  "brandTemplateId": 4
}

PhysicalOrderBulkItemInput

Description

Input for a single order in bulk creation

Fields
Input Field Description
recipientName - String! Recipient name
recipientOrganization - String! Recipient organization
handwrittenMessage - String! Handwritten message for the recipient
address1 - String! First line of address
address2 - String Second line of address (optional)
city - String! City
state - String! State/Province
postalCode - String! Postal/ZIP code
country - String! Country
Example
{
  "recipientName": "xyz789",
  "recipientOrganization": "xyz789",
  "handwrittenMessage": "xyz789",
  "address1": "xyz789",
  "address2": "xyz789",
  "city": "xyz789",
  "state": "xyz789",
  "postalCode": "xyz789",
  "country": "abc123"
}

PhysicalOrderDeliveryStatus

Values
Enum Value Description

ALL

DELIVERED

PROCESSING

ADDRESS_REQUESTED

SHIPPED

CANCELLED

NOT_DELIVERED

Example
"ALL"

PhysicalOrderFulfillmentQuery

Fields
Input Field Description
completed - Boolean
search - String
Example
{"completed": false, "search": "abc123"}

PhysicalOrderInput

Fields
Input Field Description
giftIds - [GiftQuantities!] The IDs of the gifts for this order. Multiple gift ids can be provided if not from campaign.
campaignId - ID The ID of the specific campaign for this order. One of giftId or campaignId must be provided. If a campaing is provided, the giftId will be determined by the campaign when the recipients chooses a gift from that campaign.
sendAll - Boolean If true, all gifts in a campaign will be sent to the recipient.
hideContents - Boolean Hide gift/package details during redemption and show a surprise screen instead. Only valid when recipient selection is not required.
recipient - RecipientInput The recipient information for this order.
message - String The message that the recipient will receive with the gift.
physicalNote - String This message will be physically printed on a card.
recipientSubmitsAddress - Boolean Indicates whether the recipient will submit their mailing address. If false, the mailing address must be provided by the creator.
mailingAddress - MailingAddressInput The mailing address for the recipient.
sendEmail - Boolean Whether to send the reward link immediately through email or if the user will share the link themselves
headlineTemplate - String Subject line if sending email
validateAddress - Boolean Should we validate address (Exclude check from automations)
includeHandWritten - Boolean Should this order explicitly include a handwritten note
brandTemplateId - ID
Example
{
  "giftIds": [GiftQuantities],
  "campaignId": 4,
  "sendAll": false,
  "hideContents": false,
  "recipient": RecipientInput,
  "message": "abc123",
  "physicalNote": "xyz789",
  "recipientSubmitsAddress": true,
  "mailingAddress": MailingAddressInput,
  "sendEmail": false,
  "headlineTemplate": "abc123",
  "validateAddress": false,
  "includeHandWritten": true,
  "brandTemplateId": 4
}

PhysicalOrderQuery

Fields
Input Field Description
createdAtMin - DateTime
createdAtMax - DateTime
deliveryStatus - PhysicalOrderDeliveryStatus
teamId - String
isDelivered - Boolean
Example
{
  "createdAtMin": "2007-12-03T10:15:30Z",
  "createdAtMax": "2007-12-03T10:15:30Z",
  "deliveryStatus": "ALL",
  "teamId": "abc123",
  "isDelivered": true
}

PhysicalOrderSortKey

Values
Enum Value Description

CREATED_AT_ASC

CREATED_AT_DESC

Example
"CREATED_AT_ASC"

PhysicalOrderWithImportInput

Description

Input for importing a product and creating an order in a single call. Combines ProductImportInput and PhysicalOrderInput fields.

Fields
Input Field Description
title - String! The name/title of the product.
price - Float! The price of the product (in dollars, before any tax markup). Example: 29.99 for $29.99
images - [String!]! Array of image URLs for the product. The first image will be used as the featured image.
source - String! The source vendor identifier (e.g., 'amazon', 'target', 'walmart').
purchaseUrl - String! The original URL where the product can be purchased.
applyTaxMarkup - Boolean Whether to apply tax markup to the price. Default: true for Amazon, false for others.
taxMarkupPercent - Float Custom tax markup percentage (as a decimal). Example: 0.10 for 10% markup. Default: 0.10
shortenTitle - Boolean Whether to use AI to shorten/clean up the product title. Default: true
categoryIds - [String!] Category IDs to associate with the created gift.
occasionIds - [String!] Occasion IDs to associate with the created gift.
shippingCostCents - Int Custom shipping cost in cents. Default: Calculated based on source (e.g., $22 for Amazon).
shipsThroughWarehouse - Boolean Whether the gift ships through the warehouse. Default: true for Amazon.
meta - JSON Additional metadata for the gift (e.g., size, color, custom attributes).
recipient - RecipientInput! The recipient information for this order.
message - String The message that the recipient will receive with the gift.
physicalNote - String This message will be physically printed on a card.
recipientSubmitsAddress - Boolean Indicates whether the recipient will submit their mailing address. If false, the mailing address must be provided by the creator.
mailingAddress - MailingAddressInput The mailing address for the recipient.
sendEmail - Boolean Whether to send the reward link immediately through email or if the user will share the link themselves.
headlineTemplate - String Subject line if sending email.
validateAddress - Boolean Should we validate address (Exclude check from automations).
includeHandWritten - Boolean Should this order explicitly include a handwritten note.
hideContents - Boolean Hide gift/package details during redemption and show a surprise screen instead. Only valid when recipient selection is not required.
brandTemplateId - ID
saveToFavorites - Boolean Whether to immediately save the gift to the current user's favorites. Default: false
Example
{
  "title": "xyz789",
  "price": 987.65,
  "images": ["abc123"],
  "source": "abc123",
  "purchaseUrl": "abc123",
  "applyTaxMarkup": true,
  "taxMarkupPercent": 123.45,
  "shortenTitle": false,
  "categoryIds": ["xyz789"],
  "occasionIds": ["abc123"],
  "shippingCostCents": 123,
  "shipsThroughWarehouse": false,
  "meta": {},
  "recipient": RecipientInput,
  "message": "xyz789",
  "physicalNote": "xyz789",
  "recipientSubmitsAddress": false,
  "mailingAddress": MailingAddressInput,
  "sendEmail": true,
  "headlineTemplate": "abc123",
  "validateAddress": false,
  "includeHandWritten": false,
  "hideContents": true,
  "brandTemplateId": 4,
  "saveToFavorites": true
}

PhysicalOrders

Fields
Field Name Description
totalCount - Int!
nodes - [PhysicalOrder!]!
Example
{"totalCount": 987, "nodes": [PhysicalOrder]}

PhysicalOrdersAdminCounts

Fields
Field Name Description
PENDING_ORDER_PLACEMENT - Int!
PENDING_RECIPIENT_SHIPMENT - Int!
PENDING_RECIPIENT_DELIVERY - Int!
Example
{
  "PENDING_ORDER_PLACEMENT": 123,
  "PENDING_RECIPIENT_SHIPMENT": 123,
  "PENDING_RECIPIENT_DELIVERY": 123
}

PhysicalVendor

Fields
Field Name Description
id - ID!
name - String!
messageMaxLength - Int
messageMaxLines - Int
Example
{
  "id": "4",
  "name": "xyz789",
  "messageMaxLength": 123,
  "messageMaxLines": 987
}

Price

Fields
Field Name Description
value - Int
recurring - String
id - String
Example
{
  "value": 987,
  "recurring": "abc123",
  "id": "xyz789"
}

Product

Description

Represents a product, including information about related collections and product variants.

Fields
Field Name Description
id - ID! Globally unique identifier.
org - Org Org that owns this product, if any
title - String A product is an addon if it doesn't belong to a single gift, but can be added on to gifts. E.g. special wrapping paper, or a custom printed card.
isAddon - Boolean
images - [Image!]! A list of images associated with this product
variants - [ProductVariant!] A list of variants associated with the product.
totalInventory - Int Inventory level for item in warehouse
Example
{
  "id": 4,
  "org": Org,
  "title": "abc123",
  "isAddon": false,
  "images": [Image],
  "variants": [ProductVariant],
  "totalInventory": 987
}

ProductCreatePayload

Description

Return type for productCreate mutation.

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

ProductImportInput

Description

Input for importing a product from an external source.

Fields
Input Field Description
title - String! The name/title of the product.
price - Float! The price of the product (in dollars, before any tax markup). Example: 29.99 for $29.99
images - [String!]! Array of image URLs for the product. The first image will be used as the featured image.
source - String! The source vendor identifier (e.g., 'amazon', 'target', 'walmart'). This determines default settings like tax markup and shipping costs.
purchaseUrl - String! The original URL where the product can be purchased. This is stored for reference and potential re-ordering.
applyTaxMarkup - Boolean Whether to apply tax markup to the price. Default: true for Amazon, false for others.
taxMarkupPercent - Float Custom tax markup percentage (as a decimal). Example: 0.10 for 10% markup. Default: 0.10
shortenTitle - Boolean Whether to use AI to shorten/clean up the product title. Default: true
categoryIds - [String!] Category IDs to associate with the created gift.
occasionIds - [String!] Occasion IDs to associate with the created gift.
shippingCostCents - Int Custom shipping cost in cents. Default: Calculated based on source (e.g., $22 for Amazon).
shipsThroughWarehouse - Boolean Whether the gift ships through the warehouse. Default: true for Amazon.
orgId - String Optional organization ID to associate the gift with a specific org. If not provided, the gift will be available globally.
saveToFavorites - Boolean Whether to immediately save the gift to the current user's favorites. Default: false
meta - JSON Additional metadata for the gift (e.g., size, color, custom attributes). This is stored as arbitrary JSON and can contain any key-value pairs.
Example
{
  "title": "xyz789",
  "price": 123.45,
  "images": ["abc123"],
  "source": "abc123",
  "purchaseUrl": "abc123",
  "applyTaxMarkup": false,
  "taxMarkupPercent": 123.45,
  "shortenTitle": false,
  "categoryIds": ["abc123"],
  "occasionIds": ["xyz789"],
  "shippingCostCents": 123,
  "shipsThroughWarehouse": false,
  "orgId": "xyz789",
  "saveToFavorites": false,
  "meta": {}
}

ProductImportResult

Description

Result returned after successfully importing a product.

Fields
Field Name Description
giftId - ID! The created PhysicalGift ID. Use this ID to add the gift to campaigns or create orders.
productId - ID! The created Shopify Product ID.
variantId - ID! The default ProductVariant ID.
title - String! The final title (may be shortened if shortenTitle was true).
priceCents - Int! The final price including any tax markup (in cents). Example: 3299 for $32.99
imageUrl - String The URL of the featured image, if available.
Example
{
  "giftId": "4",
  "productId": 4,
  "variantId": "4",
  "title": "xyz789",
  "priceCents": 123,
  "imageUrl": "xyz789"
}

ProductInput

Description

Specifies the input fields required to create a product.

Fields
Input Field Description
descriptionHtml - String The description of the product, complete with HTML formatting.
productType - String The product type specified by the merchant.
customProductType - String The custom product type specified by the merchant.
tags - [String!] A comma separated list of tags that have been added to the product.
templateSuffix - String The theme template used when viewing the product in a store.
title - String The title of the product.
vendor - String The name of the product's vendor.
collectionsToJoin - [ID!] The IDs of the collections that this product will be added to.
collectionsToLeave - [ID!] The IDs of collections that will no longer include the existing product.
id - ID Specifies the product to update in productUpdate or creates a new product if absent in productCreate.
images - [ImageInput!] The images to associate with the product.
options - [String!] List of custom product options (maximum of 3 per product).
variants - [ProductVariantInput!] A list of variants associated with the product.
status - ProductStatus The status of the product.
requiresSellingPlan - Boolean Whether the product can only be purchased with a selling plan (subscription). Products that are sold exclusively on subscription can only be created on online stores. If set to true on an already existing product, then the product will be marked unavailable on channels that don't support subscriptions.
shortenTitle - Boolean Custom field to use AI to shorten a title
Example
{
  "descriptionHtml": "abc123",
  "productType": "xyz789",
  "customProductType": "abc123",
  "tags": ["abc123"],
  "templateSuffix": "xyz789",
  "title": "xyz789",
  "vendor": "xyz789",
  "collectionsToJoin": ["4"],
  "collectionsToLeave": ["4"],
  "id": 4,
  "images": [ImageInput],
  "options": ["xyz789"],
  "variants": [ProductVariantInput],
  "status": "ACTIVE",
  "requiresSellingPlan": true,
  "shortenTitle": false
}

ProductStatus

Description

The possible product statuses.

Values
Enum Value Description

ACTIVE

The product is ready to sell and can be published to sales channels and apps. Products with an active status aren't automatically published to sales channels, such as the online store, or apps. By default, existing products are set to active.

ARCHIVED

The product is no longer being sold and isn't available to customers on sales channels and apps.

DRAFT

The product isn't ready to sell and is unavailable to customers on sales channels and apps. By default, duplicated and unarchived products are set to draft.
Example
"ACTIVE"

ProductVariant

Description

Represents a product variant.

Fields
Field Name Description
id - ID! Globally unique identifier.
price - Int! Price, in cents
images - [Image!] A list of images associated with this product variant
title - String The title of the product variant
Example
{
  "id": "4",
  "price": 123,
  "images": [Image],
  "title": "xyz789"
}

ProductVariantInput

Description

Specifies a product variant to create or update.

Fields
Input Field Description
id - ID Specifies the product variant to update or create a new variant if absent.
imageId - ID The ID of the image that's associated with the variant.
imageSrc - String The URL of an image to associate with the variant. This field can only be used through mutations that create product images and must match one of the URLs being created on the product.
mediaSrc - [String!] The URL of the media to associate with the variant. This field can only be used in mutations that create media images and must match one of the URLs being created on the product. This field only accepts one value.
inventoryPolicy - ProductVariantInventoryPolicy Whether customers are allowed to place an order for the product variant when it's out of stock.
options - [String!] The custom properties that a shop owner uses to define product variants.
position - Int The order of the product variant in the list of product variants. The first position in the list is 1.
price - String The price of the variant.
productId - ID The product to create the variant for. Used as input only to the productVariantCreate mutation.
requiresShipping - Boolean Whether the variant requires shipping.
sku - String The SKU for the variant.
taxable - Boolean Whether the variant is taxable.
taxCode - String The tax code associated with the variant.
weight - Float The weight of the variant.
Example
{
  "id": 4,
  "imageId": "4",
  "imageSrc": "xyz789",
  "mediaSrc": ["abc123"],
  "inventoryPolicy": "DENY",
  "options": ["xyz789"],
  "position": 123,
  "price": "abc123",
  "productId": "4",
  "requiresShipping": false,
  "sku": "xyz789",
  "taxable": false,
  "taxCode": "abc123",
  "weight": 123.45
}

ProductVariantInventoryPolicy

Description

The valid values for the inventory policy of a product variant once it is out of stock.

Values
Enum Value Description

DENY

Customers can't buy this product variant after it's out of stock.

CONTINUE

Customers can buy this product variant after it's out of stock.
Example
"DENY"

Recipient

Fields
Field Name Description
id - ID!
org - Org
email - String
name - String!
salesForceContactId - ID
salesForceAccountId - ID
hubSpotContactId - ID
hubSpotCompanyId - ID
orgName - String
Example
{
  "id": 4,
  "org": Org,
  "email": "abc123",
  "name": "abc123",
  "salesForceContactId": 4,
  "salesForceAccountId": 4,
  "hubSpotContactId": 4,
  "hubSpotCompanyId": "4",
  "orgName": "abc123"
}

RecipientInput

Fields
Input Field Description
email - String
name - String!
salesForceContactId - String
salesForceAccountId - String
hubSpotContactId - String
hubSpotCompanyId - String
orgName - String
Example
{
  "email": "abc123",
  "name": "xyz789",
  "salesForceContactId": "xyz789",
  "salesForceAccountId": "abc123",
  "hubSpotContactId": "abc123",
  "hubSpotCompanyId": "xyz789",
  "orgName": "abc123"
}

ResendInviteInput

Fields
Input Field Description
userId - ID!
Example
{"userId": 4}

RevokeInviteInput

Fields
Input Field Description
userId - ID!
Example
{"userId": "4"}

Role

Values
Enum Value Description

ADMIN

USER

RS_ADMIN

Example
"ADMIN"

SalesForceAccount

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

SalesForceContact

Fields
Field Name Description
id - ID!
phone - String
email - String
name - String
account - SalesForceAccount
mailingAddress - SalesForceMailingAddress
Example
{
  "id": "4",
  "phone": "abc123",
  "email": "xyz789",
  "name": "abc123",
  "account": SalesForceAccount,
  "mailingAddress": SalesForceMailingAddress
}

SalesForceContactInput

Fields
Input Field Description
id - ID!
accountId - ID
Example
{
  "id": "4",
  "accountId": "4"
}

SalesForceContactsInput

Fields
Input Field Description
contactName - String!
Example
{"contactName": "xyz789"}

SalesForceMailingAddress

Fields
Field Name Description
city - String
country - String
postalCode - String
state - String
street - String
Example
{
  "city": "xyz789",
  "country": "abc123",
  "postalCode": "abc123",
  "state": "abc123",
  "street": "xyz789"
}

SalesForceReport

Description

Main report for SalesForce

Fields
Field Name Description
id - ID!
startDate - DateTime!
endDate - DateTime!
currency - String!
salesForceOrgId - String!
opportunities - [SalesForceReportOpportunity!]!
orders - [SalesForceReportOrder!]!
Example
{
  "id": "4",
  "startDate": "2007-12-03T10:15:30Z",
  "endDate": "2007-12-03T10:15:30Z",
  "currency": "xyz789",
  "salesForceOrgId": "abc123",
  "opportunities": [SalesForceReportOpportunity],
  "orders": [SalesForceReportOrder]
}

SalesForceReportInput

Fields
Input Field Description
startDate - DateTime!
endDate - DateTime!
teamId - String
userId - String
Example
{
  "startDate": "2007-12-03T10:15:30Z",
  "endDate": "2007-12-03T10:15:30Z",
  "teamId": "abc123",
  "userId": "abc123"
}

SalesForceReportOpportunity

Description

A single Opportunity event for a SalesForce Report. In practice, this will be derived from Opportunities that are related to an order, through the recipient's salesForceAccountId.

Fields
Field Name Description
id - ID!
accountId - ID!
amount - Float!
isWon - Boolean!
isClosed - Boolean!
timestamp - DateTime!
orders - [SalesForceReportOrder!]!
Example
{
  "id": 4,
  "accountId": 4,
  "amount": 123.45,
  "isWon": false,
  "isClosed": false,
  "timestamp": "2007-12-03T10:15:30Z",
  "orders": [SalesForceReportOrder]
}

SalesForceReportOrder

Fields
Field Name Description
id - ID!
campaignId - ID!
salesForceAccountId - ID
amount - Int!
timestamp - DateTime!
campaignName - String!
creatorName - String!
creatorEmail - String!
recipientName - String!
recipientEmail - String!
recipientOrg - String!
description - String!
totalCost - Int!
type - String!
Example
{
  "id": 4,
  "campaignId": 4,
  "salesForceAccountId": "4",
  "amount": 987,
  "timestamp": "2007-12-03T10:15:30Z",
  "campaignName": "abc123",
  "creatorName": "xyz789",
  "creatorEmail": "abc123",
  "recipientName": "xyz789",
  "recipientEmail": "abc123",
  "recipientOrg": "xyz789",
  "description": "abc123",
  "totalCost": 123,
  "type": "xyz789"
}

SalesForceToken

Fields
Field Name Description
id - ID!
instanceUrl - String!
Example
{"id": 4, "instanceUrl": "xyz789"}

SalesForceTokenInput

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

SalesForceUser

Fields
Field Name Description
id - ID!
name - String!
email - String!
Example
{
  "id": 4,
  "name": "abc123",
  "email": "xyz789"
}

SalesForceUserInfo

Description

UserInfo specific to the user who connected SalesForce to the org

Fields
Field Name Description
id - ID!
username - String!
nickName - String!
displayName - String!
Example
{
  "id": "4",
  "username": "abc123",
  "nickName": "abc123",
  "displayName": "xyz789"
}

ScriptInput

Fields
Input Field Description
batchId - String
Example
{"batchId": "xyz789"}

SlackIntegrationStatus

Fields
Field Name Description
connected - Boolean!
teamId - String
teamName - String
installedByUserId - String
installedAt - DateTime
installUrl - String!
Example
{
  "connected": false,
  "teamId": "abc123",
  "teamName": "xyz789",
  "installedByUserId": "xyz789",
  "installedAt": "2007-12-03T10:15:30Z",
  "installUrl": "xyz789"
}

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
"xyz789"

StripePrice

Fields
Field Name Description
id - ID!
name - String
value - Int
Example
{
  "id": "4",
  "name": "xyz789",
  "value": 987
}

SubscriptionPaymentMethod

Fields
Field Name Description
type - String!
last4 - String!
brand - String
bankName - String
Example
{
  "type": "xyz789",
  "last4": "xyz789",
  "brand": "xyz789",
  "bankName": "xyz789"
}

SubscriptionPlan

Fields
Field Name Description
id - ID!
canUseWarehouse - Boolean!
Example
{"id": "4", "canUseWarehouse": true}

SubscriptionResponse

Fields
Field Name Description
currentSeats - Int!
costPerSeat - Int!
usedSeats - Int!
planName - String
paymentMethod - SubscriptionPaymentMethod
Example
{
  "currentSeats": 123,
  "costPerSeat": 987,
  "usedSeats": 123,
  "planName": "abc123",
  "paymentMethod": SubscriptionPaymentMethod
}

Team

Fields
Field Name Description
id - ID!
name - String!
defaultPaymentMethodId - String
users - [User!]!
isAdmin - Boolean!
Example
{
  "id": 4,
  "name": "xyz789",
  "defaultPaymentMethodId": "abc123",
  "users": [User],
  "isAdmin": false
}

TeamCreateInput

Fields
Input Field Description
name - String!
Example
{"name": "abc123"}

TeamPaymentMethods

Fields
Field Name Description
teamId - ID!
defaultPaymentMethodId - String
methods - [PaymentMethodSummary!]!
Example
{
  "teamId": "4",
  "defaultPaymentMethodId": "abc123",
  "methods": [PaymentMethodSummary]
}

Teams

Fields
Field Name Description
id - String!
name - String!
defaultPaymentMethodId - String
users - [UsersWithTeam!]!
Example
{
  "id": "abc123",
  "name": "xyz789",
  "defaultPaymentMethodId": "abc123",
  "users": [UsersWithTeam]
}

ThankYouInput

Fields
Input Field Description
orderRef - ID!
message - String!
recipientName - String!
Example
{
  "orderRef": 4,
  "message": "xyz789",
  "recipientName": "xyz789"
}

ThankYouResult

Fields
Field Name Description
success - Boolean!
message - String
Example
{"success": false, "message": "abc123"}

User

Fields
Field Name Description
id - ID!
name - String!
email - String!
role - Role!
budget - Budget
salesForceUserId - String
hubSpotUserId - String
teams - [UserTeams]
org - Org
status - UserStatus!
googleEmail - String
microsoftEmail - String
hideOnboardingModal - Boolean
userOnboardingRole - String
hubSpotToken - HubSpotToken
apiKeys - [ApiKey!]!
budgetReminderEnabled - Boolean
shippingUpdatesEnabled - Boolean
inviteCode - String
Example
{
  "id": "4",
  "name": "xyz789",
  "email": "xyz789",
  "role": "ADMIN",
  "budget": Budget,
  "salesForceUserId": "abc123",
  "hubSpotUserId": "xyz789",
  "teams": [UserTeams],
  "org": Org,
  "status": "ACTIVE",
  "googleEmail": "abc123",
  "microsoftEmail": "xyz789",
  "hideOnboardingModal": true,
  "userOnboardingRole": "abc123",
  "hubSpotToken": HubSpotToken,
  "apiKeys": [ApiKey],
  "budgetReminderEnabled": false,
  "shippingUpdatesEnabled": false,
  "inviteCode": "abc123"
}

UserByInviteCodeInput

Fields
Input Field Description
inviteCode - String!
Example
{"inviteCode": "abc123"}

UserChangeTeamInput

Fields
Input Field Description
userId - ID!
teamId - ID!
Example
{"userId": 4, "teamId": 4}

UserChangeTeamRoleInput

Fields
Input Field Description
userId - ID!
teamId - ID!
isAdmin - Boolean!
Example
{"userId": 4, "teamId": 4, "isAdmin": true}

UserError

Description

Represents an error in the input of a mutation.

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": "xyz789"
}

UserInput

Fields
Input Field Description
email - String
team - ID
isAdmin - Boolean
salesForceUserId - String
name - String
budgetReminderEnabled - Boolean
shippingUpdatesEnabled - Boolean
Example
{
  "email": "xyz789",
  "team": "4",
  "isAdmin": true,
  "salesForceUserId": "xyz789",
  "name": "abc123",
  "budgetReminderEnabled": true,
  "shippingUpdatesEnabled": false
}

UserQuery

Fields
Input Field Description
text - String
status - UserStatus
Example
{"text": "abc123", "status": "ACTIVE"}

UserStatus

Values
Enum Value Description

ACTIVE

INACTIVE

INVITED

Example
"ACTIVE"

UserTeams

Fields
Field Name Description
userId - String!
teamId - String!
name - String!
isAdmin - Boolean!
Example
{
  "userId": "xyz789",
  "teamId": "xyz789",
  "name": "xyz789",
  "isAdmin": false
}

Users

Fields
Field Name Description
totalCount - Int!
nodes - [User!]!
Example
{"totalCount": 987, "nodes": [User]}

UsersWithTeam

Fields
Field Name Description
isAdmin - Boolean
user - User!
Example
{"isAdmin": true, "user": User}

WebhookCreateInput

Fields
Input Field Description
url - String!
source - IntegrationPartners!
type - WebhookTypes!
Example
{
  "url": "abc123",
  "source": "MAKE",
  "type": "ORDER_STATUS_UPDATE"
}

WebhookCreateResponse

Fields
Field Name Description
id - String!
Example
{"id": "abc123"}

WebhookDeleteInput

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

WebhookSampleResponse

Fields
Field Name Description
order - OrderSampleOrder!
recipient - OrderSampleRecipient!
sender - OrderSampleSender!
Example
{
  "order": OrderSampleOrder,
  "recipient": OrderSampleRecipient,
  "sender": OrderSampleSender
}

WebhookTypes

Values
Enum Value Description

ORDER_STATUS_UPDATE

ORDER_CREATE

Example
"ORDER_STATUS_UPDATE"