organization
post
/ccadmin/v1/webhook/organization
The metadata for create/update account webhook.
Request
Supported Media Types
- application/json
The metadata for create/update account webhook.
Root Schema : organization_request
Type:
object
The metadata for create/update account webhook.
Show Source
Example:
{
"organization":{
"taxReferenceNumber":"678",
"siteOrganizationProperties":[
],
"organizationLogo":"/general/hero-image1.jpg",
"description":"Test Account Description",
"delegateApprovalManagement":false,
"secondaryAddresses":[
],
"parentOrganization":null,
"type":"company",
"derivedBillingAddress":null,
"derivedUniqueId":"123",
"customerType":"Standard",
"derivedShippingMethods":[
],
"organizationLogoURL":"/file/v4724513249321774435/general/hero-image1.jpg",
"derivedContract":null,
"paymentMethods":[
],
"members":[
],
"id":"or-300007",
"relativeRoles":[
{
"function":"admin",
"repositoryId":"400001"
},
{
"function":"buyer",
"repositoryId":"400002"
},
{
"function":"approver",
"repositoryId":"400003"
},
{
"function":"accountAddressManager",
"repositoryId":"400004"
},
{
"function":"profileAddressManager",
"repositoryId":"400005"
}
],
"dunsNumber":"123456789",
"shippingMethods":[
],
"derivedDunsNumber":"123456789",
"derivedTaxReferenceNumber":"678",
"derivedUseAllPaymentMethodsFromSite":null,
"contract":null,
"derivedCustomerType":"Standard",
"active":true,
"derivedOrganizationLogo":"/general/hero-image1.jpg",
"allSecondaryAddresses":{
},
"taxExemptionCode":null,
"vatReferenceNumber":"34567",
"orderPriceLimit":null,
"derivedShippingAddress":null,
"derivedType":"company",
"useAllShippingMethodsFromSite":null,
"derivedUseAllShippingMethodsFromSite":null,
"derivedTaxExemptionCode":null,
"useAllPaymentMethodsFromSite":null,
"approvalRequired":false,
"derivedPaymentMethods":[
],
"derivedVatReferenceNumber":"34567",
"name":"TestAccount",
"shippingAddress":null,
"ancestorOrganizations":[
],
"useExternalApprovalWebhook":false,
"billingAddress":null,
"derivedDescription":"Test Account Description",
"uniqueId":"123"
}
}
Nested Schema : organization
Type:
Show Source
object
-
active(optional):
boolean
Active status of an Organization. Should be true or false. By default the value is set to true
-
allSecondaryAddressesIsTruncated(optional):
boolean
This property will be added to the webhook payload only if the corresponding allSecondaryAddresses property is truncated. The value for this field will be true always if present
-
ancestorOrganizations(optional):
array ancestorOrganizations
The ancestor organizations
-
approvalRequired(optional):
boolean
Whether approval is required
-
billingAddress(optional):
object billingAddress
Default billing address of the Organization
-
contract(optional):
object contract
The contract information associated with this account
-
customerType(optional):
string
Customer Type for Organization
-
delegateApprovalManagement(optional):
boolean
Whether to delegate approval management
-
derivedBillingAddress(optional):
object derivedBillingAddress
The derived default billing address for the Organization. This a read only attribute. This will come if property 'isDefaultBillingAddress' is set to 'true' in secondaryAddresses attribute or if parent has default billing address.
-
derivedContract(optional):
object derivedContract
Derived Contract
-
derivedCustomerType(optional):
string
Derived Customer type of the Organization
-
derivedDescription(optional):
string
The description of the Organization
-
derivedDunsNumber(optional):
string
Derived dunsNumber of the Organization
-
derivedOrganizationLogo(optional):
string
Derived organizationLogo of the Organization
-
derivedOrganizationLogoURL(optional):
string
The organization logo URL
-
derivedShippingAddress(optional):
object derivedShippingAddress
The derived default shipping address for the Organization. This a read only attribute. This will come if property 'isDefaultShippingAddress' is set to 'true' in secondaryAddresses attribute or if parent has default shipping address.
-
derivedTaxExemptionCode(optional):
string
Derived taxExemptionCode of the Organization
-
derivedTaxReferenceNumber(optional):
string
Derived taxReferenceNumber of the Organization
-
derivedType(optional):
string
Derived type of the Organization
-
derivedUniqueId(optional):
string
Derived unique Id of the Organization
-
derivedVatReferenceNumber(optional):
string
Derived VatReferenceNumber of the Organization
-
description(optional):
string
Description for Organization
-
dunsNumber(optional):
string
DUNS Number for Organization.
-
externalOrganizationId(optional):
string
External id of the organization.
-
id(optional):
string
Id of the Organization
-
members(optional):
array members
Primary contact details associated with an organization. The secondary contacts will not be included in the payload. The REST endpoint can be used to fetch the secondary members
-
name(optional):
string
The name for Organization
-
orderPriceLimit(optional):
string
Order price limit of the account
-
organizationLogo(optional):
string
File path of organization logo.
-
organizationLogoURL(optional):
string
Full URL of organization logo.
-
parentOrganization(optional):
object parentOrganization
Parent organization Info.
-
paymentMethods(optional):
array paymentMethods
Payment methods associated for organization.
-
relativeRoles(optional):
array relativeRoles
The relative roles
-
repositoryId(optional):
string
Repository Id of the Organization
-
secondaryAddresses(optional):
array secondaryAddresses
List of addresses associated with an Organization. This property will be removed from the webhook request payload if the size exceeds the sub entity truncation size value configured for this webhook
-
secondaryAddressesIsTruncated(optional):
boolean
This property will be added to the webhook payload only if the corresponding secondaryAddresses property is truncated. The value for this field will be true always if present
-
secondaryMembers(optional):
array secondaryMembers
List of users with this organization as secondary organization
-
shippingAddress(optional):
object shippingAddress
Default shipping address of the Organization
-
shippingMethods(optional):
array shippingMethods
Shipping methods associated for organization. This property will be removed from the webhook payload only if includeChangesOnly property is set to true for a specific webhook.
-
siteOrganizationProperties(optional):
array siteOrganizationProperties
The site organization properties of the account
-
taxExemptionCode(optional):
string
Tax exemption code for Organization
-
taxReferenceNumber(optional):
string
Tax Reference number for Organization
-
type(optional):
string
Type for Organization
-
uniqueId(optional):
string
Unique Id of the Organization
-
useAllPaymentMethodsFromSite(optional):
boolean
Flag to use all the payment methods available for site.
-
useAllShippingMethodsFromSite(optional):
string
Flag to use all the shipping methods available for site.
-
useExternalApprovalWebhook(optional):
boolean
Whether to trigger order approval webhook
-
vatReferenceNumber(optional):
string
Vat reference number for the organization
Nested Schema : billingAddress
Type:
object
Default billing address of the Organization
Show Source
-
address1(optional):
string
the address1 of the address
-
address2(optional):
string
the address2 of the address
-
address3(optional):
string
the address3 of the address
-
city(optional):
string
the city of the address
-
companyName(optional):
string
the company name of the address
-
country(optional):
string
the country of the address
-
externalAddressId(optional):
string
External ID of the address
-
phoneNumber(optional):
string
the phone Number of the address
-
postalCode(optional):
string
the postal Code of the address
-
repositoryId(optional):
string
Repository Id of the address
-
state(optional):
string
the state of the address
Nested Schema : contract
Type:
object
The contract information associated with this account
Show Source
-
catalog(optional):
object catalog
The catalog information
-
creationDate(optional):
string
The date of creation
-
derivedDescription(optional):
string
Derived description of the Organization
-
description(optional):
string
The description of contract
-
displayName(optional):
string
The name of contract
-
endDate(optional):
string
The end date of contract
-
externalContractReference(optional):
string
The external contract reference of contract
-
priceListGroup(optional):
object priceListGroup
The price list group information
-
repositoryId(optional):
string
The repository Id of contract
-
startDate(optional):
string
The start date of the contract
-
terms(optional):
object terms
Terms and Conditions
Nested Schema : derivedBillingAddress
Type:
object
The derived default billing address for the Organization. This a read only attribute. This will come if property 'isDefaultBillingAddress' is set to 'true' in secondaryAddresses attribute or if parent has default billing address.
Show Source
-
address1(optional):
string
the address1 of the address
-
address2(optional):
string
the address2 of the address
-
city(optional):
string
the city of the address
-
companyName(optional):
string
the company name of the address
-
country(optional):
string
the country of the address
-
externalAddressId(optional):
string
External ID of the address
-
phoneNumber(optional):
string
the phone Number of the address
-
postalCode(optional):
string
the postal Code of the address
-
repositoryId(optional):
string
Repository Id of the address
-
state(optional):
string
the state of the address
Nested Schema : derivedContract
Type:
object
Derived Contract
Show Source
-
catalog(optional):
object catalog
Catalog associated with contract
-
creationDate(optional):
string
Contract creation date time stamp
-
description(optional):
string
Description for contract
-
displayName(optional):
string
Display name for contract
-
endDate(optional):
string
Contract end date time stamp
-
externalContractReference(optional):
string
External contract reference
-
priceListGroup(optional):
object priceListGroup
Price ListGroup associated with contract
-
repositoryId(optional):
string
Repository Id of the contract
-
startDate(optional):
string
Contract start date time stamp
-
terms(optional):
object terms
Terms and Conditions
Nested Schema : derivedShippingAddress
Type:
object
The derived default shipping address for the Organization. This a read only attribute. This will come if property 'isDefaultShippingAddress' is set to 'true' in secondaryAddresses attribute or if parent has default shipping address.
Show Source
-
address1(optional):
string
the address1 of the address
-
address2(optional):
string
the address2 of the address
-
city(optional):
string
the city of the address
-
companyName(optional):
string
the company name shipping address
-
country(optional):
string
the country of the address
-
externalAddressId(optional):
string
External ID of the address
-
phoneNumber(optional):
string
the phone Number of the company address
-
postalCode(optional):
string
the postal Code of the address
-
repositoryId(optional):
string
repository Id of the address
-
state(optional):
string
the state of the address
Nested Schema : members
Type:
array
Primary contact details associated with an organization. The secondary contacts will not be included in the payload. The REST endpoint can be used to fetch the secondary members
Show Source
Nested Schema : parentOrganization
Type:
object
Parent organization Info.
Show Source
-
active(optional):
boolean
Active flag of the parent Organization.
-
externalOrganizationId(optional):
string
External id of the organization.
-
id(optional):
string
Id of the parent Organization.
-
name(optional):
string
Name of the parent organization.
-
repositoryId(optional):
string
Repository Id of the parent organization.
Nested Schema : secondaryAddresses
Type:
array
List of addresses associated with an Organization. This property will be removed from the webhook request payload if the size exceeds the sub entity truncation size value configured for this webhook
Show Source
Nested Schema : secondaryMembers
Type:
array
List of users with this organization as secondary organization
Show Source
Nested Schema : shippingAddress
Type:
object
Default shipping address of the Organization
Show Source
-
address1(optional):
string
the address1 of the address
-
address2(optional):
string
the address2 of the address
-
address3(optional):
string
the address3 of the address
-
city(optional):
string
the city of the address
-
companyName(optional):
string
the company name of the address
-
country(optional):
string
the country of the address
-
externalAddressId(optional):
string
External ID of the address
-
phoneNumber(optional):
string
the phone Number of the address
-
postalCode(optional):
string
the postal Code of the address
-
repositoryId(optional):
string
Repository Id of the address
-
state(optional):
string
the state of the address
Nested Schema : shippingMethods
Type:
array
Shipping methods associated for organization. This property will be removed from the webhook payload only if includeChangesOnly property is set to true for a specific webhook.
Show Source
Nested Schema : siteOrganizationProperties
Type:
array
The site organization properties of the account
Show Source
Nested Schema : items
Type:
Show Source
object
-
_actionCode(optional):
string
This property will be added to webhook payload only if includeChangesOnly property is set to true for the specific webhook. Supported values include CREATE, UPDATE and DELETE. This indicates that the corresponding entity is either created or updated or deleted.
-
active(optional):
boolean
Whether the account is active
-
id(optional):
string
The id of the account
-
name(optional):
string
The name of the account
-
repositoryId(optional):
string
The repository id of the account
Nested Schema : catalog
Type:
object
The catalog information
Show Source
-
repositoryId(optional):
string
The catalog id
Nested Schema : priceListGroup
Type:
object
The price list group information
Show Source
-
repositoryId(optional):
string
The priceListGroup id
Nested Schema : catalog
Type:
object
Catalog associated with contract
Show Source
-
repositoryId(optional):
string
Repository Id of the catalog
Nested Schema : priceListGroup
Type:
object
Price ListGroup associated with contract
Show Source
-
repositoryId(optional):
string
Repository Id of the price list group
Nested Schema : terms
Type:
object
Terms and Conditions
Show Source
-
repositoryId(optional):
string
Repository Id of terms and conditions
-
terms(optional):
string
Terms and Conditions
Nested Schema : items
Type:
Show Source
object
-
_actionCode(optional):
string
This property will be added to webhook payload only if includeChangesOnly property is set to true for the specific webhook. Supported values include CREATE, UPDATE and DELETE. This indicates that the corresponding entity is either created or updated or deleted.
-
customerContactId(optional):
string
External customer contact Id
-
repositoryId(optional):
string
Repository Id of contact
Nested Schema : items
Type:
Show Source
object
-
_actionCode(optional):
string
This property will be added to webhook payload only if includeChangesOnly property is set to true for the specific webhook. Supported values include CREATE, UPDATE and DELETE. This indicates that the corresponding entity is either created or updated or deleted.
-
function(optional):
string
The function of the account
-
repositoryId(optional):
string
The repository id of the account
Nested Schema : items
Type:
Show Source
object
-
address(optional):
object address
Address created for the Organization.
-
addressType(optional):
string
Address type represents nick name of account if present else repository ID of address item.
Nested Schema : address
Type:
object
Address created for the Organization.
Show Source
-
_actionCode(optional):
string
This property will be added to webhook payload only if includeChangesOnly property is set to true for the specific webhook. Supported values include CREATE, UPDATE and DELETE. This indicates that the corresponding entity is either created or updated or deleted.
-
address1(optional):
string
the address1 of the address
-
address2(optional):
string
the address2 of the address
-
address3(optional):
string
the address3 of the address
-
city(optional):
string
the city of the address
-
companyName(optional):
string
the company name of the address
-
country(optional):
string
the country of the address
-
externalAddressId(optional):
string
External ID of the address
-
phoneNumber(optional):
string
the phone Number of the address
-
postalCode(optional):
string
the postal Code of the address
-
repositoryId(optional):
string
Repository Id of the address
-
state(optional):
string
the state of the address
-
types(optional):
array types
Types of address. Like SHIPPING, BILLING
Nested Schema : items
Type:
Show Source
object
-
_actionCode(optional):
string
This property will be added to webhook payload only if includeChangesOnly property is set to true for the specific webhook. Supported values include CREATE, UPDATE and DELETE. This indicates that the corresponding entity is either created or updated or deleted.
-
displayName(optional):
string
The name of type of address
-
id(optional):
string
The id of type of address
-
repositoryId(optional):
string
The repository id of type of address
Nested Schema : items
Type:
Show Source
object
-
customerContactId(optional):
string
External customer contact Id
-
repositoryId(optional):
string
Repository Id of contact
Nested Schema : items
Type:
Show Source
object
-
displayName(optional):
string
The name of the shippingMethod
-
id(optional):
string
The Id of the shipping method.
Nested Schema : items
Type:
Show Source
object
-
properties(optional):
object properties
The properties of the site
-
site(optional):
object site
The site property of the account
Nested Schema : properties
Type:
object
The properties of the site
Show Source
-
_actionCode(optional):
string
This property will be added to webhook payload only if includeChangesOnly property is set to true for the specific webhook. Supported values include CREATE, UPDATE and DELETE. This indicates that the corresponding entity is either created or updated or deleted.
-
approvalRequired(optional):
boolean
Whether approval is required
-
contract(optional):
object contract
The contract information associated with this account
-
delegateApprovalManagement(optional):
boolean
Whether to delegate approval management
-
orderPriceLimit(optional):
string
Order price limit of the account
-
paymentMethods(optional):
array paymentMethods
Payment methods associated for organization.
-
shippingMethods(optional):
array shippingMethods
Shipping methods associated for organization.
-
useAllPaymentMethodsFromSite(optional):
boolean
Flag to use all the payment methods available for site.
-
useAllShippingMethodsFromSite(optional):
string
Flag to use all the shipping methods available for site.
-
useExternalApprovalWebhook(optional):
boolean
Whether to trigger order approval webhook
Nested Schema : site
Type:
object
The site property of the account
Show Source
-
siteId(optional):
string
Id of the site
Nested Schema : contract
Type:
object
The contract information associated with this account
Show Source
-
catalog(optional):
object catalog
The catalog information
-
creationDate(optional):
string
The date of creation
-
derivedDescription(optional):
string
Derived description of the Organization
-
description(optional):
string
The description of contract
-
displayName(optional):
string
The name of contract
-
endDate(optional):
string
The end date of contract
-
externalContractReference(optional):
string
The external contract reference of contract
-
priceListGroup(optional):
object priceListGroup
The price list group information
-
repositoryId(optional):
string
The repository Id of contract
-
startDate(optional):
string
The start date of the contract
-
terms(optional):
object terms
Terms and Conditions
Nested Schema : shippingMethods
Type:
array
Shipping methods associated for organization.
Show Source
Nested Schema : catalog
Type:
object
The catalog information
Show Source
-
repositoryId(optional):
string
The catalog id
Nested Schema : priceListGroup
Type:
object
The price list group information
Show Source
-
repositoryId(optional):
string
The priceListGroup id
Nested Schema : items
Type:
Show Source
object
-
_actionCode(optional):
string
This property will be added to webhook payload only if includeChangesOnly property is set to true for the specific webhook. Supported values include CREATE, UPDATE and DELETE. This indicates that the corresponding entity is either created or updated or deleted.
-
displayName(optional):
string
The name of the shippingMethod
-
id(optional):
string
The Id of the shipping method.
Response
Supported Media Types
- application/json
200 Response
No response is returned as this is an event webhook