Skip to main content
POST
/
api
/
content
/
blogposts
Create BlogPost
curl --request POST \
  --url https://spaces.nexudus.com/api/content/blogposts \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "BusinessId": 123,
  "Title": "<string>",
  "CommentsCount": 123
}
'
{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}
A BlogPost represents an article published on the Members Portal. Articles can be used to share news, updates, or useful content with customers. Articles support scheduled publishing via PublishDate and automatic unpublishing via UnpublishDate. Setting a PublishDate in the past publishes the article immediately; setting a future date schedules it. Leaving UnpublishDate blank keeps the article published until it is manually unpublished or deleted. Each article has a SummaryText (short overview displayed at the top) and a FullText (the main body content). Articles can be organised into categories using the BlogCategory entity and can optionally allow customer comments. Visibility can be controlled with OnlyForMembers (customers with an active contract) and OnlyForContacts (customers without an active contract). Articles can also be featured on the Members Portal home page before login (ShowInHomeBanner) or after login (ShowInHomePage).

​
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 BlogPost-Create role.

​
Request Body

​
Required Fields

​
BusinessId
integer
required
ID of the business linked to this record.
​
Title
string
required
Article title.
​
CommentsCount
integer
required
Number of comments on this article.

​
Optional Fields

​
LanguageId
integer
ID of the language linked to this record.
​
PostedById
integer
ID of the posted by linked to this record.
​
SummaryText
string
Short overview displayed at the top of the article.
​
FullText
string
Main body content of the article.
​
NewImageUrl
string
URL of a new file to upload as the image.
​
ClearImageFile
boolean
Set to true to remove the current image file.
​
NewLargeImageUrl
string
URL of a new file to upload as the large image.
​
ClearLargeImageFile
boolean
Set to true to remove the current large image file.
​
PublishDate
string
Date and time when the article is published. Past dates publish immediately; future dates schedule publication.
​
ShowInHomeBanner
boolean
Feature this article on the Members Portal home page before users log in.
​
ShowInHomePage
boolean
Feature this article on the Members Portal home page after users log in.
​
UnpublishDate
string
Date and time when the article is automatically unpublished. Leave blank to keep published indefinitely.
​
AllowComments
boolean
Whether customers can post comments on this article.
​
BlogCategories
integer[]
List of blog categories linked to this record.
​
OnlyForContacts
boolean
Restrict visibility to contacts (customers without an active contract).
​
OnlyForMembers
boolean
Restrict visibility to members (customers with an active contract).

​
Code Examples

curl -X POST \
  "https://spaces.nexudus.com/api/content/blogposts" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "BusinessId": 0,
    "Title": "",
    "CommentsCount": 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 blogpost was created successfully.
​
Errors
array
null on success.
Example Response
{
  "Status": 200,
  "Message": "BlogPost 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": "Title: is a required field",
  "Value": null,
  "Errors": [
    {
      "AttemptedValue": null,
      "Message": "is a required field",
      "PropertyName": "Title"
    }
  ],
  "WasSuccessful": false
}