FastSpring AppAPI ReferenceWebhooksFastSpring JSChangelogFastSpring.com
Developer Documentation
Sign In

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"
}

Payload properties

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

Tip: Not all fields are always included. Some fields may return null or be omitted depending on the buyer’s input or data available at the time of account creation.

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 ↑