messageCreate Mutation

Description

Creates a new message associated with an order. Optionally includes file attachments. For non-Discogs orders, attachments are uploaded to cloud storage and email notifications are sent to the buyer. For Discogs orders, messages are sent through the Discogs API.

mutation messageCreate($orderRef: ID!, $message: String!, $files: [Upload]) {
  messageCreate(orderRef: $orderRef, message: $message, files: $files) {
    _id
    created
    sender {
      name
      alias
      email
      ref
    }
    subject
    message
    fromBuyer
    flagged
    content
    attachments {
      _id
      uri
      title
    }
    read
    orderId
    orderIncId
    uri
    via
  }
}

Variables

{
    "orderRef": "60c8a111f4bf653dfb2a1007",
    "message": "message",
    "files": [
        "File"
    ]
}

Response

{
    "messageCreate": {
        "_id": "2db619a2f8484040b5cb5946",
        "created": 1732780043241,
        "sender": {
            "name": "example",
            "alias": "example",
            "email": "email@example.com",
            "ref": "44a4e7478c767de568eb6e9b"
        },
        "subject": "example",
        "message": "example",
        "fromBuyer": true,
        "flagged": true,
        "content": "example",
        "attachments": [
            {
                "_id": "cf84211a66236a5661ea2110",
                "uri": "https://www.my-common-ground-store.com/release/1763553751/release-artist-release-name",
                "title": "example"
            }
        ],
        "read": true,
        "orderId": "example",
        "orderIncId": 42,
        "uri": "https://www.my-common-ground-store.com/release/1763553751/release-artist-release-name",
        "via": "example"
    }
}

Arguments

Name	Type	Description
orderRef	ID!	Reference ID of the order to associate the message with.
message	String!	Message content text.
files	[Upload]	Optional list of files to attach to the message. Files are uploaded to cloud storage and included in email notifications.

Returns

Message!