Skip to main content
POST
/
data_import
/
messages
Import Messages
curl --request POST \
  --url https://{appId}.api-{region}.cometchat.io/v3/data_import/messages \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '{}'
{
  "data": {
    "3117": {
      "success": true,
      "data": {
        "id": "1029",
        "muid": "3117",
        "conversationId": "r123_user_s12",
        "sender": "s12",
        "receiverType": "user",
        "receiver": "r123",
        "category": "message",
        "type": "text",
        "data": {
          "text": "Hi there,",
          "attachments": [
            {
              "name": "hi.png",
              "extension": "png",
              "size": "350.2",
              "mimeType": "image/png",
              "url": "https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-1.webp"
            }
          ],
          "metad2ata": {
            "key": "value"
          },
          "custodata": {
            "key": "value"
          },
          "entities": {
            "sender": {
              "entity": {
                "uid": "s12",
                "name": "user1",
                "avatar": "https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-1.webp",
                "metadata": {
                  "key": "value"
                },
                "status": "offline",
                "role": "default",
                "createdAt": 1674228536,
                "updatedAt": 1674232131
              },
              "entityType": "user"
            },
            "receiver": {
              "entity": {
                "uid": "r123",
                "name": "cometchat-uid-",
                "avatar": "https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-1.webp",
                "metadata": {
                  "key": "value"
                },
                "status": "offline",
                "role": "default",
                "createdAt": 1674228536,
                "updatedAt": 1674232131,
                "conversationId": "r123_user_s12"
              },
              "entityType": "user"
            }
          }
        },
        "sentAt": 1674104348,
        "deliveredAt": 1674224684,
        "readAt": 1674224684,
        "updatedAt": 1674104348,
        "tags": [
          "tag1"
        ]
      }
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://www.cometchat.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

For the complete error reference, see Error Guide.

Authorizations

​
apikey
string
header
required

API Key with fullAccess scope(i.e. Rest API Key from the Dashboard).

Body

application/json
​
messages
object

Wrapper for the messages.

Example:
{
  "3118": {
    "muid": "3118",
    "sender": "s12",
    "receiverType": "user",
    "receiver": "r123",
    "type": "text",
    "category": "message",
    "data": {
      "text": "Hi there,",
      "attachments": [
        {
          "name": "hi.png",
          "extension": "png",
          "size": "350.2",
          "mimeType": "image/png",
          "url": "https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-1.webp"
        }
      ],
      "metadata": { "key": "value" },
      "custodata": { "key": "value" }
    },
    "sentAt": "1674104348",
    "deliveredAt": "1674224684",
    "readAt": "1674224684",
    "senderUserDetails": {
      "uid": "s12",
      "name": "user1",
      "avatar": "https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-1.webp",
      "createdAt": "1674228536",
      "metadata": { "key": "value" }
    },
    "receiverUserDetails": {
      "uid": "r123",
      "name": "cometchat-uid-",
      "type": "public",
      "description": "Hello group",
      "icon": "https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-1.webp",
      "owner": "cometchat-uid-1",
      "avatar": "https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-1.webp",
      "createdAt": "1674228536",
      "metadata": { "key": "value" }
    },
    "tags": ["tag1"]
  }
}

Response

200 - application/json

Import Message(s)

​
data
object