The new Cosmic dashboard is here!
Test drive it now →

Building Team Workflows in Cosmic

Community Articles
Community Articles Building Team Workflows in Cosmic

Cosmic provides tools and resources to create your own unique content publishing workflow that satisfies your team's needs. In this tutorial I'll demonstrate setting up a simple workflow for an Editor and Contributor team that needs to manage content in a draft, review and publish process. We'll also use Webhooks to integrate with Slack to notify the Editor when content is drafted by the Contributor. Let's get started.


Note: While the example that I'm demonstrating is for a publication, editorial or marketing team, you can think of the editor / contributor relationship as the management / execution layer of any team. 


Start by Inviting Your Contributors

Navigate to the left hand nav bar within your Cosmic Bucket Dashboard, click Settings and then click Users. You can extend user permissions via email for collaboration within your Bucket. 



When inviting my contributors, Cosmic gives me granular control over what Object Types this new Contributor is allowed to draft. I choose Blogs for this example, meaning my new content contributor can only draft Objects within the Blogs Object Type. 


Now that I’ve sent a notification to the contributor, I will set up notifications in Slack so I can be notified when my contributor has set a blog post to draft.

 

Set up Webhooks to receive Slack Notifications 

When my contributor drafts content within the Cosmic Bucket Dashboard, I want to receive a notification so that I can check their work and either send it back to them for additional review or publish. Note: as the Admin, Developer or Editor roles you can always edit and overwrite contributor content changes at any time. 

To receive notifications I will need to have my developer set up Cosmic Webhooks. Webhooks are used to trigger a POST request to the endpoint of your choice when an event occurs in your Bucket. Options for the channel notifying your team are numerous, but a couple of quick examples would be via Slack or SendGrid. 


Connect your Cosmic Buckets to Slack: 


1. Install the Cosmic Slack app to your Slack account by clicking here.

2. Select which channel you would like to receive the notifications and click "Authorize".


3. After you install the Slack app, copy the webhook link provided.



4. Paste the webhook link into the Endpoint input field. Documentation and a list of available Webhook events can be found here

Now every time my contributor creates and saves a draft within my Bucket, I'll be notified through Slack to review the work and schedule publishing. When it comes time for edits (and peace of mind) Cosmic provides audit logs with time-stamped revision updates that track authors as well as Revision History, which allows you to revert back to previous versions. 


Conclusion

I've just created a simple content publishing workflow for my team. In just a few steps I've invited a contributor to my Bucket and set up an automated system for notifying our team of new content changes being drafted. This is one of many possible workflows you're able to create with Cosmic User Permissions and Webhooks.

If you have any comments or questions about building content workflows with Cosmic, reach out to us on Twitter and join the conversation on Slack.

You may also like


A primary benefit of managing content API-first is that your content is transformed into portable and scalable content objects, available via API endpoint to create workflows with the third-party applications that your team uses.
Add the power of Algolia search to your Bucket. This Extension enables you to sync your Cosmic Objects with Algolia, making your data searchable. Set up automatic syncing to automatically add / edit / remove content from Algolia. Follow the simple steps below to install and setup Algolia.
Build a documentation app in a afternoon leveraging the powered of Gatsby and Cosmic.
In this video tutorial, I show you how to use the Cosmic CLI to install and deploy a Cosmic GraphQL-powered App in 5 minutes.
Learn how I built the Twitter Search Extension to search and save Tweets to your Bucket.

Get started with Cosmic

Personal projects are free. Scale up as you grow.
Start building Talk to sales