Overview of the `account.updated` webhook

When an account.updated event is triggered, FastSpring sends a webhook payload containing updated buyer account details. This webhook is triggered when customer information changes. Updates may happen manually in the FastSpring app or automatically when an existing buyer places a new order using different contact or billing information.

This page includes:

A full sample payload for the account.updated webhook
A detailed table listing every payload property, including name, type, and description
Notes on when and how updated values appear in the payload

Webhook payload example

When an account.updated event is triggered, the webhook sends the following JSON payload:

{
    "id": "abcDEFgHiJklM1N-3OP9q",
    "account": "abcDEFgHiJklM1N-3OP9q",
    "contact": {
      "first": "Jane",
      "last": "Doe",
      "email": "jane.doe@example.com",
      "company": "Example Corp",
      "phone": "+1 5550001000",
      "subscribed": true
    },
    "address": {
      "address line 1": "123 Main St",
      "address line 2": "Suite 200",
      "city": "Santa Barbara",
      "country": "US",
      "postal code": "93101",
      "region": "US-CA",
      "region custom": "California",
      "company": "Example Corp"
    },
    "language": "en",
    "country": "US",
    "lookup": {
      "global": "ZxYwVuTsRqPoNmLk_JiHgF"
    },
    "url": "https://examplestore.test.onfastspring.com/account"
}

Navigate this webhook

The account.updated webhook payload includes details about changes made to an existing customer account. Use the links below to jump directly to a section of the property reference.

Payload properties

All fields below are included in the account.updated webhook payload. Fields are grouped into categories for easier navigation.

Name	Type	Description
Account Metadata
id	string	Unique FastSpring-generated identifier for the account
account	string	Duplicate of `id` for backward compatibility
changed	integer	Timestamp in milliseconds when the account was last updated
changedValue	integer	Duplicate of `changed` for backward compatibility
changedInSeconds	integer	Timestamp in seconds when the account was last updated
changedDisplay	string	User-friendly display of the last update date
changedDisplayISO8601	string	ISO 8601 formatted timestamp of the last update
changedDisplayEmailEnhancements	string	Email-friendly display of the last update date
changedDisplayEmailEnhancementsWithTime	string	Email-friendly display of the last update date with time
Contact Info
contact.first	string	First name of the account contact
contact.last	string	Last name of the account contact
contact.email	string	Email address of the account contact
contact.company	string	Company name associated with the contact, when provided
contact.phone	string	Phone number of the account contact, when provided
contact.subscribed	boolean	Whether the contact is subscribed to marketing communications
Address
address.address line 1	string	Primary street address line
address.address line 2	string	Secondary street address line
address.city	string	City of the account address
address.country	string	Two-letter ISO country code of the address
address.postal code	string	Postal or ZIP code of the account address
address.region	string	Region or state of the account address
address.region custom	string	Custom region name when not standard
address.company	string	Company name associated with the account address, when provided
Preferences
language	string	Two-letter ISO code for the customer’s preferred language
country	string	Two-letter ISO country code for the customer
Lookup and URLs
lookup.global	string	Globally unique public ID used to look up the account in customer-facing portals
url	string	Customer-facing account management URL