Workplace from Meta is being discontinued – seamlessly migrate to Zoho Connect today. Learn More

Skip to main content

The purpose of this API is to update an event in a Zoho Connect network.

Request URL:

https://connect.zoho.com/pulse/api/updateEvent

OAuth Scope:

zohopulse.events.UPDATE

Request Method:

POST

Threshold:

25 requests per user/minute.

Mandatory Header:Header name: Authorization
Header Value: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52

Parameters

NameDescriptionRequired
scopeIDNetwork in which the event to be updated is in. Can be taken from the network list API.Required
streamIdStream ID to be updated. Can be taken from the response to create event API. Required
titleEvent title. Maximum character limit is 250.Required
descEvent description. Maximum character limit is 1000.Optional
locationEvent location. Maximum character limit is 250.Optional
fields Upload files using upload Files API and then return the file IDs. The user can add up to 10 files to an event. Multiple file IDs should be separated by a comma.Optional
startYearStart year for the event. ex) 2019Required
startMonthStart month for the event. ex) 08Required
startDateStart date for the event. ex) 21Required
startHourStart time for the event in hours. Should be specified in the 24hr format ex) 20Required
startMinStart time for the event in minutes. ex) 18Required
endYearEnd year for the event. ex) 2019Required
endMonthEnd month for the event. ex) 08Required
endDateEnd date for the event. ex) 21Required
endHourEnd time for the event in hours. Should be specified in the 24hr time format ex) 20Required
endMinEnd minute for the event. ex) 18Required
allDaySet this as true if you want the event as an all-day event and false if you don't.Optional
intervalDayEvent reminder interval in days {0,1,2,7}Optional
intervalMinuteEvent reminder interval in minutes {5,15,30,60,120}Optional
intervalHourEvent reminder interval in hours  {0 - 23}Optional
invitedMembersMembers to be invited to the event. Separate multiple members by a comma.Optional
invitedGroupsGroups to be invited to the event. Separate multiple groups by a comma.Optional
deleteMemInviteesRemoved invitees. Multiple names should be separated by a comma.Optional
deleteGrpInviteesRemoved groups that are invited. Multiple groups should be separated by a comma.Optional

Sample URL

Copiedhttps://connect.zoho.com/pulse/api/updateEvent?scopeID=929000000015001&streamId=929000000855682&title=Event+Updated+fro+march&startYear=2018&startMonth=03&startDate=22&startHour=05&startMinute=30&endYear=2018&endMonth=3&endDate=23&endHour=13&endMinute=0

Sample Response

Copied{
  "updateEvent": {
    "stream": {
      "id": "929000000855682",
      "userDetails": {
        "zuid": "2060758",
        "id": "2060758",
        "name": "Patricia Boyle",
        "canFollow": "true"
      },
      "partition": {
        "id": "929000000295001",
        "name": "Engineering",
        "partitionUrl": "engineering",
        "url": "engineering",
        "isPrivate": "true",
        "status": "ACTIVE",
        "isAdmin": "true",
        "type": "GROUP",
        "typeOrd": "2",
        "isUserFollow": "false"
      },
      "allowFooter": "true",
      "isApproved": "true",
      "isSpam": "false",
      "reason": {
        "items": {
          "*^$@_PARTITION_*^$@": {
            "id": "929000000295001",
            "name": "Engineering",
            "partitionUrl": "engineering",
            "url": "engineering",
            "isPrivate": "true",
            "status": "ACTIVE",
            "isAdmin": "true",
            "type": "GROUP",
            "typeOrd": "2",
            "isUserFollow": "false"
          },
          "*^$@_USERNAME_*^$@_2060758": {
            "zuid": "2060758",
            "id": "2060758",
            "name": "Patricia Boyle",
            "canFollow": "true"
          }
        },
        "msg": "*^$@_USERNAME_*^$@_2060758 has created an event in *^$@_PARTITION_*^$@."
      },
      "type": "EVENT",
      "link": {
        "linkurl": "https://connect.zoho.com/portal/zillum/event/929000000855682?isNative=true",
        "title": "Event Updated fro march"
      },
      "event": {
        "title": "Event Updated fro march",
        "type": "EVENT",
        "streamId": "929000000855682",
        "participants": {
          "invitedGroups": [
            {
              "id": "929000000295001",
              "name": "Engineering",
              "partitionUrl": "engineering",
              "url": "engineering",
              "isPrivate": "true",
              "status": "ACTIVE",
              "isAdmin": "true",
              "type": "GROUP",
              "typeOrd": "2",
              "isUserFollow": "false"
            }
          ],
          "yesUsers": [],
          "maybeUsers": [],
          "noUsers": [],
          "pendingUsers": []
        },
        "eventInvitedCount": "1",
        "pvtEventMemberList": ",929000000295001,",
        "userDetails": {
          "zuid": "2060758",
          "id": "2060758",
          "name": "Patricia Boyle",
          "canFollow": "true"
        },
        "url": "https://connect.zoho.com/portal/zillum/stream/929000000855682929000000855682",
        "googleCalendarUrl": "https://www.google.com/calendar/render?action=TEMPLATE&text=Event+Updated+fro+march&dates=20180322T160000Z/20180323T000000Z&details=&location=&trp=false&sprop=&sprop=name:",
        "formattedStartTime": "05:00 AM",
        "fullformattedStartTime": "March 22, 2018 05:00 AM",
        "startTime": "1521734400539",
        "endTime": "1521849600539",
        "startDay": "5",
        "startDate": "22",
        "startMonth": "3",
        "startYear": "2018",
        "startMin": "0",
        "startHour": "5",
        "dateComFormatStr": "22-Mar-2018",
        "formattedEndTime": "01:00 PM",
        "fullformattedEndTime": "March 23, 2018 01:00 PM",
        "endDay": "6",
        "endDate": "23",
        "endMonth": "3",
        "endYear": "2018",
        "endMin": "0",
        "endHour": "13",
        "canAddReminder": "true",
        "canEdit": "true",
        "canDelete": "true",
        "canAddRepetition": "true"
      },
      "content": [],
      "time": "1521527809645",
      "streamModifiedTime": "1521527888539",
      "formatedTime": "07:36 PM",
      "lastActivityTime": "0",
      "viewCount": "1",
      "canHide": "true",
      "comments": [],
      "url": "https://connect.zoho.com/portal/zillum/stream/929000000855682",
      "streamMentionData": [
        {
          "zuid": "2060758",
          "id": "2060758",
          "name": "Patricia Boyle",
          "type": "C",
          "emailId": "patriciab@zillum.com",
          "role": "MEMBER"
        }
      ]
    }
  }
}

Show full

Show less