Don't have a Story Chief account yet 😲? Start your 7 day free trial now.

🔔 Note: StoryChief supports SharePoint Online not SharePoint On-premise

In order to connect SharePoint Online your site admin will first have to grant the StoryChief App access to your Site.

1. Grant StoryChief access to your SharePoint Site

ℹ️ The following steps are technical and should be setup by your SharePoint admin

Step 1. Get your site ID.

Finding the ID to your site is easy. Simply navigate to the SharePoint site home and add /_api/site/id to the URL.
Example:

https://<tenant>.sharepoint.com/sites/<site-url>/_api/site/id

Step 2. Grant read and write permission to the StoryChief App.

Make the following request using an access token with the scope Sites.FullControl.All

See Microsoft docs

curl --location 'https://graph.microsoft.com/v1.0/sites/<site-id>/permissions/' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <access-token> \
  --data '{
      "roles": ["Read,Write"],
      "grantedToIdentities": [
        {
            "application": {
                "id": "dd46fc13-33e3-4118-a36f-bdc4234b67a8",
                "displayName": "storyChief App"
         }
      }
   ]
}

Adding your Site as a channel inside StoryChief

ℹ️ The following steps should be handled by the StoryChief user

The hard part is over, Simply navigate to StoryChief, add a Sharepoint site and save your Site ID inside the provided input field before pressing save as explained in the next steps.

Step 3: From the dropdown menu click on Channels, followed by SharePoint Online

Step 4: Click on Add new destination to begin the setup.

Step 5: Click on Authorise Application to allow your Story Chief account to post to SharePoint Online

Step 6. Back in your Story Chief account, past the site ID from Step 1 and click on Save

Limitations

Multi-channel publishing is disabled for SharePoint Online. Considering this is an Intranet channel, you wouldn’t accidentally want to share it to a social media platform for example. This means that if SharePoint Online is the primary channel you won’t be able to publish it to other CMS systems, nor be able to share it to social media.
Tracking metrics is disabled for SharePoint Online.
The author is always Sharepoint app.
The author is not visible in the header of published page.
Images will be linked from StoryChief CDN.
Media alignment is not supported.

Quirks

Most embeds are shown as a card preview similar to StoryChief's card previews, except for Twitter and YouTube embeds those will be shown as regular embeds.
Media captions do not support any formatting (link/bold/etc).
Links do not support the no-follow option.
Card previews do not support captions.
Categories and tags are not a SharePoint Online default concept and are therefor not being pushed through.