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 (userReference) [Optional]
      ├─ accountId (string) [Optional]
      ├─ email (string) [Optional]
      └─ externalId (string) [Required]
  └─ lastUpdatedAt (Instant (ISO8601 / RFC3339)) [Required]
  └─ lastUpdatedBy (userReference) [Optional]
      ├─ accountId (string) [Optional]
      ├─ email (string) [Optional]
      └─ externalId (string) [Required]
  └─ permissions [] [Required]
      └─ accessControls
         └─ principals
            └─type
  └─ associations [] [Optional]
      ├─ associationType (string)
      └─ values []
      
  atlassian:deal
  ├─ contact (userReference) [Optional]
      ├─ accountId (string) [Optional]
      ├─ email (string) [Optional]
      └─ externalId (string) [Required]
  ├─ stage (string) [Optional]
  ├─ status (string) [Optional]
  ├─ accountName (string) [Optional]
  ├─ contributors (List<userReference>) [Optional]
      ├─ accountId (string) [Optional]
      ├─ email (string) [Optional]
      └─ externalId (string) [Required]
  ├─ lastActivity (DealLastActivity) [Optional]
      ├─ lastActivityAt (string) [Required]
      └─ event (string) [Required]
  ├─ dealClosedAt (string) [Optional]
  ├─ opportunityAmount (DealOpportunityAmount) [Optional]
      ├─ value (Double) [Required]
      └─ currencyCode (String) [Required]
  ├─ isClosed (boolean) [Optional]
  └─ entityExtendedValues (List<EntityExtendedValue>) [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`	`userReference`	No	A reference to the user that created the object. See userReference to learn more.
`lastUpdatedAt`	`string`	Yes	The date the object was last updated. Format: Instant (ISO8601 / RFC3339)
`lastUpdatedBy`	`userReference`	No	A reference to the user that last updated the object. See userReference to learn more.
`owners`	`list<userReference>`	No	List of references 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.
`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.

Deal properties

Property	Type	Required	Description
`contact`	`userReference`	No	A reference to the user who is the primary contact for the deal.
`stage`	`string`	No	The current stage of the deal.
`status`	`string`	No	The current status of the deal.
`accountName`	`string`	No	The name of the account associated with the deal.
`contributors`	`List<userReference>`	No	List of references to contributors associated with the deal.
`lastActivity`	`DealLastActivity`	No	Information about the last activity for the deal.
`lastActivity.lastActivityAt`	`string`	Yes	The timestamp of the last activity. Format: Instant (ISO8601 / RFC3339)
`lastActivity.event`	`string`	Yes	The type of the last activity event.
`dealClosedAt`	`string`	No	The timestamp when the deal was closed. Format: Instant (ISO8601 / RFC3339)
`opportunityAmount`	`DealOpportunityAmount`	No	The monetary opportunity amount for the deal.
`opportunityAmount.value`	`double`	Yes	The monetary value of the opportunity.
`opportunityAmount.currencyCode`	`string`	Yes	The currency code for the opportunity amount (e.g., USD, EUR).
`isClosed`	`boolean`	No	Indicates whether the deal is closed.
`entityExtendedValues`	`List<EntityExtendedValue>`	No	The entity extended values that might be indexed and leveraged in search and filtering.

Example payload

1
2
{
  "objects" : [ {
    "schemaVersion" : "2.0",
    "id" : "deal-1",
    "updateSequenceNumber" : 1,
    "description" : "Enterprise software deal",
    "url" : "https://deal.example.com/item/1",
    "displayName" : "Deal Name",
    "createdAt" : "2024-04-16T09:31:32+00:00",
    "createdBy" : {
      "email" : "user@example.com",
      "externalId" : "external-id-1"
    },
    "lastUpdatedAt" : "2024-04-16T09:31:32+00:00",
    "lastUpdatedBy" : {
      "email" : "user@example.com",
      "externalId" : "external-id-1"
    },
    "permissions" : [ {
      "accessControls" : [ {
        "principals" : [ {
          "type" : "EVERYONE"
        } ]
      } ]
    } ],
    "atlassian:deal" : {
      "contact" : {
        "email" : "contact@example.com",
        "externalId" : "external-contact-1"
      },
      "stage" : "In Progress",
      "status" : "In Progress",
      "accountName" : "Acme Corp",
      "lastActivity" : {
        "lastActivityAt" : "2024-04-16T09:31:32+00:00",
        "event" : "Deal Created"
      },
      "dealClosedAt" : "2024-04-16T09:31:32+00:00",
      "opportunityAmount" : {
        "value" : 1000.0,
        "currencyCode" : "USD"
      },
      "isClosed" : false,
      "contributors" : [ {
        "email" : "contributor@example.com",
        "externalId" : "external-contributor-1"
      } ]
    }
  } ]
}