organizationUpdate Mutation

Updates an existing organization.

Input argument

organizationUpdate accepts a single input argument, an input type, which contains the values it uses.

The fields inside input are:

addressesToDelete ([ID!])

Identifiers of addresses to remove from the organization.

businessUnit (Boolean)

Whether the organization needs to be treated as a separate entity from a reporting perspective. This checkbox is only available for internal organizations.

businessUnitOrganizationId (ID)

Refers to itself if the organization is a business unit, or refers to the business unit that the organization belongs to.

clientMutationId (String)

A unique identifier for the client performing the mutation.

contactsToDelete ([ID!])

Identifiers of contacts to remove from the organization.

customFields ([CustomFieldInput!])

Values for custom field to be used by the UI Extension that is linked to the record.

disabled (Boolean)

Whether the organization may no longer be related to other records.

financialID (String)

The unique identifier by which the organization is known in the financial system.

id (ID!)

The node ID of the record to update.

managerId (ID)

The manager of the organization.

name (String)

The full name of the organization.

newAddresses ([AddressInput!])

New or updated addresses of the organization.

newContacts ([ContactInput!])

New or updated contacts of the organization.

parentId (ID)

The organization's parent organization.

pictureUri (String)

The hyperlink to the image file for the record.

region (String)

Which region the organization belongs to. It is possible to select a previously entered region name or to enter a new one. This field is only available when the organization is a business unit (i.e. when the Business unit box is checked). Although not visible, the Region field of a business unit's child organizations is automatically set to the same value as the Region field of the business unit. Examples of commonly used region names are:

  • Asia Pacific (APAC)
  • Europe, Middle East & Africa (EMEA)
  • North America (NA)
remarks (String)

Any additional information about the organization that might prove useful.

source (String)

An identifier for the client application submitting the resource or the name of an external system

sourceID (String)

The unique identifier of the resource in an external system

substituteId (ID)

The person who acts as the substitute of the organization's manager.

timeAllocationIds ([ID!])

Time allocations of the organization.

uiExtensionId (ID)

UI extension that is to be applied to the record.

Return fields

clientMutationId (String)

A unique identifier for the client performing the mutation.

errors ([ValidationError!])

Errors encountered during the mutation.

organization (Organization)

Record after mutation.