RevSend GraphQL Reference
Production API
Terms of Service
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
}
]
}
}
partyLink
Example
Query
query PartyLink($code: String!) {
partyLink(code: $code) {
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
{"code": "xyz789"}
Response
{
"data": {
"partyLink": {
"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": 987,
"claimCount": 987,
"isActive": false,
"cancelledAt": "2007-12-03T10:15:30Z",
"sendAll": false,
"totalAmountCharged": 987,
"availableOptions": [PartyLinkOption],
"creator": User,
"team": Team,
"org": Org,
"claims": PartyLinkClaims
}
}
}
partyLinks
Response
Returns a PartyLinks!
Arguments
| Name | Description |
|---|---|
skip - Int!
|
|
take - Int!
|
|
query - PartyLinkFilter
|
Example
Query
query PartyLinks(
$skip: Int!,
$take: Int!,
$query: PartyLinkFilter
) {
partyLinks(
skip: $skip,
take: $take,
query: $query
) {
totalCount
nodes {
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
{"skip": 123, "take": 987, "query": PartyLinkFilter}
Response
{
"data": {
"partyLinks": {
"totalCount": 123,
"nodes": [PartyLink]
}
}
}
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
apiKeyRevoke
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
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!
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!
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!
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!
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
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
digitalBrandSetFavorite
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
digitalOrderBatchMarkDelivered
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
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
digitalOrderMarkDelivered
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
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
microsoftEmailPermissionVerify
Response
Returns an EmailPermissionVerification!
Example
Query
mutation MicrosoftEmailPermissionVerify {
microsoftEmailPermissionVerify {
hasPermission
message
}
}
Response
{
"data": {
"microsoftEmailPermissionVerify": {
"hasPermission": true,
"message": "abc123"
}
}
}
microsoftTokenCreate
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
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
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
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
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
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
Response
Returns a PartyLinkClaimEligibilityResult!
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!
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
physicalGiftSetFavorite
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!
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
physicalOrderMarkPurchased
Response
Returns a PhysicalOrder!
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
physicalOrderSendToPrinter
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!
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:
-
Create the product with variants. Don't specify any tags or collections on the product, and don't specify inventory quantities for each variant.
-
After the product is created, add tags to the product using the tagsAdd mutation, and add collections using the collectionsAddProducts mutation.
-
Use the inventoryBulkToggleActivation mutation on each inventory item to activate it at the appropriate locations.
-
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
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
setupIntentCreate
signUpWithGoogle
Example
Query
mutation SignUpWithGoogle(
$credential: String!,
$promoCode: String
) {
signUpWithGoogle(
credential: $credential,
promoCode: $promoCode
)
}
Variables
{
"credential": "abc123",
"promoCode": "abc123"
}
Response
{"data": {"signUpWithGoogle": "xyz789"}}
signUpWithMicrosoft
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!
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
Example
Query
mutation TeamAttachCardPaymentMethod(
$teamId: ID!,
$paymentMethodId: ID!
) {
teamAttachCardPaymentMethod(
teamId: $teamId,
paymentMethodId: $paymentMethodId
)
}
Variables
{"teamId": "4", "paymentMethodId": 4}
Response
{"data": {"teamAttachCardPaymentMethod": true}}
teamClearDefaultPaymentMethod
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
Example
Query
mutation TeamDetachPaymentMethod(
$teamId: ID!,
$paymentMethodId: ID!
) {
teamDetachPaymentMethod(
teamId: $teamId,
paymentMethodId: $paymentMethodId
)
}
Variables
{"teamId": 4, "paymentMethodId": "4"}
Response
{"data": {"teamDetachPaymentMethod": true}}
teamSetDefaultPaymentMethod
Example
Query
mutation TeamSetDefaultPaymentMethod(
$teamId: ID!,
$paymentMethodId: ID!
) {
teamSetDefaultPaymentMethod(
teamId: $teamId,
paymentMethodId: $paymentMethodId
)
}
Variables
{
"teamId": "4",
"paymentMethodId": "4"
}
Response
{"data": {"teamSetDefaultPaymentMethod": false}}
updateUserOnboardingRole
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
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
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
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
AssetUploadUrl
AssetUploadUrlInput
Fields
| Input Field | Description |
|---|---|
contentType - String!
|
Example
{"contentType": "xyz789"}
AuthenticationRedirectResponse
Bank
Boolean
Description
The Boolean scalar type represents true or false.
Budget
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
Example
{
"isPaymentFallbackEnabled": false,
"isRollover": false,
"refillAmount": 123,
"alertEnabled": true,
"alertThresholdAmount": 987,
"alertRecipientEmail": "xyz789"
}
CSVValidationError
Description
A validation error found in the CSV
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
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
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 |
|---|---|
|
|
|
|
|
Example
"CREATED_AT_ASC"
CampaignType
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"DIGITAL"
Campaigns
Fields
| Field Name | Description |
|---|---|
totalCount - Int!
|
|
nodes - [Campaign!]!
|
Example
{"totalCount": 987, "nodes": [Campaign]}
Card
Category
Charge
ChargeQuery
Charges
Fields
| Field Name | Description |
|---|---|
totalCount - Int
|
|
nextPage - String
|
|
nodes - [Charge!]!
|
Example
{
"totalCount": 987,
"nextPage": "abc123",
"nodes": [Charge]
}
CloneCuratedCampaignResult
Types
| Union Types |
|---|
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 |
|---|---|
|
|
|
|
|
Example
"USD"
Customer
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
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
Example
{
"name": "abc123",
"messageTemplate": "xyz789",
"headlineTemplate": "xyz789",
"brands": ["4"],
"rewardValue": 123,
"currency": "USD",
"allowCharity": true,
"isArchived": false,
"team": "abc123",
"private": false,
"brandTemplateId": "4"
}
DigitalCampaignQuery
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 |
|---|---|
|
|
|
|
|
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
Example
{
"id": 4,
"ref": "abc123",
"creator": User,
"createdAt": "2007-12-03T10:15:30Z",
"totalOrders": 123,
"totalDelivered": 123,
"totalPaid": 987,
"digitalOrders": DigitalOrders
}
DigitalOrderBatchQuery
DigitalOrderBatchSortKey
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
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
DigitalOrderDeliveryMethod
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
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 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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
DigitalOrderSortKey
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"CREATED_AT_ASC"
DigitalOrderStatus
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
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
EmailPermissionVerification
EmailProviderCheck
ExchangeRate
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 |
|---|---|
|
|
A shipping label has been purchased. |
|
|
A purchased shipping label has been printed. |
|
|
The fulfillment is ready to be picked up. |
|
|
The fulfillment is confirmed. This is the default value when no other information is available. |
|
|
The fulfillment is in transit. |
|
|
The fulfillment is out for delivery. |
|
|
A delivery was attempted. |
|
|
The fulfillment was successfully delivered. |
|
|
The fulfillment request failed. |
|
|
The fulfillment was delayed. |
Example
"LABEL_PURCHASED"
FundsInput
FundsMoveInput
GetTokenQuery
GiftQuantities
GiftQuantityInput
HandWritingSampleOutput
Fields
| Field Name | Description |
|---|---|
outputText - String!
|
Example
{"outputText": "abc123"}
HandwritingFontStyle
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"CLEAN"
HubSpotCompany
HubSpotContact
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
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
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.
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
HubSpotTokenInput
Fields
| Input Field | Description |
|---|---|
code - String!
|
Example
{"code": "xyz789"}
HubSpotUser
HubSpotUserInfo
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.
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 |
|---|---|
|
|
|
|
|
|
|
|
Example
"MAKE"
InvoiceItem
InvoiceItemInput
JSON
Description
The JSON scalar type represents arbitrary JSON values. It can be an object, array, string, number, boolean, or null.
Example
{}
LinkToken
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 |
|---|---|
|
|
A Shopify-hosted video. |
|
|
An externally hosted video. |
|
|
A 3d model. |
|
|
A Shopify-hosted image. |
Example
"VIDEO"
ModifyUserRoleInput
Node
Fields
| Field Name | Description |
|---|---|
id - ID!
|
Possible Types
| Node Types |
|---|
Example
{"id": 4}
Occasion
OktaConfig
OnBoardingDetails
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
OrderSampleOrder
OrderSampleRecipient
OrderSampleSender
OrderSortKey
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"CREATED_AT_ASC"
OrderType
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"DIGITAL"
Orders
Org
Fields
| Field Name | Description |
|---|---|
id - ID!
|
|
name - String!
|
|
formattedName - String!
|
|
users - Users!
|
|
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
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
OrgInput
Fields
| Input Field | Description |
|---|---|
budgetAlertDefaultThreshold - Int
|
Example
{"budgetAlertDefaultThreshold": 987}
PartyLink
Fields
| Field Name | Description |
|---|---|
id - ID!
|
|
code - String!
|
|
createdAt - DateTime!
|
|
updatedAt - DateTime!
|
|
type - PartyLinkType!
|
|
digitalCampaign - DigitalCampaign
|
|
physicalCampaign - PhysicalCampaign
|
|
approvalCriteriaType - PartyLinkApprovalCriteriaType!
|
|
approvedEmails - [String!]
|
|
maxClaimCount - Int
|
|
claimCount - Int!
|
|
isActive - Boolean!
|
|
cancelledAt - DateTime
|
|
sendAll - Boolean
|
|
totalAmountCharged - Int
|
|
availableOptions - [PartyLinkOption!]!
|
|
creator - User!
|
|
team - Team!
|
|
org - Org!
|
|
claims - PartyLinkClaims!
|
|
Example
{
"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": 987,
"claimCount": 123,
"isActive": false,
"cancelledAt": "2007-12-03T10:15:30Z",
"sendAll": false,
"totalAmountCharged": 987,
"availableOptions": [PartyLinkOption],
"creator": User,
"team": Team,
"org": Org,
"claims": PartyLinkClaims
}
PartyLinkApprovalCriteriaType
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"EMAIL_LIST"
PartyLinkCancelAndRefundResult
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
PartyLinkClaimEligibilityResult
PartyLinkClaimInput
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
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
Example
{
"id": 4,
"type": "DIGITAL",
"title": "xyz789",
"subtitle": "xyz789",
"imageUrl": "abc123",
"digitalCampaignId": "4",
"physicalCampaignId": 4,
"physicalGiftId": 4,
"variantId": 4
}
PartyLinkOptionType
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"DIGITAL"
PartyLinkSelectedType
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"DIGITAL"
PartyLinkType
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"DIGITAL"
PartyLinks
Fields
| Field Name | Description |
|---|---|
totalCount - Int!
|
|
nodes - [PartyLink!]!
|
Example
{"totalCount": 123, "nodes": [PartyLink]}
PaymentMethodSummary
Example
{
"id": "4",
"type": "xyz789",
"last4": "abc123",
"brand": "abc123",
"bankName": "xyz789",
"isDefaultForOrg": false,
"isDefaultForTeam": false
}
PhysicalCampaign
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
Example
{
"name": "xyz789",
"messageTemplate": "xyz789",
"physicalNoteTemplate": "xyz789",
"giftOptions": [GiftQuantities],
"replaceGifts": true,
"isArchived": false,
"isOneOff": false,
"private": true,
"team": "abc123",
"brandTemplateId": 4
}
PhysicalCampaignQuery
PhysicalCampaignSortKey
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
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
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 |
|---|---|
|
|
|
|
|
|
|
|
Example
"PENDING_ORDER_PLACEMENT"
PhysicalOrderBatch
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 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"ALL"
PhysicalOrderFulfillmentQuery
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 |
|---|---|
|
|
|
|
|
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
PhysicalVendor
Price
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 |
|---|---|
|
|
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. |
|
|
The product is no longer being sold and isn't available to customers on sales channels and apps. |
|
|
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.
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 |
|---|---|
|
|
Customers can't buy this product variant after it's out of stock. |
|
|
Customers can buy this product variant after it's out of stock. |
Example
"DENY"
Recipient
Example
{
"id": 4,
"org": Org,
"email": "abc123",
"name": "abc123",
"salesForceContactId": 4,
"salesForceAccountId": 4,
"hubSpotContactId": 4,
"hubSpotCompanyId": "4",
"orgName": "abc123"
}
RecipientInput
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 |
|---|---|
|
|
|
|
|
|
|
|
Example
"ADMIN"
SalesForceAccount
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
SalesForceContactsInput
Fields
| Input Field | Description |
|---|---|
contactName - String!
|
Example
{"contactName": "xyz789"}
SalesForceMailingAddress
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
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.
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
SalesForceTokenInput
SalesForceUser
SalesForceUserInfo
ScriptInput
Fields
| Input Field | Description |
|---|---|
batchId - String
|
Example
{"batchId": "xyz789"}
SlackIntegrationStatus
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
SubscriptionPaymentMethod
SubscriptionPlan
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
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
ThankYouResult
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
UserChangeTeamRoleInput
UserError
UserInput
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 |
|---|---|
|
|
|
|
|
|
|
|
Example
"ACTIVE"
UserTeams
Users
UsersWithTeam
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 |
|---|---|
|
|
|
|
|
Example
"ORDER_STATUS_UPDATE"