Create BlogPost

Create a new BlogPost record.

POST /api/content/blogposts

Create BlogPost

cURL

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
}
'

import requests

url = "https://spaces.nexudus.com/api/content/blogposts"

payload = {
    "BusinessId": 123,
    "Title": "<string>",
    "CommentsCount": 123
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({BusinessId: 123, Title: '<string>', CommentsCount: 123})
};

fetch('https://spaces.nexudus.com/api/content/blogposts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

200

{
  "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

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
}'

const response = await fetch(
  'https://spaces.nexudus.com/api/content/blogposts',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      BusinessId: 0,
      Title: '',
      CommentsCount: 0
    })
  }
);

const data = await response.json();

import requests

response = requests.post(
    'https://spaces.nexudus.com/api/content/blogposts',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'BusinessId': 0,
        'Title': '',
        'CommentsCount': 0
    }
)

data = response.json()

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": "[e-mail]",
  "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.

Show child attributes

AttemptedValue · any

The value that was submitted for the field, or null if missing.

Message · string

The validation error message.

PropertyName · string

The name of the property that failed validation.

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
}