Last updated Jul 16, 2025

Calendar event

The Calendar event object type represents a calendar event object. atlassian:calendar-event should be used to ingest calendar event-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:calendar-event
  ├─ eventStartTime (string) [Required]
  ├─ eventEndTime (string) [Required]
  ├─ attendees (List<Attendee>) [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]
  ├─ location (Location) [Optional]
      ├─ name (string) [Optional]
      ├─ address (string) [Optional]
      ├─ url (string) [Optional]
      └─ coordinates (string) [Optional]
  ├─ videoMeetingUrl (string) [Optional]
  ├─ recordingUrl (string) [Optional]
  ├─ isAllDayEvent (boolean) [Optional]
  ├─ attendeeCount (integer) [Optional]
  ├─ exceedsMaxAttendees (boolean) [Optional]
  ├─ videoMeetingProvider (string) [Optional]
  ├─ isRecurringEvent (boolean) [Optional]
  ├─ recurringEventId (string) [Optional]
  ├─ eventType (string) [Required]
  └─ attachments [] [Optional]
      ├─ name (string) [Required]
      ├─ url (string) [Required]
      └─ mimeType (string) [Optional]


Common properties

PropertyTypeRequiredDescription
schemaVersion

string

YesThe schema version of the object.
id

string

YesThe ID of the object in the source system.
updateSequenceNumberlongYesA 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.
displayNamestringYesThe display name of the object.
descriptionstringNoThe description of the object.
urlstringYesThe URL from the provider which the object is accessible from.
createdAtstringYes

The date the object was created.

Format: Instant (ISO8601 / RFC3339)

createdByuserNo

The user that created the object.

See User to learn more.

lastUpdatedAtstringYes

The date the object was last updated.

Format: Instant (ISO8601 / RFC3339)

lastUpdatedByuserNo

The user that last updated the object.

See User to learn more.

ownerslist<User>NoList of users that own the object.
thumbnailthumbnailNo

The thumbnail of the object.

See Thumbnail to learn more.

parentKeyentityKeyNo

The ID of the parent object. If null, it is a standalone object.

See Entity key to learn more.

containerKeyentityKeyNo

The container identifier that this object belongs to.

See Entity key to learn more.

permissionslist<Permissions>Yes

The permissions configuration of the object.

See Permissions to learn more.

associationsassociationNo

List of objects associated with the object. Generally used to link an external object to a Atlassian object.

See Association to learn more.

Calendar event properties

PropertyTypeRequiredDescription
eventStartTime

string

Yes

The start time of the calendar event.

Format: Instant (ISO8601 / RFC3339)

eventEndTime

string

Yes

The end time of the calendar event.

Format: Instant (ISO8601 / RFC3339)

eventTypestringYes

The type of the calendar event.

attendeesList<Attendee>No

List of attendees for the calendar event.

attendees.accountIdstringNo

The account ID of the attendee.

attendees.emailstringNo

The email address of the attendee.

attendees.externalIdstringNo

The external ID of the attendee.

attendees.aristringNo

The Atlassian Resource Identifier (ARI) of the attendee.

attendees.namestringNo

The name of the attendee.

attendees.userNamestringNo

The username of the attendee.

attendees.avatarstringNo

The avatar URL of the attendee.

attendees.urlstringNo

The URL of the attendee.

locationLocationNo

The location object for the calendar event.

location.namestringNo

The name of the location.

location.addressstringNo

The address of the location.

location.urlstringNo

The URL of the location.

location.coordinatesstringNo

The coordinates of the location.

videoMeetingUrlstringNo

The URL for the video meeting associated with the calendar event.

recordingUrlstringNo

The URL for the recording of the calendar event.

isAllDayEventbooleanNo

Indicates whether this is an all-day event.

attendeeCountintegerNo

The total number of attendees for the calendar event.

exceedsMaxAttendeesbooleanNo

Indicates whether the event exceeds the maximum number of attendees.

videoMeetingProviderstringNo

The provider of the video meeting service.

isRecurringEventbooleanNo

Indicates whether this is a recurring event.

recurringEventIdstringNo

The ID of the recurring event series.

attachmentslist<Attachment>No

List of attachments for the calendar event.

attachments.namestringYes

The name of the attachment.

attachments.urlstringYes

The URL of the attachment.

attachments.mimeTypestringNo

The MIME type of the attachment.

Example payload

1
2
{
  "objects" : [ {
    "id" : "calendar-event-1",
    "updateSequenceNumber" : 1,
    "description" : "Team meeting",
    "url" : "https://calendar.example.com/event/1",
    "displayName" : "Event Name",
    "createdAt" : "2024-04-16T09:31:32+00:00",
    "createdBy" : {
      "externalId" : "external-id-1"
    },
    "lastUpdatedAt" : "2024-04-16T09:31:32+00:00",
    "lastUpdatedBy" : {
      "externalId" : "external-id-1"
    },
    "permissions" : [ {
      "action" : "read",
      "accessControls" : [ {
        "principals" : [ {
          "type" : "EVERYONE"
        } ]
      } ]
    } ],
    "atlassian:calendar-event" : {
      "eventStartTime" : "2024-04-16T09:31:32+00:00",
      "eventEndTime" : "2024-04-16T09:31:32+00:00",
      "attendees" : [ {
        "user" : {
          "externalId" : "external-id-1"
        },
        "isOptional" : false,
        "rsvpStatus" : "accepted"
      }, {
        "user" : {
          "externalId" : "external-id-2"
        },
        "isOptional" : true,
        "rsvpStatus" : "tentatively_accepted"
      } ],
      "location" : {
        "name" : "location name",
        "address" : "location address",
        "url" : "https://calendar.example.com/location-url",
        "coordinates" : "coordinates"
      },
      "videoMeetingUrl" : "https://calendar.example.com/video-meeting-url",
      "recordingUrl" : "https://calendar.example.com/video-recording-url",
      "isAllDayEvent" : false,
      "attendeeCount" : 2,
      "exceedsMaxAttendees" : false,
      "videoMeetingProvider" : "other",
      "isRecurringEvent" : false,
      "recurringEventId" : "recurringEventId",
      "eventType" : "out_of_office",
      "attachments" : [ {
        "url" : "https://calendar.example.com/files/attachment1.png",
        "mimeType" : "image/png",
        "byteSize" : 140288
      } ]
    }
  } ],
  "operationType" : "NORMAL"
}

Rate this page: