POST api/v2.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 'members_only') Can be one of - 'members_only', 'no_comments'. PublishImmediately: (Optional, Defaults to True) If False, the Blog will be Saved, but not Published.
CreateBlogRequestName | Description | 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
{ "Title": "sample string 1", "Body": "sample string 2", "CommunityKey": "7a42d43d-dbb5-4644-8e02-fde6f98f4d15", "ViewPermissions": "sample string 3", "CommentPermissions": "sample string 4", "PublishImmediately": true }
application/xml, text/xml
<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>7a42d43d-dbb5-4644-8e02-fde6f98f4d15</CommunityKey> <PublishImmediately>true</PublishImmediately> <Title>sample string 1</Title> <ViewPermissions>sample string 3</ViewPermissions> </CreateBlogRequest>
Response Information
Resource Description
The newly created Blog.
BlogName | Description | 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
{ "Author": { "LinkToProfile": "sample string 1", "PictureUrl": "sample string 2", "ContactKey": "7c402981-403a-4b44-ad14-7d3b8c8a8223", "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-07-01T03:41:49.5406436Z", "UpdatedByContactKey": "a9bd4b7b-4639-46ce-a588-9c2b67c7e9e6", "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-07-01T03:41:49.5406436Z" }, "BlogKey": "cbf93353-1110-415d-83f3-0348cc4175d8", "Community": null, "CreatedOn": "2025-07-01T03:41:49.5406436Z", "BlogText": "sample string 3", "IsPublished": true, "LinkToReadBlog": "sample string 5", "PublishedOn": "2025-07-01T03:41:49.5406436Z", "BlogTitle": "sample string 7", "UpdatedOn": "2025-07-01T03:41:49.5406436Z", "ViewPermission": "sample string 9", "CommentPermission": "sample string 10", "ViewCount": 11, "RatingCount": 12, "CommentCount": 13, "Comments": [ { "CommentKey": "cd5fd6df-89ed-42c2-b63e-cb4e5a6bb69b", "CommentBody": "sample string 2", "CommentAuthor": { "LinkToProfile": "sample string 1", "PictureUrl": "sample string 2", "ContactKey": "7c402981-403a-4b44-ad14-7d3b8c8a8223", "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-07-01T03:41:49.5406436Z", "UpdatedByContactKey": "a9bd4b7b-4639-46ce-a588-9c2b67c7e9e6", "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-07-01T03:41:49.5406436Z" }, "IsOfficial": true, "ItemKey": "2d49273b-fcba-4d64-9ba2-9ecba16b635a", "CreatedOn": "2025-07-01T03:41:49.5406436Z", "UpdatedOn": "2025-07-01T03:41:49.5406436Z" }, { "CommentKey": "cd5fd6df-89ed-42c2-b63e-cb4e5a6bb69b", "CommentBody": "sample string 2", "CommentAuthor": { "LinkToProfile": "sample string 1", "PictureUrl": "sample string 2", "ContactKey": "7c402981-403a-4b44-ad14-7d3b8c8a8223", "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-07-01T03:41:49.5406436Z", "UpdatedByContactKey": "a9bd4b7b-4639-46ce-a588-9c2b67c7e9e6", "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-07-01T03:41:49.5406436Z" }, "IsOfficial": true, "ItemKey": "2d49273b-fcba-4d64-9ba2-9ecba16b635a", "CreatedOn": "2025-07-01T03:41:49.5406436Z", "UpdatedOn": "2025-07-01T03:41:49.5406436Z" } ], "RelatedLinks": [ { "RelatedLinkKey": "4e14d135-b314-4fa6-9067-d17903e201e7", "ItemKey": "bd9dd0e6-6836-47ce-b87e-0c02f9510385", "Url": "sample string 3", "Contributor": { "LinkToProfile": "sample string 1", "PictureUrl": "sample string 2", "ContactKey": "7c402981-403a-4b44-ad14-7d3b8c8a8223", "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-07-01T03:41:49.5406436Z", "UpdatedByContactKey": "a9bd4b7b-4639-46ce-a588-9c2b67c7e9e6", "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-07-01T03:41:49.5406436Z" }, "CreatedOn": "2025-07-01T03:41:49.5406436Z" }, { "RelatedLinkKey": "4e14d135-b314-4fa6-9067-d17903e201e7", "ItemKey": "bd9dd0e6-6836-47ce-b87e-0c02f9510385", "Url": "sample string 3", "Contributor": { "LinkToProfile": "sample string 1", "PictureUrl": "sample string 2", "ContactKey": "7c402981-403a-4b44-ad14-7d3b8c8a8223", "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-07-01T03:41:49.5406436Z", "UpdatedByContactKey": "a9bd4b7b-4639-46ce-a588-9c2b67c7e9e6", "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-07-01T03:41:49.5406436Z" }, "CreatedOn": "2025-07-01T03:41:49.5406436Z" } ], "ContactsWhoRecommend": [ { "LinkToProfile": "sample string 1", "PictureUrl": "sample string 2", "ContactKey": "7c402981-403a-4b44-ad14-7d3b8c8a8223", "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-07-01T03:41:49.5406436Z", "UpdatedByContactKey": "a9bd4b7b-4639-46ce-a588-9c2b67c7e9e6", "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-07-01T03:41:49.5406436Z" }, { "LinkToProfile": "sample string 1", "PictureUrl": "sample string 2", "ContactKey": "7c402981-403a-4b44-ad14-7d3b8c8a8223", "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-07-01T03:41:49.5406436Z", "UpdatedByContactKey": "a9bd4b7b-4639-46ce-a588-9c2b67c7e9e6", "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-07-01T03:41:49.5406436Z" } ], "AuthenticatedUserRecommends": true, "AuthenticatedUserFavorite": true }
application/xml
Sample not available.
text/xml
Sample not available.