New Accounts

account.created

Overview of the account.created webhook

When an account.created event is triggered, FastSpring sends a webhook payload containing details about a newly created buyer account. This event occurs when FastSpring processes an order associated with an unrecognized email

This page includes:

  • A full sample payload for the account.created webhook
  • A detailed table listing every payload property, including name, type, and description
  • Notes on optional fields and account-related metadata

Webhook payload example

When an account.created 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"
}

Navigate this webhook

The account.created webhook payload includes details about a newly created 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.created webhook payload. Fields are grouped into categories for easier navigation.

NameTypeDescription
Account Metadata
idstringUnique FastSpring-generated identifier for the account
accountstringDuplicate of id for backward compatibility
Contact Info
contact.firststringFirst name of the account contact
contact.laststringLast name of the account contact
contact.emailstringEmail address of the account contact
contact.companystringCompany name associated with the contact, when provided
contact.phonestringPhone number of the account contact, when provided
contact.subscribedbooleanWhether the contact is subscribed to marketing communications
Address
address.address line 1stringPrimary street address line
address.address line 2stringSecondary street address line
address.citystringCity of the account address
address.countrystringTwo-letter ISO country code of the address
address.postal codestringPostal or ZIP code of the account address
address.regionstringRegion or state of the account address
address.region customstringCustom region name when not standard
address.companystringCompany name associated with the account address, when provided
Preferences
languagestringTwo-letter ISO code for the customer’s preferred language
countrystringTwo-letter ISO country code for the customer
Lookup and URLs
lookup.globalstringGlobally unique public ID used to look up the account in customer-facing portals
urlstringCustomer-facing account management URL