---
title: How can I create and assign position tags via API?
description: Über die API erstellen Sie Arbeitsbereichs-Etiketten und weisen diese Arbeitsbereichen zu. Hier finden Sie eine Schritt-für-Schritt-Anleitung.
---

[Skip to content](https://insights.shyftplan.com/en/how-can-i-create-and-assign-position-tags-via-api#main-content)

- [English](https://insights.shyftplan.com/en/how-can-i-create-and-assign-position-tags-via-api)
- [Deutsch](https://insights.shyftplan.com/wie-kann-ich-arbeitsbereichs-merkmale-via-api-anlegen-und-zuweisen)

English

Show submenu for translations

[Write an e-mail](https://insights.shyftplan.com/en/kb-tickets/new?hsLang=en)

[![Shyftplan\_logo\_RGB Kopie.png\]](https://insights.shyftplan.com/hs-fs/hubfs/Shyftplan_logo_RGB%20Kopie.png?height=40&name=Shyftplan_logo_RGB%20Kopie.png)](https://insights.shyftplan.com/migration/en?hsLang=en)

Open main navigation

Close main navigation

- - [English](https://insights.shyftplan.com/en/how-can-i-create-and-assign-position-tags-via-api)
    - [Deutsch](https://insights.shyftplan.com/wie-kann-ich-arbeitsbereichs-merkmale-via-api-anlegen-und-zuweisen)

  English
  
  Show submenu for translations
- [Write an e-mail](https://insights.shyftplan.com/en/kb-tickets/new)
- Contact Us

 Contact Us

 Welcome to the shyftplan help center

- There are no suggestions because the search field is empty.

1. [shyftplan Help Center](https://insights.shyftplan.com/en?hsLang=en)
2. [Integrations](https://insights.shyftplan.com/en/integrations?hsLang=en)

# How can I create and assign position tags via API?

### 1. Create a position tag

Go to `locations_positions_tags` in our [API documentation](https://shyftplan.com/api/v1/locations_positions_tags) and [select the **POST** command.](https://developer.shyftplan.com/reference/postapiv1locationspositionstags)  
Fill in the required fields in the input form and click the "Try it!" button on the right.

**Endpoint:**  
**POST** to:  
`https://shyftplan.com/api/v1/locations_positions_tags`

**Required fields (must be filled in):**

- `company_id` → Your company ID in shyftplanner
- `user_email` → Your email address (API user)
- `authentication_token` → Your API access token
- `name` → Name of the tag (e.g., “Prio 1”)

**Important:**

- Create each tag individually
- Note down the ID of each tag from the response (you’ll need it later)

 

### 2. Retrieve positions

Go to `locations_positions` and [select the **GET** command.](https://developer.shyftplan.com/reference/getapiv1locationspositions-1)  
Fill in the required fields and submit the request using the "Try It" button.  
You will now receive the IDs of all positions at each location — save these for later.

**Endpoint:**  
**GET** from:  
`https://shyftplan.com/api/v1/locations_positions`

**Important:**

- Note the IDs of the positions you want to assign tags to.

### 3. Add position tags to positions

Go back to `locations_positions` and [select the **PUT** command.](https://developer.shyftplan.com/reference/putapiv1locationspositionsid)  
Enter the ID of the position you want to update in the "id" field.  
Under `tag_ids`, enter the ID(s) of the desired tag(s) and send the request.

**Endpoint:**  
**PUT** to:  
`https://shyftplan.com/api/v1/locations_positions/{id}`

**Required fields:**

- `company_id`
- `user_email`
- `authentication_token`
- `tag_ids` → Add the tag ID(s) as a list

**Example:**

json

```
{  "tag_ids": [123, 456]}
```

 

**Note:**

- Always provide **all** desired tags — existing ones will be overwritten otherwise.

 

The position tags are now available in your shyftplanner account and can be used for prioritization when assigning shifts.

- [Integrations](https://insights.shyftplan.com/en/integrations?hsLang=en)
- [Direct contact](https://insights.shyftplan.com/en/direct-contact?hsLang=en#main-content)

    - [Not a customer yet?](https://insights.shyftplan.com/en/direct-contact?hsLang=en#not-a-customer-yet)
    - [Already a customer?](https://insights.shyftplan.com/en/direct-contact?hsLang=en#already-a-customer)

[![shyftplan Logo](https://insights.shyftplan.com/hs-fs/hubfs/Logos/01_shyftplan%20Logos/Shyftplan_logo_RGB-4.png?width=612&height=119&name=Shyftplan_logo_RGB-4.png "shyftplan Logo")](http://shyftplan.com)

shyftplan GmbH, Ritterstr. 26, 10969 Berlin

<https://linkedin.com/company/shyftplan/>

Copyright © 2026, shyftplan GmbH