---
title: SubscriptionActor - GraphQL Admin
description: The actor who initiated a subscription action.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/enums/SubscriptionActor'
  md: 'https://shopify.dev/docs/api/admin-graphql/latest/enums/SubscriptionActor.md'
api_name: admin
api_type: graphql
type: enum
---

# Subscription​Actor

enum

The actor who initiated a subscription action.

## Valid values

* CUSTOMER

  The subscription action was initiated by a customer.

* MERCHANT

  The subscription action was initiated by a merchant.

* PARTNER

  The subscription action was initiated by a partner.

***

## Fields

* [Subscription​Billing​Attempt​Input.actor](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionBillingAttemptInput#fields-actor)

  INPUT OBJECT

  The input fields required to complete a subscription billing attempt.

* [Subscription​Contract​Atomic​Create​Input.actor](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractAtomicCreateInput#fields-actor)

  INPUT OBJECT

  The input fields required to create a Subscription Contract.

* [Subscription​Contract​Calculation​Contract​Create​Input.actor](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationContractCreateInput#fields-actor)

  INPUT OBJECT

  The input fields for calculating a new subscription contract. Provide the complete desired state of the contract. The contract isn't created until you commit the calculation with the [`subscriptionContractCalculationCommit`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCalculationCommit) mutation.

  Learn how to [build a subscription contract](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/build-a-subscription-contract).

* [Subscription​Contract​Create​Input.actor](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCreateInput#fields-actor)

  INPUT OBJECT

  The input fields required to create a Subscription Contract.

* [subscription​Billing​Cycle​Bulk​Charge.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleBulkCharge#arguments-actor)

  ARGUMENT

* [subscription​Billing​Cycle​Charge.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleCharge#arguments-actor)

  ARGUMENT

* [subscription​Billing​Cycle​Contract​Edit.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleContractEdit#arguments-actor)

  ARGUMENT

* [subscription​Billing​Cycle​Contract​Edit​Calculate.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleContractEditCalculate#arguments-actor)

  ARGUMENT

* [subscription​Contract​Activate.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractActivate#arguments-actor)

  ARGUMENT

* [subscription​Contract​Cancel.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCancel#arguments-actor)

  ARGUMENT

* [subscription​Contract​Expire.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractExpire#arguments-actor)

  ARGUMENT

* [subscription​Contract​Fail.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractFail#arguments-actor)

  ARGUMENT

* [subscription​Contract​Pause.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractPause#arguments-actor)

  ARGUMENT

* [subscription​Contract​Product​Change.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractProductChange#arguments-actor)

  ARGUMENT

* [subscription​Contract​Update.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractUpdate#arguments-actor)

  ARGUMENT

* [subscription​Contract​Update​Calculate.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractUpdateCalculate#arguments-actor)

  ARGUMENT

***

## Map

### Inputs with this enum

* [Subscription​Billing​Attempt​Input.actor](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionBillingAttemptInput#fields-actor)
* [Subscription​Contract​Atomic​Create​Input.actor](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractAtomicCreateInput#fields-actor)
* [Subscription​Contract​Calculation​Contract​Create​Input.actor](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationContractCreateInput#fields-actor)
* [Subscription​Contract​Create​Input.actor](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCreateInput#fields-actor)

### Arguments with this enum

* [subscription​Billing​Cycle​Bulk​Charge.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleBulkCharge#arguments-actor)
* [subscription​Billing​Cycle​Charge.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleCharge#arguments-actor)
* [subscription​Billing​Cycle​Contract​Edit.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleContractEdit#arguments-actor)
* [subscription​Billing​Cycle​Contract​Edit​Calculate.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleContractEditCalculate#arguments-actor)
* [subscription​Contract​Activate.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractActivate#arguments-actor)
* [subscription​Contract​Cancel.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCancel#arguments-actor)
* [subscription​Contract​Expire.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractExpire#arguments-actor)
* [subscription​Contract​Fail.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractFail#arguments-actor)
* [subscription​Contract​Pause.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractPause#arguments-actor)
* [subscription​Contract​Product​Change.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractProductChange#arguments-actor)
* [subscription​Contract​Update.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractUpdate#arguments-actor)
* [subscription​Contract​Update​Calculate.actor](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractUpdateCalculate#arguments-actor)