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:
| Field | Type | Nullable | Description |
|---|---|---|---|
id | number | No | Unique identifier for the customer organisation. |
name | string | No | Name of the organisation (e.g., "Acme Manufacturing"). |
taxNumber | string | No | Tax identification number (e.g., VAT number). Empty string if not set. |
language | string | No | Preferred language code (e.g., "en", "de", "fr"). |
customers | array | No | List of individual customers belonging to this organisation. See Customer object. |
addresses | array | No | List of addresses associated with the organisation. See Address object. |
isTaxExempt | boolean | No | Whether the organisation is exempt from tax. |
isApproved | boolean | No | Whether the organisation has been approved by the manufacturer. |
createdAt | string | No | ISO 8601 date-time when the organisation was created (e.g., "2025-01-10T08:00:00"). |
lastUpdatedOn | string | No | ISO 8601 date-time when the organisation was last modified. |
Customer object
Each item in the customers array represents an individual contact within the organisation:
| Field | Type | Nullable | Description |
|---|---|---|---|
id | number | No | Unique identifier for the customer. |
email | string | Yes | Email address of the customer. |
phoneNumber | string | Yes | Phone number of the customer. |
firstName | string | Yes | First name of the customer. |
lastName | string | Yes | Last name of the customer. |
notificationPreference | string | No | How the customer prefers to receive notifications (e.g., "EMAIL", "SMS", "WHATSAPP"). |
Address object
Each item in the addresses array:
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | Yes | Address identifier. |
street1 | string | Yes | Primary street address. |
street2 | string | Yes | Secondary street address (suite, unit, etc.). |
city | string | Yes | City name. |
state | string | Yes | State or province. |
country | string | Yes | ISO 3166-1 country code (e.g., "US", "DE"). |
zip | string | Yes | Postal/ZIP code. |
name | string | Yes | Location or recipient name. |
phone | string | Yes | Contact phone number. |
email | string | Yes | Contact email address. |
residential | boolean | No | Whether 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