Last updated Jul 16, 2025

Customer organization

The Customer organization object type represents a customer organization object. atlassian:customer-org should be used to ingest customer organization-specific fields.

Payload structure

1
2
  objects {}
  ├─ schemaVersion (string) [Required]
  ├─ id (string) [Required]
  ├─ updateSequenceNumber (long) [Required]
  ├─ displayName (string) [Required]
  ├─ description (string) [Optional]
  ├─ url (string) [Required]
  ├─ createdAt (Instant (ISO8601 / RFC3339)) [Required]
  └─ createdBy [] [Optional]
      ├─ accountId (string)
      └─ ari (string)
  └─ lastUpdatedAt (Instant (ISO8601 / RFC3339)) [Required]
  └─ lastUpdatedBy [] [Required]
      ├─accountId (string)
      └─ ari
  └─ permissions 
      └─ accessControls
         └─ principals
            └─type
  └─ associations [] [Optional]
      ├─ associationType (string)
      └─ values []

  atlassian:customer-org
  ├─ contacts (List<UserReference>) [Optional]
      ├─ accountId (string) [Optional]
      ├─ email (string) [Optional]
      ├─ externalId (string) [Optional]
      ├─ ari (string) [Optional]
      ├─ name (string) [Optional]
      ├─ userName (string) [Optional]
      ├─ avatar (string) [Optional]
      └─ url (string) [Optional]
  ├─ customerOrgLastActivity (CustomerOrgLastActivity) [Optional]
      ├─ lastActivity (string) [Required]
      └─ event (string) [Required]
  ├─ customerOrgLifeTimeValue (CustomerOrgLifeTimeValue) [Optional]
      ├─ value (Double) [Required]
      └─ currencyCode (string) [Required]
  ├─ websiteUrl (string) [Optional]
  ├─ industry (string) [Optional]
  ├─ contributors (List<UserReference>) [Optional]
      ├─ accountId (string) [Optional]
      ├─ email (string) [Optional]
      ├─ externalId (string) [Optional]
      ├─ ari (string) [Optional]
      ├─ name (string) [Optional]
      ├─ userName (string) [Optional]
      ├─ avatar (string) [Optional]
      └─ url (string) [Optional]
  ├─ country (string) [Optional]
  └─ accountType (string) [Optional]

Common properties

Property	Type	Required	Description
`schemaVersion`	`string`	Yes	The schema version of the object.
`id`	`string`	Yes	The ID of the object in the source system.
`updateSequenceNumber`	`long`	Yes	A sequence number to compare when writing to the database. Objects are written following a last write wins strategy, therefore an object with a greater `UpdateSequenceNumber` is considered a more recently updated object.
`displayName`	`string`	Yes	The display name of the object.
`description`	`string`	No	The description of the object.
`url`	`string`	Yes	The URL from the provider which the object is accessible from.
`createdAt`	`string`	Yes	The date the object was created. Format: Instant (ISO8601 / RFC3339)
`createdBy`	`user`	No	The user that created the object. See User to learn more.
`lastUpdatedAt`	`string`	Yes	The date the object was last updated. Format: Instant (ISO8601 / RFC3339)
`lastUpdatedBy`	`user`	No	The user that last updated the object. See User to learn more.
`owners`	`list<User>`	No	List of users that own the object.
`thumbnail`	`thumbnail`	No	The thumbnail of the object. See Thumbnail to learn more.
`parentKey`	`entityKey`	No	The ID of the parent object. If null, it is a standalone object. See Entity key to learn more.
`containerKey`	`entityKey`	No	The container identifier that this object belongs to. See Entity key to learn more.
`permissions`	`list<Permissions>`	Yes	The permissions configuration of the object. See Permissions to learn more.
`associations`	`association`	No	List of objects associated with the object. Generally used to link an external object to a Atlassian object. See Association to learn more.

Customer organization properties

Property	Type	Required	Description
`contacts`	`List<UserReference>`	No	List of contact persons for the customer organization.
`customerOrgLastActivity`	`CustomerOrgLastActivity`	No	Information about the last activity for the customer organization.
`customerOrgLastActivity.lastActivity`	`string`	Yes	The timestamp of the last activity. Format: Instant (ISO8601 / RFC3339)
`customerOrgLastActivity.event`	`string`	Yes	The type of the last activity event.
`customerOrgLifeTimeValue`	`CustomerOrgLifeTimeValue`	No	The lifetime value information for the customer organization.
`customerOrgLifeTimeValue.value`	`double`	Yes	The monetary value of the customer lifetime value.
`customerOrgLifeTimeValue.currencyCode`	`string`	Yes	The currency code for the lifetime value (e.g., USD, EUR).
`websiteUrl`	`string`	No	The website URL of the customer organization.
`industry`	`string`	No	The industry sector of the customer organization. Max length: 255
`contributors`	`List<UserReference>`	No	List of contributors associated with the customer organization.
`country`	`string`	No	The country where the customer organization is located. Max length: 255
`accountType`	`string`	No	The type of account for the customer organization. Max length: 255

Example payload

1
2
{
  "objects" : [ {
    "id" : "customer-org-1",
    "updateSequenceNumber" : 1,
    "displayName" : "Customer Organization Name",
    "description" : "A description of the customer organization.",
    "url" : "https://customer-org.example.com",
    "createdAt" : "2024-04-16T09:31:32+00:00",
    "lastUpdated" : "2024-04-16T09:31:32+00:00",
    "lastUpdatedBy" : {
      "externalId" : "external-id-1"
    },
    "createdBy" : {
      "externalId" : "external-id-1"
    },
    "owners" : [ {
      "externalId" : "external-id-1"
    } ],
    "thumbnail" : {
      "url" : "http://example-app.com/thumbnail-url",
      "mimeType" : "image/png"
    },
    "permissions" : [ {
      "action" : "read",
      "accessControls" : [ {
        "principals" : [ {
          "type" : "EVERYONE"
        } ]
      } ]
    } ],
    "atlassian:customer-org" : {
      "contacts" : [ {
         "externalId" : "external-id-1"
      } ],
      "lastActivity" : {
        "lastActivityAt" : "2023-05-01T05:00:45Z",
        "event" : "delete"
      },
      "lifeTimeValue" : {
        "value" : 1000000.0,
        "currencyCode" : "USD"
      },
      "websiteUrl" : "https://customer-org.example.com",
      "industry" : "Technology",
      "contributors" : [ {
        "externalId": "123123456"
      } ],
      "country" : "USA",
      "accountType" : "Bronze"
    }
  } ],
  "operationType" : "NORMAL"
}