Skip to main content
POST
/
api
/
community
/
communitymessages
{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}
A CommunityMessage is an individual reply posted within a CommunityThread conversation on the Discussion Board. Admins and customers with a customer account can add messages to any conversation to help others or share information. Admins can delete any message; customers can only delete their own.

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the CommunityMessage-Create role.

Request Body

Required Fields

CommunityThreadId
integer
required
ID of the conversation this message belongs to.
UserId
integer
required
ID of the user account that posted this message.

Optional Fields

CoworkerId
integer
ID of the customer profile that posted this message.
Message
string
Body text of the message.

Code Examples

curl -X POST \
  "https://spaces.nexudus.com/api/community/communitymessages" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "CommunityThreadId": 0,
    "UserId": 0
}'

Response

200

Status
integer
HTTP status code. 200 on success.
Message
string
A human-readable message confirming the creation.
Value
object
Contains the Id of the newly created record.
WasSuccessful
boolean
true if the communitymessage was created successfully.
Errors
array
null on success.
Example Response
{
  "Status": 200,
  "Message": "CommunityMessage was successfully created.",
  "Value": {
    "Id": 87654321
  },
  "OpenInDialog": false,
  "OpenInWindow": false,
  "RedirectURL": null,
  "JavaScript": null,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "UpdatedBy": "admin@example.com",
  "Errors": null,
  "WasSuccessful": true
}

400

Message
string
A summary of the validation error(s), in the format PropertyName: error message.
Value
any
null on validation failure.
Errors
object[]
Array of validation errors.
WasSuccessful
boolean
false when the request fails validation.
Example Response
{
  "Message": "Name: is a required field",
  "Value": null,
  "Errors": [
    {
      "AttemptedValue": null,
      "Message": "is a required field",
      "PropertyName": "Name"
    }
  ],
  "WasSuccessful": false
}