POST Meetings

Post meeting data to the Relationship Intelligence system for enabled users. Meeting data must be uploaded in chronological order. Each request can include up to 100 meetings per enabled user and up to 5,000 meetings in total.

Params

nameParam typeData TypeExampleRequired
userIdBodyint101Required
meetingsBodyarraysee belowRequired

Meetings Object Params

nameParam typeData TypeExampleRequired
uniqueIDBodystringunique_messageID_03252024_01Required
startDateBodydate-time2024-03-25T15:50:49.390ZRequired
organizerBodyemail addresssee belowRequired
requiredAttendeesBodyattendee (array)see belowRequired (at least 1)
optionalAttendeesBodyattendee (array)see belowoptional

Email Address Object Params

nameParam typeData TypeExampleRequired
addressBodystringcontactA@externaldomain.comRequired
nameBodystringContact ARequired

Attendee Object Params

nameParam typeData TypeExampleRequired
isAcceptedBodybooleantrueRequired
addressBodystringcontactA@externaldomain.comRequired
nameBodystringContact ARequired

Request

POST {{host}}/api/rest/v4/ri/import/meetings
Content-Type: application/json
Authorization: {{auth}}
 
[
  {
    "userId": 101,
    "meetings": [
      {
        "uniqueId": "unique_meeting_string",
        "startDate": "2024-03-25T15:50:49.394Z",
        "organizer": {
          "address": "first.last@firmdomain.com",
          "name": "First Last"
        },
        "requiredAttendees": [
          {
            "isAccepted": true,
            "address": "contactA@externaldomain.com",
            "name": "Contact A"
          }
        ],
        "optionalAttendees": [
          {
            "isAccepted": true,
            "address": "contactB@externaldomain.com",
            "name": "Contact B"
          }
        ]
      }
    ]
  }
]

Responses

HTTP/1.1 200 OK
[
  {
    "userId": 101,
    "status": 1,
    "statusText": "Success",
    "operationStats": {
      "syncDate": "2024-03-25T15:50:49.387Z",
      "received": 1,
      "added": 1,
      "alreadyProcessed": 0,
      "skipped": 0
    },
    "warnings": []
  }
]