The Firmhouse Logo [FH]
Developer Docs

Mutation

The Firmhouse GraphQL API mutations root object.

Fields

activateSubscription (ActivateSubscriptionPayload)
Activates an inactive subscription.
ArgumentDescription
input (ActivateSubscriptionInput!)
Parameters for ActivateSubscription
applyPromotionToSubscription (ApplyPromotionToSubscriptionPayload)
Applies a promotion to a subscription.
ArgumentDescription
input (ApplyPromotionToSubscriptionInput!)
Parameters for ApplyPromotionToSubscription
assignAsset (AssignAssetPayload)
Assign asset to a subscription.
ArgumentDescription
input (AssignAssetInput!)
Parameters for AssignAsset
cancelReturnOrder (CancelReturnOrderPayload)
Cancels an 'in progress' return order.
ArgumentDescription
input (CancelReturnOrderInput!)
Parameters for CancelReturnOrder
cancelSubscription (CancelSubscriptionPayload)
Cancels a subscription or initiates cancellation when two-step cancellation is enabled on your project.
ArgumentDescription
input (CancelSubscriptionInput!)
Parameters for CancelSubscription
completeReturnOrder (CompleteReturnOrderPayload)
Completes an 'in progress' return order.
ArgumentDescription
input (CompleteReturnOrderInput!)
Parameters for CompleteReturnOrder
completeSubscriptionCancellation (CompleteSubscriptionCancellationPayload)
Completes the subscription cancellation process (only available when two-step cancellation is enabled on your project).
ArgumentDescription
input (CompleteSubscriptionCancellationInput!)
Parameters for CompleteSubscriptionCancellation
createAsset (CreateAssetPayload)
Creates an asset for a product, optionally assigns it to a subscription.
ArgumentDescription
input (CreateAssetInput!)
Parameters for CreateAsset
createCart (CreateCartPayload)
Creates an empty draft/cart subscription.
ArgumentDescription
input (CreateCartInput!)
Parameters for CreateCart
createDiscountCode (CreateDiscountCodePayload)
Creates a discount code
ArgumentDescription
input (CreateDiscountCodeInput!)
Parameters for CreateDiscountCode
createInvoiceLineItem (CreateInvoiceLineItemPayload)
Creates an invoice line item for an invoice.
ArgumentDescription
input (CreateInvoiceLineItemInput!)
Parameters for CreateInvoiceLineItem
createInvoicedOneTimeCharge (CreateInvoicedOneTimeChargePayload)
Immediately charges and invoices the given amount. If initiating the charge succeeds, an invoice is also created. When initiating the charge fails, no invoice is created. It's possible that the payment and invoice status are open or pending until a final succesful payment status is received from your Payment Service Provider. This could take a couple of business days for certain payment methods, like SEPA direct debit.
ArgumentDescription
input (CreateInvoicedOneTimeChargeInput!)
Parameters for CreateInvoicedOneTimeCharge
createOrder (CreateOrderPayload)
Deprecated: The behavior of this mutation will be changed significantly soon.
ArgumentDescription
input (CreateOrderInput!)
Parameters for CreateOrder
createOrderedProduct (CreateOrderedProductPayload)
Deprecated: Use CreateOrderedProductV2 instead.
ArgumentDescription
input (CreateOrderedProductInput!)
Parameters for CreateOrderedProduct
createOrderedProductV2 (CreateOrderedProductV2Payload)
Creates an ordered product on subscription identified via `X-Subscription-Token` or `X-Project-Access-Token`.
ArgumentDescription
input (CreateOrderedProductV2Input!)
Parameters for CreateOrderedProductV2
createProduct (CreateProductPayload)
Creates a product.
ArgumentDescription
input (CreateProductInput!)
Parameters for CreateProduct
createPromotion (CreatePromotionPayload)
Creates a promotion.
ArgumentDescription
input (CreatePromotionInput!)
Parameters for CreatePromotion
createReturnOrder (CreateReturnOrderPayload)
Creates a return order for the subscription.
ArgumentDescription
input (CreateReturnOrderInput!)
Parameters for CreateReturnOrder
createSelfServiceCenterLoginToken (CreateSelfServiceCenterLoginTokenPayload)
Deprecated: This mutation is deprecated. If you would like to send an email with a link to the self service center, please use the `sendSelfServiceCenterLoginTokenEmail` mutation. If you need to create and access a SelfServiceCenterLoginToken without sending an email, please use the `createSelfServiceCenterLoginTokenV2` mutation.
Creates a SelfServiceCenterLoginToken and sends an email to the customer's email address on file so they can log into their self service center.
ArgumentDescription
input (CreateSelfServiceCenterLoginTokenInput!)
Parameters for CreateSelfServiceCenterLoginToken
createSelfServiceCenterLoginTokenV2 (CreateSelfServiceCenterLoginTokenV2Payload)
Creates and returns a SelfServiceCenterLoginToken.
ArgumentDescription
input (CreateSelfServiceCenterLoginTokenV2Input!)
Parameters for CreateSelfServiceCenterLoginTokenV2
createServiceChannel (CreateServiceChannelPayload)
Creates a service channel.
ArgumentDescription
input (CreateServiceChannelInput!)
Parameters for CreateServiceChannel
createSubscription (CreateSubscriptionPayload)
Creates a new subscription and returns payment redirection URLs.
ArgumentDescription
input (CreateSubscriptionInput!)
Parameters for CreateSubscription
createSubscriptionFromCart (CreateSubscriptionFromCartPayload)
Finalises a subscription and returns payment details based on a cart/draft subscription identified by `X-Subscription-Token`.
ArgumentDescription
input (CreateSubscriptionFromCartInput!)
Parameters for CreateSubscriptionFromCart
creditAndRefundInvoice (CreditAndRefundInvoicePayload)
Immediately creates a credit invoice and a tries to create a refund for the full amount of the original invoice. If initiating the refund fails, a refundError will be returned but the credit invoice would be created nevertheless. It's possible that the refund status are open or pending until a final succesful payment status is received from your Payment Service Provider. This could take a couple of business days for certain payment methods, like SEPA direct debit.
ArgumentDescription
input (CreditAndRefundInvoiceInput!)
Parameters for CreditAndRefundInvoice
deactivateAppliedPromotion (DeactivateAppliedPromotionPayload)
Deactivates an applied promotion.
ArgumentDescription
input (DeactivateAppliedPromotionInput!)
Parameters for DeactivateAppliedPromotion
destroyInvoiceLineItem (DestroyInvoiceLineItemPayload)
Destroys an invoice line item.
ArgumentDescription
input (DestroyInvoiceLineItemInput!)
Parameters for DestroyInvoiceLineItem
destroyOrderedProduct (DestroyOrderedProductPayload)
Deletes an ordered product from the subscription identified via `X-Subscription-Token` or when authenticated through a project write token.
ArgumentDescription
input (DestroyOrderedProductInput!)
Parameters for DestroyOrderedProduct
editPlan (EditPlanPayload)
Edits a plan.
ArgumentDescription
input (EditPlanInput!)
Parameters for EditPlan
fulfillOrder (FulfillOrderPayload)
Marks an order as fulfilled. If Track&Trace code is given in will also trigger Track&Trace email.
ArgumentDescription
input (FulfillOrderInput!)
Parameters for FulfillOrder
fulfillOrders (FulfillOrdersPayload)
Option to mark multiple orders as fulfilled at once, up to a maximum of 100 orders each time.
ArgumentDescription
input (FulfillOrdersInput!)
Parameters for FulfillOrders
importSubscription (ImportSubscriptionPayload)
Creates a subscription directly into the database without the need for a customer to signup, only use this when you're migrating from another platform.
ArgumentDescription
input (ImportSubscriptionInput!)
Parameters for ImportSubscription
pauseSubscription (PauseSubscriptionPayload)
Pauses a subscription. You can optionally pass in a time at which the subscription will be resumed. All automatic charging and invoice generation and order generation is put on hold for a paused subscription. Maximum contract terms automatically shift forward on each billing cycle.
ArgumentDescription
input (PauseSubscriptionInput!)
Parameters for PauseSubscription
refundPayment (RefundPaymentPayload)
Issues a refund for a payment. Some payment service providers may limit the maximum amount for or timeframe in which you can refund a payment.
ArgumentDescription
input (RefundPaymentInput!)
Parameters for RefundPayment
resumeSubscription (ResumeSubscriptionPayload)
Resumes the subscription. If you do not pass a date or time the resumeFrom argument, then the subscription will be immediately resumed. Resuming a subscription will always change its status to **activated**.
ArgumentDescription
input (ResumeSubscriptionInput!)
Parameters for ResumeSubscription
sendSelfServiceCenterLoginTokenEmail (SendSelfServiceCenterLoginTokenEmailPayload)
Creates a SelfServiceCenterLoginToken and sends an email to the customer's email address on file so they can log into their self service center.
ArgumentDescription
input (SendSelfServiceCenterLoginTokenEmailInput!)
Parameters for SendSelfServiceCenterLoginTokenEmail
shipOrderedProducts (ShipOrderedProductsPayload)
Immediately creates an order for the passed ordered products of the subscription. Any other ordered products of this subscription scheduled for today will also be shipped in the same order.
ArgumentDescription
input (ShipOrderedProductsInput!)
Parameters for ShipOrderedProducts
switchSubscriptionPlan (SwitchSubscriptionPlanPayload)
Initiates a plan switch offer for subscription.
ArgumentDescription
input (SwitchSubscriptionPlanInput!)
Parameters for SwitchSubscriptionPlan
syncShopifyProducts (SyncShopifyProductsPayload)
Syncs products from Shopify to Firmhouse.
ArgumentDescription
input (SyncShopifyProductsInput!)
Parameters for SyncShopifyProducts
unassignAsset (UnassignAssetPayload)
Unassign asset from a subscription, this will mark the asset ownership as returned.
ArgumentDescription
input (UnassignAssetInput!)
Parameters for UnassignAsset
undoSubscriptionCancellation (UndoSubscriptionCancellationPayload)
Stops the subscription cancellation process (only available when two-step cancellation is enabled on your project).
ArgumentDescription
input (UndoSubscriptionCancellationInput!)
Parameters for UndoSubscriptionCancellation
updateAddressDetails (UpdateAddressDetailsPayload)
Updates certain information on the subscription identified via `X-Subscription-Token`. Will save changes to certain fields even when other fields given are invalid. Will return validation error messages for invalid fields.
ArgumentDescription
input (UpdateAddressDetailsInput!)
Parameters for UpdateAddressDetails
updateAppliedPromotion (UpdateAppliedPromotionPayload)
Updates a promotion applied to a Subscription
ArgumentDescription
input (UpdateAppliedPromotionInput!)
Parameters for UpdateAppliedPromotion
updateAsset (UpdateAssetPayload)
Update an asset.
ArgumentDescription
input (UpdateAssetInput!)
Parameters for UpdateAsset
updateAssetOwnership (UpdateAssetOwnershipPayload)
Updates an asset ownership.
ArgumentDescription
input (UpdateAssetOwnershipInput!)
Parameters for UpdateAssetOwnership
updateInvoice (UpdateInvoicePayload)
Updates an invoice.
ArgumentDescription
input (UpdateInvoiceInput!)
Parameters for UpdateInvoice
updateInvoiceLineItem (UpdateInvoiceLineItemPayload)
Updates an invoice line item.
ArgumentDescription
input (UpdateInvoiceLineItemInput!)
Parameters for UpdateInvoiceLineItem
updateOrder (UpdateOrderPayload)
Updates Order attributes. Only status, fulfilledAt timestamp, and trackingCode are allowed to be updated. Fulfillment process will not be triggered.
ArgumentDescription
input (UpdateOrderInput!)
Parameters for UpdateOrder
updateOrderedProduct (UpdateOrderedProductPayload)
Updates the ordered product on a subscription identified via `X-Subscription-Token`.
ArgumentDescription
input (UpdateOrderedProductInput!)
Parameters for UpdateOrderedProduct
updateOrderedProductQuantity (UpdateOrderedProductQuantityPayload)
Updates an ordered product's quantity identified via `X-Subscription-Token`.
ArgumentDescription
input (UpdateOrderedProductQuantityInput!)
Parameters for UpdateOrderedProductQuantity
updatePlan (UpdatePlanPayload)
Updates the active plan of the subscription identified via `X-Subscription-Token`.
ArgumentDescription
input (UpdatePlanInput!)
Parameters for UpdatePlan
updateProduct (UpdateProductPayload)
Updates a product.
ArgumentDescription
input (UpdateProductInput!)
Parameters for UpdateProduct
updatePromotion (UpdatePromotionPayload)
Updates a promotion.
ArgumentDescription
input (UpdatePromotionInput!)
Parameters for UpdatePromotion
updateReturnOrder (UpdateReturnOrderPayload)
Updates an 'in progress' return order.
ArgumentDescription
input (UpdateReturnOrderInput!)
Parameters for UpdateReturnOrder
updateShippingCostsExemption (UpdateShippingCostsExemptionPayload)
Updates the shipping costs exemption.
ArgumentDescription
input (UpdateShippingCostsExemptionInput!)
Parameters for UpdateShippingCostsExemption
updateSubscribedPlan (UpdateSubscribedPlanPayload)
Updates the subscribed plan.
ArgumentDescription
input (UpdateSubscribedPlanInput!)
Parameters for UpdateSubscribedPlan
updateSubscription (UpdateSubscriptionPayload)
Updates a subscription.
ArgumentDescription
input (UpdateSubscriptionInput!)
Parameters for UpdateSubscription