Webhooks

Customer Organisation Created

Webhook event fired when a new customer organisation is created in Phasio

Overview

The Customer Organisation Created event fires when a new customer organisation is registered in your Phasio account. Customer organisations represent companies or entities that place orders with you.

When it triggers

This webhook fires when:

  • A new customer organisation is created through the platform, either by the manufacturer or through customer self-registration.

Payload

The decrypted payload is a JSON object with the following fields:

FieldTypeNullableDescription
idnumberNoUnique identifier for the customer organisation.
namestringNoName of the organisation (e.g., "Acme Manufacturing").
taxNumberstringNoTax identification number (e.g., VAT number). Empty string if not set.
languagestringNoPreferred language code (e.g., "en", "de", "fr").
customersarrayNoList of individual customers belonging to this organisation. See Customer object.
addressesarrayNoList of addresses associated with the organisation. See Address object.
isTaxExemptbooleanNoWhether the organisation is exempt from tax.
isApprovedbooleanNoWhether the organisation has been approved by the manufacturer.
createdAtstringNoISO 8601 date-time when the organisation was created (e.g., "2025-01-10T08:00:00").
lastUpdatedOnstringNoISO 8601 date-time when the organisation was last modified.

Customer object

Each item in the customers array represents an individual contact within the organisation:

FieldTypeNullableDescription
idnumberNoUnique identifier for the customer.
emailstringYesEmail address of the customer.
phoneNumberstringYesPhone number of the customer.
firstNamestringYesFirst name of the customer.
lastNamestringYesLast name of the customer.
notificationPreferencestringNoHow the customer prefers to receive notifications (e.g., "EMAIL", "SMS", "WHATSAPP").

Address object

Each item in the addresses array:

FieldTypeNullableDescription
idstringYesAddress identifier.
street1stringYesPrimary street address.
street2stringYesSecondary street address (suite, unit, etc.).
citystringYesCity name.
statestringYesState or province.
countrystringYesISO 3166-1 country code (e.g., "US", "DE").
zipstringYesPostal/ZIP code.
namestringYesLocation or recipient name.
phonestringYesContact phone number.
emailstringYesContact email address.
residentialbooleanNoWhether this is a residential address.

Example payload

{
  "id": 678,
  "name": "Acme Manufacturing",
  "taxNumber": "US123456789",
  "language": "en",
  "customers": [
    {
      "id": 1,
      "email": "john@acme.com",
      "phoneNumber": "+1-555-0100",
      "firstName": "John",
      "lastName": "Doe",
      "notificationPreference": "EMAIL"
    }
  ],
  "addresses": [
    {
      "id": "addr-001",
      "street1": "123 Industrial Ave",
      "street2": null,
      "city": "Austin",
      "state": "TX",
      "country": "US",
      "zip": "73301",
      "name": "Headquarters",
      "phone": "+1-555-0100",
      "email": "info@acme.com",
      "residential": false
    }
  ],
  "isTaxExempt": false,
  "isApproved": true,
  "createdAt": "2025-01-10T08:00:00",
  "lastUpdatedOn": "2025-01-10T08:00:00"
}

Last updated on