> For the complete documentation index, see [llms.txt](https://developer.firmhouse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.firmhouse.com/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/mutations/update-address-details.md). # updateAddressDetails 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. ### Arguments | Argument | Description | | --------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | | input ([UpdateAddressDetailsInput](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/update-address-details-input.md)!) | Parameters for UpdateAddressDetails | ### UpdateAddressDetailsInput Arguments | Argument | Description | | ---------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | metadata ([JSON](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/json.md)) | Metadata that can be used by developers to store additional information on objects. | | token ([ID](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/id.md)) | The token of the subscription to update, or creates a new one if one doesn't exist. | | companyName ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The company name of the customer. | | vatNumber ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The company VAT number. | | salutation ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's salutation (mr,ms,mx). | | name ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's first name. | | lastName ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's last name. | | address ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's address line or street. | | zipcode ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's zip code or postal code. | | houseNumber ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's house, building, or appartment number. | | city ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's city or town. | | country ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's country code (ISO3661). | | state ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's state or province (ISO3661-2). | | district ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's district. | | phoneNumber ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's phone number (international format). | | dateOfBirth ([ISO8601Date](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/iso-8601-date.md)) | The customer's date of birth (yyyy-mm-dd). | | differentBillingAddress ([Boolean](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/boolean.md)) | Whether billing and shipping addresses are the same. Set this flag to \`true\` to store a separate billing address. | | billToCompanyName ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The company name of the customer's billing address. | | billToSalutation ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's billing address salutation (mr,ms,mx). | | billToName ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's billing address first name. | | billToLastName ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's billing address last name. | | billToAddress ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's billing address address line or street. | | billToZipcode ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's billing address zip code or postal code. | | billToHouseNumber ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's billing address house, building, or appartment number. | | billToCity ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's billing address city or town. | | billToCountry ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's billing address country code (ISO3661). | | billToState ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's billing address state or province (ISO3661-2). | | billToDistrict ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's billing address district. | | billToPhoneNumber ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's billing address phone number (international format). | | email ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's email address. | | termsAccepted ([Boolean](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/boolean.md)) | Whether the customer accepted the terms and conditions. | | marketingOptIn ([Boolean](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/boolean.md)) | Whether the customer accepted optional marketing communication opt-in. | | extraFields (\[[ExtraFieldInput](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/extra-field-input.md)!]) | Extra field values for the subscription. | | locale ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The customer's language/locale. Must be enabled on the project. | | skipAutoActivationOnSignup ([Boolean](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/boolean.md)) | Don't automatically activate the subscription on signup. | | chargeDayOfTheMonth ([Int](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/int.md)) | The day of the month when the customer is charged. | | trialPeriodMonths ([Int](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/int.md)) | The number of months before the customer is charged for the first time. | | customerReference ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The field that can be used for your internal reference. For example, internal customer id. | | status ([SubscriptionStatus](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/subscription-status.md)) | The current status of the subscription. (default: inactive) | | signupCompletedAt ([ISO8601DateTime](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/iso-8601-date-time.md)) | The time when the signup was completed. | | activatedAt ([ISO8601DateTime](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/iso-8601-date-time.md)) | The time the subscription was activated. | | cancelledAt ([ISO8601DateTime](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/iso-8601-date-time.md)) | The time the subscription was (fully) cancelled. | | cancellationStartedAt ([ISO8601DateTime](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/iso-8601-date-time.md)) | The time the subscription started the cancellation process (with two-step cancellation) | | markedAsNonPayingAt ([ISO8601DateTime](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/iso-8601-date-time.md)) | Time time the subscription was marked as non-paying. | | mollieCustomerId ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The Mollie Customer ID (cst\_XXX) | | stripeCustomerId ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The Stripe Customer ID (cus\_XXX) | | stripePaymentMethodId ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The Stripe Payment Method ID of the active payment method to charge. (pm\_XXX) | | adyenShopperReference ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | The Adyen shopper reference being used for charges. | | importedSubscriptionId ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | Unique ID for an imported subscription. | | notes ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)) | Notes specific for this subscription | | pspPaymentProperties ([JSON](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/json.md)) | Additional payment service provider specific properties used for payment creation. | | serviceChannelId ([ID](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/id.md)) | The ID of the service channel to use for this subscription. | ### Return fields #### errors (\[[ModelValidationError](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/model-validation-error.md)!]!) #### subscription ([Subscription](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/subscription.md)!)