Create or update an SMS/fax/message log

POST /messageLog

Logs RingCentral SMS, MMS, fax, voicemail, or text records to the CRM. Messages can be written individually or grouped into a shared conversation activity, and previously processed RingCentral message IDs are de-duplicated. Fax and MMS payloads can include a RingCentral access token for attachment downloads; treat it as secret and do not persist it.

Operation ID: postMessageLog
Authorization: BEARER or API key

Request body

RingCentral message conversation, CRM contact association, and optional connector-specific logging fields.

Required: Yes

Content type: application/json

Schema: MessageLogRequest

{
  "contactId": "crm-contact-123",
  "contactName": "Jane Smith",
  "contactType": "Contact",
  "logInfo": {
    "conversationId": 555100,
    "conversationLogId": "555100-2026-06-24",
    "correspondents": [
      {
        "phoneNumber": "+14155550100",
        "name": "Jane Smith"
      }
    ],
    "messages": [
      {
        "id": 1724099032020,
        "type": "SMS",
        "direction": "Inbound",
        "subject": "Can we talk later today?",
        "from": {
          "phoneNumber": "+14155550100",
          "name": "Jane Smith"
        },
        "to": [
          {
            "phoneNumber": "+16505550199",
            "extensionNumber": "101"
          }
        ],
        "creationTime": "2026-06-24T03:15:00.000Z"
      }
    ]
  }
}

Responses

Status	Description	Body
200	Message-log creation result.	MessageLogResponse
400	Bad request, missing authentication, or connector error.	ErrorResponse, string
401	The user session is expired or revoked.	ErrorResponse, string