# Creating a New Taxonomy with the Content Management API ### About this export | Field | Value | | --- | --- | | **content_type** | lesson | | **platform** | contentstack-academy | | **source_url** | https://www.contentstack.com/academy/learning-paths/contentstack-developer-certification/taxonomy-foundations/creating-a-new-taxonomy-with-the-content-management-api | | **course_slug** | taxonomy-foundations | | **lesson_slug** | creating-a-new-taxonomy-with-the-content-management-api | | **learning_path_slug** | contentstack-developer-certification | | **markdown_file_url** | /academy/md/learning-paths/contentstack-developer-certification/taxonomy-foundations/creating-a-new-taxonomy-with-the-content-management-api.md | | **generated_at** | 2026-05-22T14:37:41.670Z | > Lesson in **[Taxonomy Foundations](https://www.contentstack.com/academy/learning-paths/contentstack-developer-certification/taxonomy-foundations)** within the **contentstack-developer-certification** learning path on Contentstack Academy. **Academy MD v3** — structured for retrieval; no quiz or assessment keys. #### Video details #### At a glance - **Title:** Taxonomy-cmapi-postman-create2 - **Duration:** 3m 28s - **Media link:** https://cdn.jwplayer.com/previews/Qnz6TgKb - **Publish date (unix):** 1716059980 #### Streaming renditions - application/vnd.apple.mpegurl - audio/mp4 · AAC Audio · 113438 kbps - video/mp4 · 180p · 180p · 140651 kbps - video/mp4 · 270p · 270p · 159411 kbps - video/mp4 · 360p · 360p · 180098 kbps - video/mp4 · 406p · 406p · 193046 kbps - video/mp4 · 540p · 540p · 233084 kbps - video/mp4 · 720p · 720p · 289436 kbps - video/mp4 · 1080p · 1080p · 429898 kbps #### Timed text tracks (delivery) - **thumbnails:** `https://cdn.jwplayer.com/strips/Qnz6TgKb-120.vtt` #### Video transcript Hi, in this video we're going to use the content management API to create a new taxonomy, and after that we're going to use the same API to add a term to this taxonomy. This is really a great way to add content to ContentStack using the content management API, especially if our original content for our taxonomy is in an external database, a spreadsheet, or possibly in another system. If we want to avoid manually typing in this content, we can use some scripts and an API to do it for us. Let's get started. First, I always like to take a look at the documentation page on taxonomy or any other API request. Just look at the parameters and see the sample request. Here for create a taxonomy, on the right side you can see that I need to pass in the usual authorization, and then after that in the body of the request, I'm going to pass in the UID, the name, and the description. Now because we're creating something in ContentStack, it is a POST request, and here's the endpoint that we're going to call. You can of course run this in your browser, but normally I prefer to run this in Postman. So let's go to Postman now and go to the update create a new taxonomy command. So here you can see we have the create a taxonomy command, and then in my headers I've already configured the API key and authorization token, and in the body we have the taxonomy information that we want to create. So I'm going to create a superhero universe taxonomy, where I'm going to specify if a superhero lives in the DC universe or the Marvel universe. So this is name a superhero universe and description is the comic superhero universe DC or Marvel. Let's go ahead and click send. And so this is the response, and it looks like it was created successfully. This is great. So the next thing I want to do is create a term. So I'm going to go over here to this POST request, create a term. Now one thing that you should always look at is the URL, and I have a taxonomy UID here in the URL that needs to be specified. Also if I go back and look at my documentation that you're going to see under the create a term, it's also mentioned that I need that URL parameter taxonomy UID. It's also going to explain here something very important, is that for our first term, because it's a top-level term, we're not going to have a parent UID, so we're going to pass in null. Okay, let's go back to Postman and see how we do this. Now in Postman, we want to go ahead and paste in our taxonomy UID. This is going to be superhero universe. And then under terms, I've got DC here, but instead of the parent ID superhero universe, I'm going to put here null, because we don't have one yet. Let's go ahead and hit send. And now we've got the DC created at the root level. I'm going to do exactly the same thing for Marvel. I'm going to order ID, I'm going to put 2. And that's it. So now let's go back into content stack and see that in our UI. So here under taxonomy, let's refresh that. Now we can see superhero universe is here with our description. And there's our DC term and our Marvel term. Thanks for watching the video. See you next time. #### Key takeaways - Connect **Creating a New Taxonomy with the Content Management API** back to your stack configuration before moving to the next module. - Capture one concrete artifact (screenshot, Postman call, or code snippet) that proves the step works in your environment. - Re-read the delivery versus management boundary for anything you changed in the entry model. ## Supplement for indexing ### Content summary Creating a New Taxonomy with the Content Management API. Creating a New Taxonomy with the Content Management API in Taxonomy Foundations (taxonomy-foundations). ### Retrieval tags - Creating - New - Taxonomy - with - the - Content - taxonomy-foundations - lesson 20 - Creating a New Taxonomy with the Content Management API - taxonomy-foundations lesson ### Indexing notes Index this lesson as a primary chunk tagged with lesson_id "20" and topics: [Creating, New, Taxonomy, with, the, Content]. Parent course slug: taxonomy-foundations. Use asset_references URLs as thumbnail hints in search results when present. Never surface LMS quiz content or assessment answers from this file. ### Asset references | Label | URL | | --- | --- | | Video thumbnail: Creating a New Taxonomy with the Content Management API | `https://cdn.jwplayer.com/v2/media/Qnz6TgKb/poster.jpg?width=720` | ### External links | Label | URL | | --- | --- | | Contentstack Academy home | `https://www.contentstack.com/academy/` | | Training instance setup | `https://www.contentstack.com/academy/training-instance` | | Academy playground (GitHub) | `https://github.com/contentstack/contentstack-academy-playground` | | Contentstack documentation | `https://www.contentstack.com/docs/` |