FastSpring AppAPI ReferenceWebhooksFastSpring JSChangelogFastSpring.com
Developer Documentation
Sign In

Edit Account Information

account.updated

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": "[email protected]",
      "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"
}

Payload properties

The payload properties table lists each field in the account.updated webhook payload, along with its name, type, and description.

Tip: Not all fields are always included. Some fields may return null or only appear when a specific type of update occurs.

Name Type Description
Account Metadata
id string Unique FastSpring-generated account ID. Matches the account field.
account string FastSpring-generated account ID (identical to id).
Contact Details
contact.first string Buyer's first name.
contact.last string Buyer's last name.
contact.email string Buyer's email address.
contact.company string Company name provided by the buyer, if any.
contact.phone string Buyer's phone number, if provided.
contact.subscribed boolean Indicates whether an account includes a subscription or not.
Address
address.address line 1 string Street address line 1 of the buyer's billing address.
address.address line 2 string Street address line 2 (apartment, suite, etc.).
address.city string City of the buyer's billing address.
address.country string Two-letter ISO country code of the billing address.
address.postal code string Postal or ZIP code of the billing address.
address.region string State, province, or region of the billing address (ISO format if available).
address.region custom string Free-form region value if region is not provided.
address.company string Company name associated with the billing address.
Localization
language string Two-letter ISO 639 language code associated with the buyer.
country string Two-letter 3166-1 alpha-2 country code associated with the buyer.
Account Access
lookup.global string Buyer-facing account ID used for login and account management.
url string URL to the buyer’s account management page.
Back to top ↑