---
title: Create a service account and its API key
description: How to create a service account and how it works.
---

[Skip to content](https://content.xmco.fr/en/base-de-connaissances/service-account-and-api-key#main-content)

- [English](https://content.xmco.fr/en/base-de-connaissances/service-account-and-api-key)
- [Français](https://content.xmco.fr/fr/base-de-connaissances/compte-de-service-et-cle-api)

English

Show submenu for translations

![](https://content.xmco.fr/hubfs/xmco.svg)

- [View your tickets](https://content.xmco.fr/tickets-view)
- [Log out](https://content.xmco.fr/_hcms/mem/logout)

Open main navigation

Close main navigation

- [View your tickets](https://content.xmco.fr/tickets-view)
- [Log out](https://content.xmco.fr/_hcms/mem/logout)
- - [English](https://content.xmco.fr/en/base-de-connaissances/service-account-and-api-key)
    - [Français](https://content.xmco.fr/fr/base-de-connaissances/compte-de-service-et-cle-api)

  English
  
  Show submenu for translations
- [Contact support](https://content.xmco.fr/en/support)

[Contact support](https://content.xmco.fr/en/support?hsLang=en)

 How can we help you?

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

1. [Base de connaissances](https://content.xmco.fr/en/base-de-connaissances?hsLang=en)
2. [Set up your account and company](https://content.xmco.fr/en/base-de-connaissances/set-up-your-account-and-company?hsLang=en)
3. [Manage your company](https://content.xmco.fr/en/base-de-connaissances/set-up-your-account-and-company?hsLang=en#manage-your-company)

# Create a service account and its API key

## In this article, you will learn how to create a service account and how it works.

 

**SUMMARY**

- [What is a service account ?](https://content.xmco.fr/fr/base-de-connaissances/new-create-a-service-account-and-its-api-key?hsLang=en#What-is-a-service-account-?)
- [How to create a service account ?](https://content.xmco.fr/fr/base-de-connaissances/new-create-a-service-account-and-its-api-key?hsLang=en#How-to-create-a-service-account-?)
- [How to generate an API key for a service account ?](https://content.xmco.fr/fr/base-de-connaissances/new-create-a-service-account-and-its-api-key?hsLang=en#How-to-generate-an-API-key-for-a-service-account-?)

### What is a service account ?

A service account is an **account with limited access**.

Unlike a classic account, a service account will not have access to XMCO applications, but will still be able to use the API and receive e-mail notifications. 

This is particularly interesting if you have third-party task automation accounts, or global mailing lists.

### How to create a service account ?

Pre-requisite : you need an account with the **Manager** profile

**Step 1 :** go to the user list

1\. Go to **Users** list from the configuration wheel next to your user initials.

![](https://content.xmco.fr/hs-fs/hubfs/Knowledge%20Base%20Import/Ba0_FE44jdgbb2br5H3ZgK-gtn24fTBFEw.png?width=3456&height=508&name=Ba0_FE44jdgbb2br5H3ZgK-gtn24fTBFEw.png)

2\. Click on the **“+”** symbol in the top right-hand corner. A pop-up window opens.

![](https://content.xmco.fr/hs-fs/hubfs/Knowledge%20Base%20Import/2_1PMhqa6o7W27UZuyFyAmj5kVMSF7DMxA.png?width=3456&height=508&name=2_1PMhqa6o7W27UZuyFyAmj5kVMSF7DMxA.png)

**Step 2 :** Fill in the details of the user

In the pop-up window, enter the following information:

- First name
- Last name
- Cell phone number
- User language
- Email address

![](https://content.xmco.fr/hs-fs/hubfs/Knowledge%20Base%20Import/Ol_sVamQ7MJo4GqVHKkkKxjU0_XOnFrwiA.png?width=1828&height=1016&name=Ol_sVamQ7MJo4GqVHKkkKxjU0_XOnFrwiA.png)

**Step 3 :** Activate the **Service account** option

Tick the following checkbox: **This is a service or limited user account**

![](https://content.xmco.fr/hs-fs/hubfs/Knowledge%20Base%20Import/3vsx7nbFrgibceg93b_ycpJKW5cld8BIvQ.png?width=1828&height=1016&name=3vsx7nbFrgibceg93b_ycpJKW5cld8BIvQ.png)

**Step 4 :** Assign perimeters to the account

1. Enter the profile(s) assigned to the user (ex: regular user, manager)
2. Enter the subscription(s) assigned to the user (ex: Serenety, Yuno)
3. Enter the perimeter(s) assigned to the user for each subscription selected

![](https://content.xmco.fr/hs-fs/hubfs/Knowledge%20Base%20Import/mI7VPPwnPafrPS8ghYO6PlgZm_OZWMiWew.png?width=1828&height=1016&name=mI7VPPwnPafrPS8ghYO6PlgZm_OZWMiWew.png)

**Step 5 :** Confirm the creation of the account

Click on **Add** to confirm account creation.

  

> **Warning !**For security reasons, the “Service account” option is only available when the account is created and **cannot be changed later on** by the user.
> 
> If you need to convert a classic user account into a service account, please contact us.

### How to generate an API key for a service account ?

Pre-requisites :

- An account with the **Manager** profile
- A service account set up

**Step 1 :** go the User list with the **Manager** profile

1\. Go to the **Users** list from the configuration wheel next to your user initials.

![](https://content.xmco.fr/hs-fs/hubfs/Knowledge%20Base%20Import/-89BLeQyGliCqK4Wjzvn5AmWk9BhmWtkJw.png?width=3456&height=508&name=-89BLeQyGliCqK4Wjzvn5AmWk9BhmWtkJw.png)

2\. Search for the name of the previously created service account in the list. You can also use the search bar, or search only for service accounts in the field provided.  
![](https://content.xmco.fr/hs-fs/hubfs/Knowledge%20Base%20Import/tdwANst_GvhfcYvTx3EzHOQYzS13KuOPTg.png?width=3456&height=424&name=tdwANst_GvhfcYvTx3EzHOQYzS13KuOPTg.png)

**Step 2 :** Access service account details

Click on the name of the service account to access its parameters.

![](https://content.xmco.fr/hs-fs/hubfs/Knowledge%20Base%20Import/h2nD7CCYHXP6vG7UA7WbtjdKZjjVaX9tPA.png?width=3456&height=768&name=h2nD7CCYHXP6vG7UA7WbtjdKZjjVaX9tPA.png)

**Step 3 :** Access the Service Account **Security** menu

Click on the **Security** menu (left menu).

![](https://content.xmco.fr/hs-fs/hubfs/Knowledge%20Base%20Import/jnzXSmI0VbEjpyeB8kRk518Tk8Dxd9LGXQ.png?width=3456&height=722&name=jnzXSmI0VbEjpyeB8kRk518Tk8Dxd9LGXQ.png)

**Step 4 :** Generate an API key

Click on the **Generate API key** or **Reset this token** button.

![](https://content.xmco.fr/hs-fs/hubfs/Knowledge%20Base%20Import/QMg8O83a0gTYIFg0WLCYkHuHtIJDKCWoRg.png?width=3456&height=1084&name=QMg8O83a0gTYIFg0WLCYkHuHtIJDKCWoRg.png)

Your API key is now generated and available in the text field. An “*API key successfully created*” message should appear in the top right-hand corner.

![](https://content.xmco.fr/hs-fs/hubfs/Knowledge%20Base%20Import/58v26FpCg3B-Y0tZZkLo1Ac5_GpMAIquyw.png?width=3456&height=1084&name=58v26FpCg3B-Y0tZZkLo1Ac5_GpMAIquyw.png)

The button next to the generated key (![](https://content.xmco.fr/hs-fs/hubfs/Knowledge%20Base%20Import/ZoKTg5KE4wqTzSseByXQevvxxCG1gRir-Q.png?width=33&height=36&name=ZoKTg5KE4wqTzSseByXQevvxxCG1gRir-Q.png)) will let you easily copy it.

- [Set up your account and company](https://content.xmco.fr/en/base-de-connaissances/set-up-your-account-and-company?hsLang=en#main-content)

    - [Log in](https://content.xmco.fr/en/base-de-connaissances/set-up-your-account-and-company?hsLang=en#log-in)
    - [Integrate your SSO](https://content.xmco.fr/en/base-de-connaissances/set-up-your-account-and-company?hsLang=en#integrate-your-sso)
    - [Manage your account](https://content.xmco.fr/en/base-de-connaissances/set-up-your-account-and-company?hsLang=en#manage-your-account)
    - [Manage your company](https://content.xmco.fr/en/base-de-connaissances/set-up-your-account-and-company?hsLang=en#manage-your-company)
- [Discover the Serenety module](https://content.xmco.fr/en/base-de-connaissances/discover-the-serenety-module?hsLang=en#main-content)

    - [Documentation Serenety](https://content.xmco.fr/en/base-de-connaissances/discover-the-serenety-module?hsLang=en#documentation-serenety)
    - [Set up Serenety in just a few clicks](https://content.xmco.fr/en/base-de-connaissances/discover-the-serenety-module?hsLang=en#set-up-serenety-in-just-a-few-clicks)
    - [Serenety key features](https://content.xmco.fr/en/base-de-connaissances/discover-the-serenety-module?hsLang=en#serenety-key-features)
- [Discover Yuno](https://content.xmco.fr/en/base-de-connaissances/discover-yuno?hsLang=en#main-content)

    - [Set up Yuno in just a few clicks](https://content.xmco.fr/en/base-de-connaissances/discover-yuno?hsLang=en#set-up-yuno-in-just-a-few-clicks)
    - [Advanced settings](https://content.xmco.fr/en/base-de-connaissances/discover-yuno?hsLang=en#advanced-settings)
    - [Yuno's main pages](https://content.xmco.fr/en/base-de-connaissances/discover-yuno?hsLang=en#yunos-main-pages)
    - [FAQ](https://content.xmco.fr/en/base-de-connaissances/discover-yuno?hsLang=en#faq)
    - [Download the complete documentation](https://content.xmco.fr/en/base-de-connaissances/discover-yuno?hsLang=en#download-the-complete-documentation)
- [Use the API and connectors](https://content.xmco.fr/en/base-de-connaissances/use-the-api-and-connectors?hsLang=en#main-content)

    - [Understanding and using the Portal API](https://content.xmco.fr/en/base-de-connaissances/use-the-api-and-connectors?hsLang=en#understanding-and-using-the-portal-api)
    - [Connect to our Portal](https://content.xmco.fr/en/base-de-connaissances/use-the-api-and-connectors?hsLang=en#connect-to-our-portal)
- [Legal information](https://content.xmco.fr/en/base-de-connaissances/legal-information?hsLang=en)

[![](https://content.xmco.fr/hubfs/xmco.svg)](https://www.xmco.fr)

[mailto:support@xmco.fr](mailto:support@xmco.fr) <https://www.linkedin.com/company/xmco>

Copyright © 2026, XMCO