POST api/v1.0/Blogs/CreateBlog

Create a new Blog.

Request Information

URI Parameters

None.

Body Parameters

Title: string, Body: string, CommunityKey: (Optional) To be supplied if the Blog should be associated with a specific Community., ViewPermissions: (Optional, Defaults to 'public') Can be one of - 'public', 'authenticated', 'members_only', 'my_contacts'., CommentPermissions: (Optional, Defaults to 'authenticated') Can be one of - 'authenticated', 'members_only', 'my_contacts', 'no_comments'., PublishImmediately: (Optional, Defaults to True) If False, the Blog will be Saved, but not Published.

CreateBlogRequest

Name	Type	Additional information
Title	string	None.
Body	string	None.
CommunityKey	globally unique identifier	None.
ViewPermissions	string	None.
CommentPermissions	string	None.
PublishImmediately	boolean	None.

Request Formats

application/json, text/json

Sample:

{
  "Title": "sample string 1",
  "Body": "sample string 2",
  "CommunityKey": "461fe83f-c9a9-492b-b8a6-057b1e3ff3c2",
  "ViewPermissions": "sample string 3",
  "CommentPermissions": "sample string 4",
  "PublishImmediately": true
}

application/xml, text/xml

Sample:

<CreateBlogRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise.Request">
  <Body>sample string 2</Body>
  <CommentPermissions>sample string 4</CommentPermissions>
  <CommunityKey>461fe83f-c9a9-492b-b8a6-057b1e3ff3c2</CommunityKey>
  <PublishImmediately>true</PublishImmediately>
  <Title>sample string 1</Title>
  <ViewPermissions>sample string 3</ViewPermissions>
</CreateBlogRequest>

Response Information

Resource Description

The newly created Blog.

Blog

Name	Type	Additional information
Author	ContactConcise	None.
BlogKey	globally unique identifier	None.
Community	Community	None.
CreatedOn	date	None.
BlogText	string	None.
IsPublished	boolean	None.
LinkToReadBlog	string	None.
PublishedOn	date	None.
BlogTitle	string	None.
UpdatedOn	date	None.
ViewPermission	string	None.
CommentPermission	string	None.
ViewCount	integer	None.
RatingCount	integer	None.
CommentCount	integer	None.
Comments	Collection of Comment	None.
RelatedLinks	Collection of RelatedLink	None.
ContactsWhoRecommend	Collection of ContactConcise	None.
AuthenticatedUserRecommends	boolean	None.
AuthenticatedUserFavorite	boolean	None.

Response Formats

application/json, text/json

Sample:

{
  "Author": {
    "LinkToProfile": "sample string 1",
    "PictureUrl": "sample string 2",
    "ContactKey": "c255b156-2e11-4c49-ba74-9310e3eb00b7",
    "FirstName": "sample string 4",
    "LastName": "sample string 5",
    "DisplayName": "sample string 6",
    "EmailAddress": "sample string 7",
    "ContactStatusCode": "sample string 8",
    "PrefixCode": "sample string 9",
    "UpdatedOn": "2025-10-29T07:12:59.2538517Z",
    "UpdatedByContactKey": "d74bf846-9efd-4f6b-aa6f-211c9650dd2b",
    "CompanyName": "sample string 12",
    "CompanyTitle": "sample string 13",
    "SuffixCode": "sample string 14",
    "Designation": "sample string 15",
    "LegacyContactKey": "sample string 16",
    "InformalName": "sample string 17",
    "MiddleName": "sample string 18",
    "IsCompany": true,
    "CompanyLegacyContactKey": "sample string 20",
    "AMSDirectoryOptOut": true,
    "HLDirectoryOptOut": true,
    "HLContactMeOptOut": true,
    "LargePictureUrl": "sample string 24",
    "AgreedToTermsDateTime": "2025-10-29T07:12:59.2538517Z"
  },
  "BlogKey": "8ce126fc-1554-4489-8481-080259eb9a9e",
  "Community": null,
  "CreatedOn": "2025-10-29T07:12:59.2538517Z",
  "BlogText": "sample string 3",
  "IsPublished": true,
  "LinkToReadBlog": "sample string 5",
  "PublishedOn": "2025-10-29T07:12:59.2538517Z",
  "BlogTitle": "sample string 7",
  "UpdatedOn": "2025-10-29T07:12:59.2538517Z",
  "ViewPermission": "sample string 9",
  "CommentPermission": "sample string 10",
  "ViewCount": 11,
  "RatingCount": 12,
  "CommentCount": 13,
  "Comments": [
    {
      "CommentKey": "59379dd8-f204-4ba9-bb6d-908684a0411a",
      "CommentBody": "sample string 2",
      "CommentAuthor": {
        "LinkToProfile": "sample string 1",
        "PictureUrl": "sample string 2",
        "ContactKey": "c255b156-2e11-4c49-ba74-9310e3eb00b7",
        "FirstName": "sample string 4",
        "LastName": "sample string 5",
        "DisplayName": "sample string 6",
        "EmailAddress": "sample string 7",
        "ContactStatusCode": "sample string 8",
        "PrefixCode": "sample string 9",
        "UpdatedOn": "2025-10-29T07:12:59.2538517Z",
        "UpdatedByContactKey": "d74bf846-9efd-4f6b-aa6f-211c9650dd2b",
        "CompanyName": "sample string 12",
        "CompanyTitle": "sample string 13",
        "SuffixCode": "sample string 14",
        "Designation": "sample string 15",
        "LegacyContactKey": "sample string 16",
        "InformalName": "sample string 17",
        "MiddleName": "sample string 18",
        "IsCompany": true,
        "CompanyLegacyContactKey": "sample string 20",
        "AMSDirectoryOptOut": true,
        "HLDirectoryOptOut": true,
        "HLContactMeOptOut": true,
        "LargePictureUrl": "sample string 24",
        "AgreedToTermsDateTime": "2025-10-29T07:12:59.2538517Z"
      },
      "IsOfficial": true,
      "ItemKey": "c84f04cf-1243-4c7e-887f-7c792ae40024",
      "CreatedOn": "2025-10-29T07:12:59.2538517Z",
      "UpdatedOn": "2025-10-29T07:12:59.2538517Z"
    },
    {
      "CommentKey": "59379dd8-f204-4ba9-bb6d-908684a0411a",
      "CommentBody": "sample string 2",
      "CommentAuthor": {
        "LinkToProfile": "sample string 1",
        "PictureUrl": "sample string 2",
        "ContactKey": "c255b156-2e11-4c49-ba74-9310e3eb00b7",
        "FirstName": "sample string 4",
        "LastName": "sample string 5",
        "DisplayName": "sample string 6",
        "EmailAddress": "sample string 7",
        "ContactStatusCode": "sample string 8",
        "PrefixCode": "sample string 9",
        "UpdatedOn": "2025-10-29T07:12:59.2538517Z",
        "UpdatedByContactKey": "d74bf846-9efd-4f6b-aa6f-211c9650dd2b",
        "CompanyName": "sample string 12",
        "CompanyTitle": "sample string 13",
        "SuffixCode": "sample string 14",
        "Designation": "sample string 15",
        "LegacyContactKey": "sample string 16",
        "InformalName": "sample string 17",
        "MiddleName": "sample string 18",
        "IsCompany": true,
        "CompanyLegacyContactKey": "sample string 20",
        "AMSDirectoryOptOut": true,
        "HLDirectoryOptOut": true,
        "HLContactMeOptOut": true,
        "LargePictureUrl": "sample string 24",
        "AgreedToTermsDateTime": "2025-10-29T07:12:59.2538517Z"
      },
      "IsOfficial": true,
      "ItemKey": "c84f04cf-1243-4c7e-887f-7c792ae40024",
      "CreatedOn": "2025-10-29T07:12:59.2538517Z",
      "UpdatedOn": "2025-10-29T07:12:59.2538517Z"
    }
  ],
  "RelatedLinks": [
    {
      "RelatedLinkKey": "7b300f74-6576-4fba-a86a-ade1c4be3837",
      "ItemKey": "a24f86d4-3ee6-43ee-b33b-dfa30db30abc",
      "Url": "sample string 3",
      "Contributor": {
        "LinkToProfile": "sample string 1",
        "PictureUrl": "sample string 2",
        "ContactKey": "c255b156-2e11-4c49-ba74-9310e3eb00b7",
        "FirstName": "sample string 4",
        "LastName": "sample string 5",
        "DisplayName": "sample string 6",
        "EmailAddress": "sample string 7",
        "ContactStatusCode": "sample string 8",
        "PrefixCode": "sample string 9",
        "UpdatedOn": "2025-10-29T07:12:59.2538517Z",
        "UpdatedByContactKey": "d74bf846-9efd-4f6b-aa6f-211c9650dd2b",
        "CompanyName": "sample string 12",
        "CompanyTitle": "sample string 13",
        "SuffixCode": "sample string 14",
        "Designation": "sample string 15",
        "LegacyContactKey": "sample string 16",
        "InformalName": "sample string 17",
        "MiddleName": "sample string 18",
        "IsCompany": true,
        "CompanyLegacyContactKey": "sample string 20",
        "AMSDirectoryOptOut": true,
        "HLDirectoryOptOut": true,
        "HLContactMeOptOut": true,
        "LargePictureUrl": "sample string 24",
        "AgreedToTermsDateTime": "2025-10-29T07:12:59.2538517Z"
      },
      "CreatedOn": "2025-10-29T07:12:59.2538517Z"
    },
    {
      "RelatedLinkKey": "7b300f74-6576-4fba-a86a-ade1c4be3837",
      "ItemKey": "a24f86d4-3ee6-43ee-b33b-dfa30db30abc",
      "Url": "sample string 3",
      "Contributor": {
        "LinkToProfile": "sample string 1",
        "PictureUrl": "sample string 2",
        "ContactKey": "c255b156-2e11-4c49-ba74-9310e3eb00b7",
        "FirstName": "sample string 4",
        "LastName": "sample string 5",
        "DisplayName": "sample string 6",
        "EmailAddress": "sample string 7",
        "ContactStatusCode": "sample string 8",
        "PrefixCode": "sample string 9",
        "UpdatedOn": "2025-10-29T07:12:59.2538517Z",
        "UpdatedByContactKey": "d74bf846-9efd-4f6b-aa6f-211c9650dd2b",
        "CompanyName": "sample string 12",
        "CompanyTitle": "sample string 13",
        "SuffixCode": "sample string 14",
        "Designation": "sample string 15",
        "LegacyContactKey": "sample string 16",
        "InformalName": "sample string 17",
        "MiddleName": "sample string 18",
        "IsCompany": true,
        "CompanyLegacyContactKey": "sample string 20",
        "AMSDirectoryOptOut": true,
        "HLDirectoryOptOut": true,
        "HLContactMeOptOut": true,
        "LargePictureUrl": "sample string 24",
        "AgreedToTermsDateTime": "2025-10-29T07:12:59.2538517Z"
      },
      "CreatedOn": "2025-10-29T07:12:59.2538517Z"
    }
  ],
  "ContactsWhoRecommend": [
    {
      "LinkToProfile": "sample string 1",
      "PictureUrl": "sample string 2",
      "ContactKey": "c255b156-2e11-4c49-ba74-9310e3eb00b7",
      "FirstName": "sample string 4",
      "LastName": "sample string 5",
      "DisplayName": "sample string 6",
      "EmailAddress": "sample string 7",
      "ContactStatusCode": "sample string 8",
      "PrefixCode": "sample string 9",
      "UpdatedOn": "2025-10-29T07:12:59.2538517Z",
      "UpdatedByContactKey": "d74bf846-9efd-4f6b-aa6f-211c9650dd2b",
      "CompanyName": "sample string 12",
      "CompanyTitle": "sample string 13",
      "SuffixCode": "sample string 14",
      "Designation": "sample string 15",
      "LegacyContactKey": "sample string 16",
      "InformalName": "sample string 17",
      "MiddleName": "sample string 18",
      "IsCompany": true,
      "CompanyLegacyContactKey": "sample string 20",
      "AMSDirectoryOptOut": true,
      "HLDirectoryOptOut": true,
      "HLContactMeOptOut": true,
      "LargePictureUrl": "sample string 24",
      "AgreedToTermsDateTime": "2025-10-29T07:12:59.2538517Z"
    },
    {
      "LinkToProfile": "sample string 1",
      "PictureUrl": "sample string 2",
      "ContactKey": "c255b156-2e11-4c49-ba74-9310e3eb00b7",
      "FirstName": "sample string 4",
      "LastName": "sample string 5",
      "DisplayName": "sample string 6",
      "EmailAddress": "sample string 7",
      "ContactStatusCode": "sample string 8",
      "PrefixCode": "sample string 9",
      "UpdatedOn": "2025-10-29T07:12:59.2538517Z",
      "UpdatedByContactKey": "d74bf846-9efd-4f6b-aa6f-211c9650dd2b",
      "CompanyName": "sample string 12",
      "CompanyTitle": "sample string 13",
      "SuffixCode": "sample string 14",
      "Designation": "sample string 15",
      "LegacyContactKey": "sample string 16",
      "InformalName": "sample string 17",
      "MiddleName": "sample string 18",
      "IsCompany": true,
      "CompanyLegacyContactKey": "sample string 20",
      "AMSDirectoryOptOut": true,
      "HLDirectoryOptOut": true,
      "HLContactMeOptOut": true,
      "LargePictureUrl": "sample string 24",
      "AgreedToTermsDateTime": "2025-10-29T07:12:59.2538517Z"
    }
  ],
  "AuthenticatedUserRecommends": true,
  "AuthenticatedUserFavorite": true
}

application/xml

Sample:

Sample not available.

text/xml

Sample:

Sample not available.